How to Use the Aporia MCP in Vercel AI SDK

Q: How do I connect the Vercel AI SDK to Aporia?

Install @ai-sdk/mcp and initialize createMCPClient with your HTTP transport URL. Call mcpClient.tools() to fetch the Aporia MCP server tools, and pass the result straight into streamText. Always remember to call mcpClient.close() when the stream finishes.

Q: How do I trigger an immediate Aporia monitor run with the Vercel AI SDK?

You invoke triggermonitor directly from your server-side action. Pass the specific monitor ID, and Aporia forces an evaluation immediately instead of waiting for the scheduled cron job.

Stream Aporia guardrail validations directly into your Next.js UI using the Vercel AI SDK. Stop toxic outputs before the user reads them.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aporia MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Inline Safety with Vercel AI SDK

`validate_guardrails` intercepts the LLM payload before it streams to the client interface. You pass an array of messages to the Aporia MCP server, and it checks for PII, toxicity, or off-topic drifts within milliseconds. If the check fails, the Vercel AI SDK halts the stream instantly. End users never see the bad output. You handle the rejection gracefully in your React or Svelte frontend without writing custom middleware. The entire validation loop happens at the edge, keeping your interface fast and your data clean.

Real-Time Model Telemetry

`get_metrics` pulls performance and drift data for your monitored models straight into your application logic. You read the exact latency, token usage, and safety violation rates while the user interacts with the system. Instead of waiting for a batch job to update a dashboard, your Next.js app queries the Aporia MCP server on demand. If drift spikes above your acceptable threshold, you swap the underlying model dynamically before the next user request hits.

Expose Aporia Dashboards

`list_dashboards` and `list_models` fetch your active workspace configurations directly into your internal admin tools. Your operations team sees exactly which ML models and LLMs are actively monitored without logging into a separate portal. Building custom internal tooling becomes trivial. You pipe the active monitor states into your Vercel-hosted admin panel, giving your support team immediate visibility into why a specific user session failed a safety check.

Setup guide

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

Install `@ai-sdk/mcp` and initialize `createMCPClient` with your HTTP transport URL. Call `mcpClient.tools()` to fetch the Aporia MCP server tools, and pass the result straight into `streamText`. Always remember to call `mcpClient.close()` when the stream finishes.

Yes. The system checks the message array against your configured rules before sending the first token. If it detects a Social Security Number or credit card, the stream aborts.

Guardrail checks take a few milliseconds. You run them alongside your standard generation logic. The user sees the text appearing normally unless a violation triggers a hard stop.

You invoke `trigger_monitor` directly from your server-side action. Pass the specific monitor ID, and Aporia forces an evaluation immediately instead of waiting for the scheduled cron job.

The server evaluates the raw message arrays and model drift telemetry purely in memory. Aporia inspects the text for toxicity and PII, returns a boolean flag, and drops the payload. Your user inputs remain isolated within the V8 Isolate Sandbox.

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