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

Q: Can Vercel AI SDK read specific form submissions from HubSpot Marketing Hub?

Yes. Your agent first uses hslistforms to get the form ID. Then it passes that ID into hsformsubmissions to read the exact field values visitors entered.

Q: How does the HubSpot Marketing Hub integration handle data privacy with Vercel AI SDK?

The server reads sensitive lead capture data via hsformsubmissions, including whatever field values visitors submitted. Vinkius isolates this execution in a V8 sandbox, ensuring your endpoint token remains secure and the data never leaks across sessions.

Build real-time marketing dashboards in Next.js. Connect Vercel AI SDK to HubSpot Marketing Hub and stream campaign data straight to users.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HubSpot Marketing Hub MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream data to your Vercel AI SDK frontend

You don't want users staring at loading spinners while you fetch campaign stats. This MCP Server lets your Vercel AI SDK agent pull data from HubSpot and stream it directly into your React components. When a user asks about their recent email sends, your agent runs `hs_list_marketing_emails`. The subject lines, publish dates, and send statuses appear in the UI immediately as the LLM generates the response.

Render live form performance

Building a custom lead generation dashboard usually means writing a lot of glue code to read form data. Now your AI client handles the heavy lifting by talking directly to the HubSpot API. Your agent uses `hs_list_forms` to find the right ID, then triggers `hs_form_submissions` to pull the actual field values and dates. Vercel AI SDK takes that raw JSON and streams it into a formatted table component on your frontend.

Map audience segments dynamically

Marketers need to know how many people are in their target lists before they launch a campaign. You can build a chat interface that answers these questions instantly. Pass the `hs_list_contact_lists` tool to your client. Your agent checks the static and dynamic list sizes, grabbing the exact contact counts, and feeds that data back to the user without them ever opening the HubSpot dashboard.

Setup guide

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

Install @ai-sdk/mcp in your project. Use createMCPClient with the HTTP transport pointing to your server URL, then call mcpClient.tools() and pass the array to streamText.

Yes. Your agent first uses hs_list_forms to get the form ID. Then it passes that ID into hs_form_submissions to read the exact field values visitors entered.

That is the main advantage here. When the MCP Server returns data from hs_list_campaigns, the framework streams those results directly into your Next.js UI components.

You get read access to core marketing assets via this MCP integration. The tools handle landing pages, marketing emails, contact lists, campaigns, and form submissions.

The server reads sensitive lead capture data via hs_form_submissions, including whatever field values visitors submitted. Vinkius isolates this execution in a V8 sandbox, ensuring your endpoint token remains secure and the data never leaks across sessions.

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