How to Use the Placetel MCP in Vercel AI SDK

Q: How do I connect the Vercel AI SDK to this Placetel server?

You'll use the createMCPClient function from @ai-sdk/mcp. Pass it the unique URL Vinkius provides for your Placetel server. From there, you can pass the client's tools to streamText or generateText.

Stream Placetel call and user data directly into your frontend with the Vercel AI SDK. No more loading spinners.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Placetel MCP to Vercel AI SDK

Create your Vinkius account to connect Placetel to Vercel AI SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Placetel with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build a Live Call Dashboard

Show your users what's happening right now. Use the Vercel AI SDK to stream data from the `list_calls` tool directly into your React or Next.js components. As calls connect and end, your UI updates live. Combine it with `list_devices` to show which phones are active and `get_user` to display who is on the call. Because the AI SDK streams tool output, your users see the data as it arrives. It's perfect for building internal dashboards that feel fast and responsive.

Create a Real-Time User Directory

Give your support team a single place to look up Placetel information. Your agent can use `list_users` and `list_sip_users` to populate a searchable directory in your app. The data streams in, so even long lists feel quick. When a user selects someone from the list, your agent uses `get_user` or `get_sip_user` to pull their specific details. This Placetel MCP Server lets you build a custom admin panel without wrestling with a separate backend.

Audit Call Histories On-Demand

Let your users pull call logs without leaving your application. The `list_call_detail_records` tool gives your AI client access to the full call history. You can build a simple interface where a user asks, "Show me all calls from last Tuesday," and the AI SDK streams the results into a table. This gives you a secure way to expose call data. You don't need to build a dedicated API endpoint and authentication layer for it; just point your AI client at this managed MCP server and let it handle the request.

Setup guide

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

You'll use the `createMCPClient` function from `@ai-sdk/mcp`. Pass it the unique URL Vinkius provides for your Placetel server. From there, you can pass the client's tools to `streamText` or `generateText`.

Yes. The Vercel AI SDK is built for this. When your agent uses a tool like `list_calls`, the data streams directly into your UI components, updating them live as the information becomes available.

Yes, it's fully compatible. The MCP client is designed to run in any modern JavaScript environment, including Vercel's Edge Functions. This keeps latency low by running the logic close to your users.

Your agent can read data about users, SIP users, groups, devices, and phone numbers. It can also list active calls and pull historical call detail records. It's all read-only, so your agent can't make changes to your Placetel account.

Your Placetel call detail records are only passed through Vinkius's ephemeral server when your agent explicitly calls the `list_call_detail_records` tool. The connection is secured by your unique token, and the data is streamed directly to your application without being stored.

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