How to Use the HeyReach MCP in Vercel AI SDK

Q: How do I find which HeyReach account is sending messages?

Call listlinkedinaccounts. It returns the connected sender profiles, which you can render in your dashboard so users know exactly who is handling the outreach.

Build live LinkedIn outreach dashboards where the Vercel AI SDK streams campaign data and lead replies directly into your React frontend.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HeyReach MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream HeyReach MCP Server campaigns to React

The `list_campaigns` tool pulls active LinkedIn outreach data so your Vercel AI SDK agent can stream it straight into your frontend. Users watch their dashboard populate with campaign IDs and performance metrics instantly, bypassing traditional loading states. If a user needs to halt outreach, they click a button that triggers `pause_campaign` or `resume_campaign`. The UI updates immediately as the edge function confirms the status change with the server.

Inject lead profiles into live UI components

Your agent calls `get_lead_details` using a LinkedIn URL to fetch deep profile data. The SDK streams the prospect's background, current role, and company size straight into your Svelte or Next.js components as the AI reads it. Once the user approves the prospect, the agent fires `add_leads_to_campaign`. You pass the leads array as a JSON string, and the MCP integration queues them for outreach while the UI renders a success state.

Render LinkedIn inbox conversations instantly

The `list_conversations` tool grabs recent LinkedIn inbox threads. Your AI client reads the context and streams suggested replies into a chat interface before the user even asks for them. When the user hits send, the agent executes `send_linkedin_message` with the conversation ID and text payload. The Vercel AI SDK confirms delivery and updates the local chat thread in real time.

Setup guide

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

Install @ai-sdk/mcp. Initialize it with createMCPClient pointing to your endpoint, then call mcpClient.tools() to pass the HeyReach functions to streamText.

Yes. You can wire a frontend toggle that tells the AI to execute `pause_campaign`. The agent handles the API call and streams the updated status back to your UI.

Call `list_linkedin_accounts`. It returns the connected sender profiles, which you can render in your dashboard so users know exactly who is handling the outreach.

Streaming. Instead of waiting for a heavy API response, your agent streams the output of `get_lead_details` piece by piece into your React components.

The server processes LinkedIn profile URLs, names, and direct message text strictly in memory via the V8 Isolate Sandbox. The Vercel AI SDK streams this data to the client and drops the connection immediately, leaving zero residual data behind.

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