Retell AI MCP Server for Vercel AI SDKGive Vercel AI SDK instant access to 11 tools to Create Voice Agent, Get Agent Config, Get Call Details, and more
The Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect Retell AI through Vinkius and every tool is available as a typed function. ready for React Server Components, API routes, or any Node.js backend.
Ask AI about this App Connector for Vercel AI SDK
The Retell AI app connector for Vercel AI SDK is a standout in the Industry Titans category — giving your AI agent 11 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token. get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using Retell AI, list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Retell AI MCP Server
Connect your Retell AI account to any AI agent and take full control of your conversational voice orchestration through natural conversation. Retell AI provides a premier platform for building human-like voice agents, and this integration allows you to create agents, initiate phone or web calls, and monitor LLM configurations directly from your chat interface.
The Vercel AI SDK gives every Retell AI tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 11 tools through Vinkius and stream results progressively to React, Svelte, or Vue components. works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
What you can do
- Agent & Persona Orchestration — List all managed voice agents and retrieve detailed persona metadata, including creating new agents programmatically.
- Call Lifecycle Management — Initiate and monitor real-time phone or web calls and retrieve detailed call metadata including recordings and transcripts directly from the AI interface.
- LLM & Brain Control — Access and monitor your Retell LLM configurations to ensure your agents always have the correct logic and knowledge via natural language.
- Phone Number Intelligence — List available phone numbers to maintain a clear overview of your telephony infrastructure.
- Operational Monitoring — Track system responses and manage agent settings using simple AI commands to ensure your voice operations are always optimized.
The Retell AI MCP Server exposes 11 tools through the Vinkius. Connect it to Vercel AI SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 11 Retell AI tools available for Vercel AI SDK
When Vercel AI SDK connects to Retell AI through Vinkius, your AI agent gets direct access to every tool listed below — spanning voice-ai, conversational-ai, telephony, and more. Every call is secured with network, filesystem, subprocess, and code evaluation entitlements inside a sandboxed runtime. Beyond a simple connection, you get a full AI Gateway with real-time visibility into agent activity, enterprise governance, and optimized token usage.
Create a new AI voice agent
Get details for a voice agent
Get details and transcript for a call
Get metadata for a response engine
Get details for a specific phone number
List call logs and history
List internal response engines
List registered phone numbers
List all AI voice agents
Initiate an outbound phone call
Initialize a browser-based call
Connect Retell AI to Vercel AI SDK via MCP
Follow these steps to wire Retell AI into Vercel AI SDK. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.
Install dependencies
npm install @ai-sdk/mcp ai @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the script
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Vercel AI SDK with the Retell AI MCP Server
Vercel AI SDK provides unique advantages when paired with Retell AI through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime. same Retell AI integration everywhere
Built-in streaming UI primitives let you display Retell AI tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
Retell AI + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the Retell AI MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query Retell AI in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate Retell AI tools and return structured JSON responses to any frontend
Chatbots with tool use: embed Retell AI capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with Retell AI through natural language queries
Example Prompts for Retell AI in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK agent to start working with Retell AI immediately.
"List all my voice agents in Retell AI."
"Show me all AI voice agents and their call statistics from the last 7 days."
"Create a new outbound phone call using the Sales Qualifier agent to contact a prospect."
Troubleshooting Retell AI MCP Server with Vercel AI SDK
Common issues when connecting Retell AI to Vercel AI SDK through the Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpRetell AI + Vercel AI SDK FAQ
Common questions about integrating Retell AI MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.