How to Use the Yida MCP in Vercel AI SDK

Q: How do I check record details with Yida and Vercel AI SDK?

Call getrecorddetails to pull the specific data you need. Because you're using the Vercel AI SDK, this data streams directly into your React component as soon as it's ready. No waiting for a big JSON blob.

Q: Can I list all forms in Yida with the Vercel AI SDK?

Yeah, just use the listforms tool. The results stream back fast enough that you can build a populated dropdown menu instantly without hitting any performance bottlenecks.

Q: If I update data in Yida using Vercel AI SDK, how do I know it worked?

After calling updaterecord, your agent should immediately call getrecorddetails again. Streaming the new details back proves the change happened and shows the user the updated record live.

Q: Does Yida support listing users with Vercel AI SDK?

Absolutely. The listusers tool lets you grab a roster of application users, which is useful if your front end needs to display who owns or last modified a record.

See Yida data appear in real-time with the Vercel AI SDK.

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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Fetch and Update Form Data Instantly

When you call `get_record_details`, your agent gets a snapshot of a specific form record. You can then use `update_record` to push changes back into Yida, all streaming live to the user's UI. This real-time feedback is huge. Instead of showing a 'Loading...' spinner for data retrieval or modification, the user sees the fields populate as your agent processes them using the MCP Server.

Manage Forms and Schemas Live

Need to know what fields are available? Call `get_form_schema` before processing a form. This tool gives you the exact structure, so your app doesn't guess. You can also run `list_forms` to display all available Yida forms in a selector. This prevents runtime errors and makes your client much more reliable. It's perfect for building user-facing applications where data input needs strict validation.

Track Workflow Progress History

The `get_instance_timeline` tool pulls the full history of a workflow instance. This means you can show users exactly what happened—who approved it, and when. It's more useful than just showing a 'Completed' status. You get granular steps: which action triggered the next one, giving your user clear visibility into complex business processes managed by Yida.

Setup guide

Set up Yida MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Yida tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Yida transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Call `get_record_details` to pull the specific data you need. Because you're using the Vercel AI SDK, this data streams directly into your React component as soon as it's ready. No waiting for a big JSON blob.

Yeah, just use the `list_forms` tool. The results stream back fast enough that you can build a populated dropdown menu instantly without hitting any performance bottlenecks.

After calling `update_record`, your agent should immediately call `get_record_details` again. Streaming the new details back proves the change happened and shows the user the updated record live.

Absolutely. The `list_users` tool lets you grab a roster of application users, which is useful if your front end needs to display who owns or last modified a record.

This server touches form records and workflow instance data. When handling these details with the Vercel AI SDK, always ensure your client sanitizes all input before calling `create_record` or `update_record`.

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