How to Use the Ada MCP in Mastra AI

Q: How do I register the Ada tools inside my Mastra AI agent?

Install the package and initialize the client. Then call mcpClient.listTools() and spread those tools directly into your Mastra agent configuration to give it access to your support data.

Build resilient TypeScript workflows that update Ada articles and manage users with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ada MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automating support escalations with Mastra AI

When a customer gets stuck, your Mastra AI agent can instantly pull their profile. By calling `get_end_user`, the agent checks custom metavariables to decide if this user needs immediate human help. If the user is a high-priority customer, the workflow branches to notify your team. This MCP Server gives your agents the exact context needed to make smart routing decisions on the fly.

Self-healing knowledge base sync via Mastra AI

Keeping help documents fresh is painful. This MCP Server integration lets your agent call `list_articles` to find outdated support files and automatically replace them. If the network drops while running `create_article`, Mastra's built-in retry engine handles the failure. It backs off and tries again, ensuring your Ada knowledge base never ends up with half-written drafts.

Safe conversation monitoring with human approval

You don't want an autonomous agent messing with customer logs without supervision. Use the `requireToolApproval` setting in Mastra to pause the agent before it runs `list_conversations`. A human reviewer can check the requested support thread. Once approved, the agent processes the chat logs to find common issues and suggest improvements for your support team.

Setup guide

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

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

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

Install the package and initialize the client. Then call `mcpClient.listTools()` and spread those tools directly into your Mastra agent configuration to give it access to your support data.

Yes, Mastra's workflow engine has built-in exponential backoff. If `create_article` fails due to a rate limit, the agent waits and retries until the document is successfully saved.

Yes, you can configure Mastra to require manual approval before running sensitive tools. This is ideal when your agent wants to fetch user details using `get_end_user`.

You initialize the client using the secure Vinkius endpoint URL. The Mastra MCP client automatically detects the transport layer, letting your Mastra agent query support conversations over a secure SSE connection.

Your end-user metadata and support profiles are transmitted over encrypted channels. Vinkius processes these records inside zero-trust sandboxes, ensuring no customer data is cached or logged.

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