How to Use the Agora MCP in Vercel AI SDK

Q: Can Vercel AI SDK stream Agora call metrics live?

Yes. When the agent calls listactivecalls, the JSON response streams back to your frontend chunk by chunk. Your React components update immediately.

Q: What happens if a recording fails to start?

The agent catches the error from startcloudrecording and streams a natural language explanation back to the user interface. You can set up UI fallbacks based on that response.

Build live interactive dashboards where Vercel AI SDK streams Agora project stats and active call data straight into your Next.js frontend.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Agora MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream project data into your UI

Your end users don't want to wait for loading spinners. When they ask your chatbot for their current minute consumption, you can grab that data via this MCP Server using `get_usage_stats` and stream the numbers directly into a React component as they arrive. Building admin panels gets much faster this way. You pass `list_projects` and `get_project_details` to your tool array, and the AI formats the raw infrastructure data into a clean, readable summary right on the screen.

Vercel AI SDK active session tracking

Live events require real-time visibility. Connecting this MCP Server lets your application pull live participant metrics without writing custom polling logic. A user types "who is on the whiteboard?" and your agent fires off `list_whiteboard_rooms` alongside `list_active_calls`. The response streams back instantly, giving moderators an up-to-the-second view of platform activity.

Trigger cloud recordings from chat

Handling the Agora recording lifecycle manually means writing a lot of boilerplate state management. Now your user can just click a button or type a command to capture a session. The agent handles the required sequence under the hood. It runs `acquire_cloud_recording` to get the resource ID, then immediately triggers `start_cloud_recording`. Later, the user can check progress via `query_cloud_recording` or halt it with `stop_cloud_recording`.

Setup guide

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

Pass the Vinkius endpoint token to your MCP client setup. Extract the tools with the tools method and feed them into your streaming text function.

Yes. When the agent calls `list_active_calls`, the JSON response streams back to your frontend chunk by chunk. Your React components update immediately.

No. Vinkius manages the remote MCP Server infrastructure. You just connect the client from your Next.js route handler and close it when finished.

The agent catches the error from `start_cloud_recording` and streams a natural language explanation back to the user interface. You can set up UI fallbacks based on that response.

Your API keys stay locked inside the V8 Isolate Sandbox. The ephemeral environment executes requests and destroys itself, ensuring call data and whiteboard room IDs never touch persistent storage.

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