How to Use the Assembled MCP in Mastra AI

Q: How do I deploy Mastra AI with Assembled?

Install @mastra/mcp and instantiate the MCPClient with your Vinkius URL. Spread the results of mcpClient.listTools() directly into your Agent's tool array. You can then push the entire workflow to any cloud provider with one command.

Q: Does Mastra AI support human-in-the-loop for Assembled actions?

You can configure requireToolApproval for sensitive operations. The workflow pauses when it hits that specific tool and waits for external validation. This prevents autonomous agents from making unapproved scheduling changes.

Build fault-tolerant support workflows by connecting Mastra AI to your Assembled workforce data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Assembled MCP to Mastra AI

Create your Vinkius account to connect Assembled 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 Assembled with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Forecast Responses

The `list_forecasts` tool feeds predicted contact volumes directly into your Mastra AI workflow engine. You can build conditional branches that trigger specific actions if expected ticket loads spike above a certain threshold. This MCP Server acts as the trigger for your automated rules. Managing sudden surges requires automatic adjustments. If a forecast looks bad, your agent can call `list_queues` to check current backlog levels. Mastra handles the exponential backoff if the API stutters during these critical checks.

Sync Agent Schedules Reliably

Pulling shift coverage relies on the `list_schedules` tool. Workflows often break when fetching large datasets spanning multiple weeks. The framework catches those timeouts and automatically retries the fetch without crashing your entire pipeline. Verifying who is actually working happens via `list_agent_states`. When your workflow needs to assign an urgent escalation, it checks this live status first. Engineers get a resilient system that handles temporary network failures gracefully.

Map Assembled Teams in Mastra AI

Discovering your support structure starts with the `list_teams` tool. Your agent can iterate through different pods and apply specific logic to each group. Validating the initial connection is as simple as running `get_account_check` on the MCP Server at the start of your workflow. Finding specific personnel requires the `list_users` endpoint. If an escalation workflow needs human approval, Mastra can pause execution using `requireToolApproval` before pinging a specific user. The system waits for an admin to confirm the action before proceeding.

Setup guide

Set up Assembled 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 Assembled 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: "assembled-mcp-client",
  servers: {
    "assembled-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Assembled 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 Assembled. 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 Assembled 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 Assembled MCP in Mastra AI

Install `@mastra/mcp` and instantiate the `MCPClient` with your Vinkius URL. Spread the results of `mcpClient.listTools()` directly into your Agent's tool array. You can then push the entire workflow to any cloud provider with one command.

Built-in exponential backoff handles temporary failures automatically. If fetching the agent states times out, the framework waits and tries again based on your configured limits. Your workflow continues running without manual intervention.

You can configure `requireToolApproval` for sensitive operations. The workflow pauses when it hits that specific tool and waits for external validation. This prevents autonomous agents from making unapproved scheduling changes.

The workflow engine evaluates the output of the forecast tool against your defined conditions. High expected volume can trigger one branch of execution, while normal volume follows another. You define these paths in plain TypeScript.

Vinkius processes all requests in ephemeral, isolated sandboxes. Shift schedules and team rosters are never cached or logged permanently. Your single endpoint token authenticates the connection while the underlying infrastructure maintains zero-trust boundaries.

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