How to Use the Intercom MCP in Vercel AI SDK

Q: How do I stream Intercom conversation details using the Vercel AI SDK?

Call getconversationdetails inside your streamText tool definition with this MCP Server. The Vercel AI SDK processes the payload and pushes the chat history chunks directly to your React frontend.

Q: Can the Vercel AI SDK search Intercom contacts from an edge function?

Yes. The client works in edge environments, calling searchcontacts to find matching users and returning the results to your frontend with low latency.

Feed live Intercom chat histories and customer details directly into your Next.js frontend using the Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Intercom MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live conversation rendering with Vercel AI SDK

Show users their chat history instantly without making them stare at loading spinners by fetching data with `get_conversation_details`. This MCP integration lets your app pull raw threads and stream the text directly into React components. You write the frontend code and let the SDK handle the transport. When a user asks for their history, the model fetches the data and paints the UI block by block in real-time.

On-the-fly contact updates

Your Next.js edge functions can trigger `create_contact` or `search_contacts` the second a visitor signs up. The MCP client handles the state so you don't write custom API endpoints for every form. Your agent checks the user's status, updates their profile, and updates the UI instantly.

Instant help desk lookup

Stop building slow search bars for your documentation and let your agent query your docs with `list_help_articles` directly. The model matches customer questions to your support articles and streams the exact paragraphs they need. It keeps users inside your application instead of redirecting them to an external support portal.

Setup guide

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

Call `get_conversation_details` inside your streamText tool definition with this MCP Server. The Vercel AI SDK processes the payload and pushes the chat history chunks directly to your React frontend.

Yes. The client works in edge environments, calling `search_contacts` to find matching users and returning the results to your frontend with low latency.

The SDK passes rate limit headers directly back to your application code. You can check these limits before running heavy tools like `list_conversations` to prevent API blocks.

No. The client handles the active session state. When you call `reply_to_conversation`, the SDK updates the chat UI automatically as soon as the API registers the message.

Your contact records and conversation histories are never stored. The MCP server runs each query in an isolated, ephemeral environment that destroys all memory as soon as the API call finishes.

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