How to Use the Heymarket MCP in Vercel AI SDK

Q: How do I stream Heymarket SMS histories using the Vercel AI SDK?

Use the getchathistory tool inside your streamText function. The SDK handles the tool execution and streams the raw message blocks directly to your frontend components.

Q: Can I update a Heymarket contact profile inside a Vercel AI SDK edge function?

Yes. You initialize the MCP client on the edge, call updatecontactprofile, and pass the updated payload. The connection runs over lightweight HTTP transports to keep latency under 100ms.

Q: How does the Vercel AI SDK handle Heymarket team member assignments?

You use listteammembers to get the list of active agents in your workspace. From there, your UI can call updatechatstatus to assign the conversation to the correct agent based on user selection.

Get Heymarket SMS tools streaming directly to your Next.js UI using the Vercel AI SDK and this 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 Heymarket MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Live SMS Feeds into React

The `list_active_chats` tool pulls your team's current conversations directly into your frontend application. Your AI client reads the incoming messages and updates your user interface in real-time without making users wait for a full page reload. By combining this with `get_chat_history`, you feed the raw text history into your streaming LLM loop. This lets your application render the conversation thread dynamically as your agent analyzes customer sentiment or drafts suggested replies.

Instant Contact Profile Updates on the Edge

The `update_contact_profile` tool changes customer records instantly from your Vercel Edge Functions. Your interface triggers this action based on user input, updating details like names or custom fields without hitting a cold-start bottleneck. You can pair this with `create_contact` to register new users on the fly. Because the Vercel AI SDK handles tool calls natively, the customer profile updates on the screen the exact millisecond the Heymarket database registers the change.

Send Real-Time Texts via Vercel AI SDK MCP Server

The `send_sms_message` tool lets your web app send outbound texts directly from a shared business line using a designated workspace ID. You pass the recipient's phone number and the message content, and this MCP server fires the text immediately. To keep your UI updated, your agent can call `get_message_details` right after sending. This retrieves the delivery status and streams it directly to your customer-facing dashboard so users see their message status change from pending to sent.

Setup guide

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

Use the `get_chat_history` tool inside your streamText function. The SDK handles the tool execution and streams the raw message blocks directly to your frontend components.

Yes. You initialize the MCP client on the edge, call `update_contact_profile`, and pass the updated payload. The connection runs over lightweight HTTP transports to keep latency under 100ms.

You use `list_team_members` to get the list of active agents in your workspace. From there, your UI can call `update_chat_status` to assign the conversation to the correct agent based on user selection.

You configure a single endpoint token on Vinkius. Pass this token in your createMCPClient transport configuration to grant your agent secure access to the Heymarket API.

Vinkius runs the server inside a secure, ephemeral V8 isolate sandbox. Your customer phone numbers and SMS message histories are never logged or stored on our platform, passing directly between your application and Heymarket.

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