How to Use the Convai MCP in Vercel AI SDK

Q: Can Vercel AI SDK stream live audio responses using Convai?

Yes, by using connectlive or getresponse inside your edge routes. The SDK streams the dialogue tokens directly to your React components as they arrive from the server to keep your game loop fast.

Q: How does Vercel AI SDK handle Convai narrative triggers using this MCP Server?

The SDK maps createnarrativetrigger directly to tool calls during active chat sessions. When your agent detects a specific player action, it triggers the tool and updates the UI state instantly.

Q: How do I manage character knowledge bases?

Use uploadknowledgebank and updateknowledgebank inside your server actions. This lets your web app upload text files or game lore docs directly to the character's brain from a simple file input.

Build and deploy interactive game characters with live-streaming dialogue directly in your Vercel AI SDK frontend.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Convai MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Convai characters live in your Vercel AI SDK app

This MCP server lets your Next.js frontend call `create_character` and `generate_backstory` to build dynamic NPC profiles on the fly. You can feed the output of `list_voices` directly into a drop-down menu. Your users configure their game companions in real-time, while the edge functions handle the heavy lifting without blocking the main thread.

Stream live game dialogue directly to React

This server uses `get_response` and `connect_live` to stream low-latency conversational audio and text responses right into your web app. By bypassing slow middle-tier API wrappers, this MCP connection gives you direct access to Convai's narrative engine. When a player triggers a scene, your client updates the UI state immediately based on the incoming stream.

Edit game scripts on the fly using this MCP Server

This server lets you call `edit_narrative_section` and `toggle_narrative` to rewrite game plots dynamically based on player choices. You don't need to hardcode story arcs. Let your agent adjust the gameplay flow dynamically, using `create_narrative_trigger` to set up new player interactions as they walk through your virtual world.

Setup guide

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

Install @ai-sdk/mcp and call createMCPClient pointing to your Vinkius endpoint. Register the tools with streamText to let your agent build characters or pull dialogue, and remember to call mcpClient.close() when done.

Yes, by using connect_live or get_response inside your edge routes. The SDK streams the dialogue tokens directly to your React components as they arrive from the server to keep your game loop fast.

The SDK maps create_narrative_trigger directly to tool calls during active chat sessions. When your agent detects a specific player action, it triggers the tool and updates the UI state instantly.

Use upload_knowledge_bank and update_knowledge_bank inside your server actions. This lets your web app upload text files or game lore docs directly to the character's brain from a simple file input.

All character data, including backstories managed by generate_backstory and voice profiles from list_voices, runs through Vinkius's isolated V8 sandboxes. Your proprietary game lore never persists on Vinkius servers, and the endpoint token keeps your API keys secure.

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