How to Use the Uscreen MCP in Mastra AI

Q: Can I use Mastra AI for listing collections?

Yes. By calling listcollections, your workflow can pull all available groupings and then conditionally trigger other steps, like checking product availability via listproducts.

Q: What data type does Uscreen touch when using Mastra AI?

Mastra AI workflows primarily interact with transaction records, alongside customer details and subscription statuses. This allows for deep financial auditing.

Build complex workflows with Mastra AI and Uscreen data management.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Uscreen MCP to Mastra AI

Create your Vinkius account to connect Uscreen to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Uscreen with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Handling Subscription Failures via Mastra AI

Your agent needs to process a payment failure, right? Instead of failing hard, you can set up a workflow using `list_subscriptions` and `get_customer`. The system automatically retries the transaction with exponential backoff and notifies an admin if all else fails. This level of error handling is crucial for e-commerce. Mastra AI builds complex state machines that guarantee data integrity, regardless of how many steps or failures are involved.

Automating Uscreen Content Audits

Need to check if all your products are correctly listed? You can sequence calls: first `list_products`, then loop through each one calling `get_content` for details. Mastra AI handles this multi-step process, ensuring every asset is checked and the results are compiled into a single report. It's about reliable execution. The workflow engine manages conditional branching—if a product lacks content metadata, it flags that record immediately.

Listing Uscreen Customer Records with Mastra AI

You can build a robust reporting flow by calling `list_customers` and then running specific checks like `get_collection` against each user's profile. The workflow manages this dependency chain, providing structured data reports. Because it supports automatic retries, the process doesn't just fail if one API call times out; it keeps going until a defined success state is reached.

Setup guide

Set up Uscreen MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Uscreen tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "uscreen-mcp-client",
  servers: {
    "uscreen-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Uscreen Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Uscreen tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Uscreen transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Uscreen. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Uscreen now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Uscreen MCP in Mastra AI

Mastra AI treats the Uscreen MCP Server as a reliable source of truth. You can build workflows that depend on specific Uscreen data, like checking `list_transactions` before proceeding to update a user record.

Yes. By calling `list_collections`, your workflow can pull all available groupings and then conditionally trigger other steps, like checking product availability via `list_products`.

Mastra AI workflows primarily interact with `transaction` records, alongside `customer` details and `subscription` statuses. This allows for deep financial auditing.

It does. The built-in workflow engine handles conditional branches natively—for example, 'if subscription is active, then notify; otherwise, send warning.'

The framework guarantees reliability through automatic retries and exponential backoff. This means transient API issues won't derail your entire business process.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript