How to Use the Goodcall MCP in Vercel AI SDK

Q: How do I stream Goodcall phone transcripts using the Vercel AI SDK?

You call gettranscript inside your streamText function after setting up the MCP client transport. The transcript data flows directly into your React hooks, rendering the caller's words on screen as they finish speaking. Remember to close the client connection when the stream ends.

Q: Can I manage phone bookings in Next.js with Goodcall and Vercel AI SDK?

Yes, you can fetch active reservation lists using listbookings within your server actions. The SDK passes this tool directly to your model, allowing it to display or modify booked appointments on your custom calendar interface.

Q: How does Vercel AI SDK handle Goodcall agent updates?

The SDK calls updateagent through the MCP protocol to change your receptionist's instructions. This means your dashboard can instantly modify the receptionist's behavior based on user input without requiring a separate backend API wrapper.

Feed real-time call logs and phone bookings straight into your web app with the Vercel AI SDK and the Goodcall MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Goodcall MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live caller transcripts on your dashboard

The `get_transcript` tool pulls live conversation text so you don't have to wait for database polling to see what your phone agent is doing. When a customer calls your business, you can pipe the live conversation text straight to your React frontend. Your interface updates instantly while the customer is still speaking to the phone receptionist. You build UI components that react to incoming phone data without writing complex WebSocket wrappers. By mapping `get_call_summary` into your streaming text components, your web dashboard shows call outcomes the second the line goes dead.

Render booking updates instantly in the UI

The `list_bookings` tool lets you instantly check scheduled appointments and render them on your Next.js calendar. Customers booking appointments over the phone shouldn't feel like they're shouting into a void. Use this tool inside your edge functions to instantly render reservation slots on your admin calendar as they happen. Your AI client triggers this tool to fetch current appointments and feeds them directly into your UI components. It means your team watches the schedule fill up in real-time, matching what the phone agent is telling the caller.

Dynamic agent tuning via Vercel AI SDK

The `update_agent` tool lets you change how your phone receptionist behaves on the fly without redeploying your entire application stack. By connecting this tool to a simple admin interface, your team can adjust business logic or call flows directly from the browser. The SDK takes the updated system prompt, runs it through your edge route, and updates the active phone agent immediately. You can also run `get_agent` to verify the current settings before pushing changes live to your active phone lines.

Setup guide

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

You call `get_transcript` inside your `streamText` function after setting up the MCP client transport. The transcript data flows directly into your React hooks, rendering the caller's words on screen as they finish speaking. Remember to close the client connection when the stream ends.

Yes, you can fetch active reservation lists using `list_bookings` within your server actions. The SDK passes this tool directly to your model, allowing it to display or modify booked appointments on your custom calendar interface.

The SDK calls `update_agent` through the MCP protocol to change your receptionist's instructions. This means your dashboard can instantly modify the receptionist's behavior based on user input without requiring a separate backend API wrapper.

Yes, the lightweight HTTP transport setup makes it fully compatible with edge runtimes. You can query `check_goodcall_status` or retrieve quick call summaries using `get_call_summary` with minimal cold-start latency.

Phone call transcripts and caller phone numbers are processed inside Vinkius's isolated V8 sandboxes. Your raw audio data and call logs never touch external servers, and credentials are encrypted using zero-trust environment tokens.

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