How to Use the Metaplane MCP in Vercel AI SDK

Q: Can I trigger monitor runs via Metaplane from AI-sdk?

Yes. You just call triggermonitorrun with the specific monitor ID. This kicks off a check immediately from your application interface.

Q: How do I see all configured alerts?

Use listconfiguredalerts to retrieve your current notification setup. This tool lists where your alerts are routed.

Stop guessing why your data pipeline failed. Use the Metaplane MCP server to stream live quality metrics directly into your AI-sdk UI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Metaplane MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time incident stream

Feed data issues straight to your frontend without the lag of manual polling. Your users see exactly what is broken when `list_incidents` triggers a notification. Stop waiting for dashboards to refresh. Use `get_incident` to pull specific error details into your component state as soon as they occur.

Monitor your data health

Check the status of your pipelines by calling `list_monitors` within your edge functions. You get a clear picture of what is running right now. See how your data evolves by using `get_monitor_runs` to inspect history. It's the fastest way to spot patterns before they hit your production database.

Manage connections on the fly

Expose your data architecture to your AI agent with `list_data_connections`. You'll know exactly which sources are active. Map out your schema dependencies using `list_connection_schemas`. This gives your AI-sdk app the context it needs to validate data types before you run any queries.

Setup guide

Set up Metaplane 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 Metaplane 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 Metaplane 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 Metaplane. 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 Metaplane 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 Metaplane MCP in Vercel AI SDK

Register the Metaplane server tools in your client configuration. Then, pass `list_incidents` to your streamText call to pull the latest errors into your UI.

Yes. You just call `trigger_monitor_run` with the specific monitor ID. This kicks off a check immediately from your application interface.

The server uses your provided API key to handle requests. It never stores your raw data, only the metadata required to show incident status.

The server returns an error code. You should handle this in your frontend logic to prevent UI hangs.

Use `list_configured_alerts` to retrieve your current notification setup. This tool lists where your alerts are routed.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.