How to Use the Indy MCP in Mastra AI

Q: How do I register Indy MCP tools within a Mastra AI agent?

You initialize the MCPClient with your Vinkius server URL, then call listTools to retrieve Indy's endpoints. Spread these tools directly into your agent configuration so it can use createform or listrecords inside its workflow steps.

Q: Does the Indy MCP Server support human-in-the-loop approval in Mastra AI?

Yes. You can configure Mastra's requireToolApproval setting on critical actions like deleteform or deletewebhook, forcing the system to wait for manual confirmation before erasing any data.

Q: How do I build a multi-step lead onboarding flow with Indy and Mastra AI?

You define a Mastra workflow where the first step runs createform to build a questionnaire, the second step registers a webhook via createwebhook, and subsequent steps use listrecords to monitor and parse incoming client data.

Q: How is my Indy account data secured when running Mastra AI workflows?

Your freelance profile details from getaccountinfo and team credentials from listusers are never exposed to public networks. All tool executions go through secure MCP sandboxes on Vinkius, ensuring your internal agency operations remain private.

Build self-healing freelance workflows that automate client onboarding and form routing using Mastra AI and the Indy MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Indy MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Onboarding Workflows with Mastra AI

The `create_form` and `create_webhook` tools form the foundation of your automated onboarding pipelines. With Mastra AI, you can build a multi-step workflow that spins up a new client intake form and instantly registers a webhook to listen for responses. If the webhook registration fails, Mastra's workflow engine triggers an automatic retry with exponential backoff. It's built to handle network hiccups, so you won't miss a lead, making your Indy MCP Server integration incredibly reliable.

Conditional Lead Routing and Record Checks

The `list_records` and `get_record` tools allow your agents to evaluate incoming lead data against custom business rules. You can set up conditional branches in Mastra AI to parse form submissions. If a submission indicates a high-budget project, the workflow automatically routes it to a priority queue. The agent uses `get_user` to match the submission with existing team members. If no match is found, it falls back to a general notifications step, ensuring no prospective client gets lost in the cracks.

Self-Healing Webhook Management

The `list_webhooks` and `delete_webhook` tools keep your active notification endpoints tidy and error-free. Mastra AI monitors your active endpoints and automatically prunes broken or redundant webhooks without human intervention. When an onboarding campaign ends, the Mastra agent triggers `delete_form` and cleans up the associated webhooks. This keeps your Indy workspace organized, preventing stale endpoints from cluttering your freelance dashboard.

Setup guide

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

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

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

You initialize the `MCPClient` with your Vinkius server URL, then call `listTools` to retrieve Indy's endpoints. Spread these tools directly into your agent configuration so it can use `create_form` or `list_records` inside its workflow steps.

Yes, Mastra's built-in workflow engine natively supports automatic retries. If `create_webhook` fails due to a network glitch, the workflow will retry the operation based on your defined backoff policy.

Yes. You can configure Mastra's `requireToolApproval` setting on critical actions like `delete_form` or `delete_webhook`, forcing the system to wait for manual confirmation before erasing any data.

You define a Mastra workflow where the first step runs `create_form` to build a questionnaire, the second step registers a webhook via `create_webhook`, and subsequent steps use `list_records` to monitor and parse incoming client data.

Your freelance profile details from `get_account_info` and team credentials from `list_users` are never exposed to public networks. All tool executions go through secure MCP sandboxes on Vinkius, ensuring your internal agency operations remain private.

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