How to Use the Yida MCP in Mastra AI

Q: How can Mastra AI read details from Yida forms?

You use the getrecorddetails tool. This pulls all the specific data points from a form instance, giving your agent everything it needs to run complex conditional logic or send follow-up notifications.

Q: What if I need to delete an old Yida record using Mastra AI?

You simply call deleterecord. Because this is running in a robust workflow environment, you can wrap the deletion in failure handling—if it fails, your process knows how to retry or notify an admin.

Q: Can I check available forms with Yida using Mastra AI?

Yes, run listforms. This tells your agent what options are available for the end-user. The MCP Server handles listing all current forms in the application scope.

Q: Does Yida support listing workflows with Mastra AI?

Yes, use listworkflows. This gives you a manifest of every workflow available in the system, allowing your agent to choose the correct automation path for a given task.

Build robust Yida workflows that handle failures 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 Yida MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Record Creation and Updates

Mastra AI can manage the lifecycle of form data. Use `create_record` when a new event happens, or call `update_record` if an existing record needs modifying based on workflow logic. If your initial creation fails, Mastra's built-in retry mechanisms kick in automatically. It’s perfect for multi-step processes where the data integrity is non-negotiable.

Validate Form Structure and Content

Before you write a single record, check the structure first. The `get_form_schema` tool lets your agent read the form's field definition. This validates that subsequent calls to `create_record` or `update_record` use correct data types. This capability means you build reliable workflows—the system knows exactly what kind of input it expects.

Review Workflow History and Users

Need to know why a record got stuck? Use `get_instance_timeline` to pull the full history. You can also list who was involved by calling `list_users` or listing available workflows via `list_workflows`. These tools let you build audit trails right into your complex, automated workflow chain.

Setup guide

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

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

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

You use the `get_record_details` tool. This pulls all the specific data points from a form instance, giving your agent everything it needs to run complex conditional logic or send follow-up notifications.

You simply call `delete_record`. Because this is running in a robust workflow environment, you can wrap the deletion in failure handling—if it fails, your process knows how to retry or notify an admin.

Yes, run `list_forms`. This tells your agent what options are available for the end-user. The MCP Server handles listing all current forms in the application scope.

This server touches form records and workflow instance data. Any time you call `create_record` or `update_record`, Mastra AI ensures that the data flow is handled securely within your defined multi-step process.

Yes, use `list_workflows`. This gives you a manifest of every workflow available in the system, allowing your agent to choose the correct automation path for a given task.

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