How to Use the Nango (Unified API & Integration Platform) MCP in Mastra AI

Q: How do I add Nango (Unified API & Integration Platform) to my Mastra AI agent?

You pass the server URL to the MCPClient constructor in your Mastra setup. Once registered, spread the tools into your agent’s tool array.

Q: Is Nango (Unified API & Integration Platform) compatible with Mastra AI tool approval?

It is. You can enable requireToolApproval for sensitive tools like connection management to ensure a human reviews the action.

Q: How do I inspect the environment for Nango?

Call getenvironment. It returns the current runtime mapping so your agent knows exactly which Nango instance it’s interacting with.

Build resilient integration workflows in Mastra AI. Manage OAuth and syncs with automated error handling.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nango (Unified API & Integration Platform) MCP to Mastra AI

Create your Vinkius account to connect Nango (Unified API & Integration Platform) 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 Nango (Unified API & Integration Platform) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage integrations in Mastra AI workflows

Use `list_integrations` to map out exactly what your agents have access to. It clears up the ambiguity of what’s available in your current environment. When a workflow requires specific parameters, `get_integration` pulls the exact config. It ensures your agents have the right scope before they attempt any data operations.

Automate sync diagnostics with Nango (Unified API & Integration Platform)

Build retry logic into your Mastra AI agents by monitoring `list_syncs`. If a status returns an error, your agent can trigger a fix or alert an admin. It removes the guesswork from maintenance. Your agents watch the health of your connections and act the second a sync fails.

Fetch records using Nango (Unified API & Integration Platform)

Use `list_records` to bring external data into your agent’s memory. It’s the fastest way to get raw provider data into a structured format for processing. Your workflows can branch based on the output. If a record is missing, the agent knows to fetch it or skip the step entirely.

Setup guide

Set up Nango (Unified API & Integration Platform) 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 Nango (Unified API & Integration Platform) 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: "nango-unified-api-integration-platform-mcp-client",
  servers: {
    "nango-unified-api-integration-platform-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Nango (Unified API & Integration Platform) 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 Nango. 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 Nango (Unified API & Integration Platform) 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 Nango (Unified API & Integration Platform) MCP in Mastra AI

You pass the server URL to the `MCPClient` constructor in your Mastra setup. Once registered, spread the tools into your agent’s tool array.

Yes. Since Mastra handles retries natively, you can wrap your tool calls in a workflow that checks for transient failures in the sync status.

It is. You can enable `requireToolApproval` for sensitive tools like connection management to ensure a human reviews the action.

Call `get_environment`. It returns the current runtime mapping so your agent knows exactly which Nango instance it’s interacting with.

The server never stores raw credentials. It uses your Nango connection IDs to perform actions, keeping your sensitive OAuth tokens isolated from your agent logic.

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