How to Use the HubSpot Sales Hub MCP in Vercel AI SDK

Q: How do I fetch pipeline IDs for HubSpot Sales Hub deals using Vercel AI SDK?

Have your agent run hslistpipelines first to fetch the correct active pipeline and stage IDs. The SDK then passes these IDs directly into the hscreatedeal tool call without requiring hardcoded values in your frontend.

Stream HubSpot Sales Hub deals and pipeline metrics directly into React components using 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 HubSpot Sales Hub MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream HubSpot Sales Hub data to Vercel AI SDK frontends

Your AI client can query real-time sales data using `hs_deals_by_stage` and feed it directly into your React components. Instead of making users wait for a full page reload or static API fetch, the Vercel AI SDK streams the live deal data as it arrives. This means when a rep asks about the negotiation pipeline, the UI updates instantly with active deals. By combining this MCP Server with Edge Functions, your app renders the sales pipeline without hitting cold-start bottlenecks.

Interactive deal creation with zero UI lag

Create new sales opportunities instantly using `hs_create_deal` and `hs_list_pipelines` without forcing the user to stare at a loading spinner. The SDK updates your application state on the fly, rendering the newly created deal card in the UI while the background API call finishes. The UI stays responsive because the MCP Server tool execution is tied directly to the streaming text response. If a field is missing, the agent asks for clarification in the chat while preserving the draft state in the frontend.

Real-time product search inside conversational inputs

Search the HubSpot product library instantly using `hs_search_products` directly from your application's chat input. The agent pulls names, prices, and SKUs, rendering them as interactive UI cards instead of plain text blocks. Because the Vercel AI SDK supports structured UI generation, these product cards can be clicked or added to a new quote instantly. You bypass building complex search pages and let the agent do the heavy lifting.

Setup guide

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

The server returns raw deal or product data, which the SDK maps to React components using standard helper functions. When `hs_deals_by_stage` runs, the JSON payload feeds directly into your custom pipeline component.

Yes. This server is fully compatible with Edge runtimes because it relies on lightweight HTTP transports. You can execute `hs_update_deal` inside Next.js API routes without worrying about serverless timeouts.

Have your agent run `hs_list_pipelines` first to fetch the correct active pipeline and stage IDs. The SDK then passes these IDs directly into the `hs_create_deal` tool call without requiring hardcoded values in your frontend.

You should handle rate limiting at the route handler level where the SDK initializes the client. Since the server handles direct HubSpot requests, wrap your tool calls in standard Vercel edge-caching layers for read-only actions like `hs_search_products`.

Completely. The server runs in a secure, isolated sandbox where your HubSpot API tokens never touch public Vercel client bundles. Only the necessary deal names, amounts, and stage IDs are transmitted over the secure endpoint.

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