How to Use the HubSpot Marketing Hub MCP in Pydantic AI

Q: How do I integrate HubSpot Marketing Hub with Pydantic AI?

Install pydantic-ai-slimmcp and define an MCPToolset with your Vinkius HTTP URL. Pass the MCP Server toolset to your agent to enable type-safe interactions.

Q: Will Pydantic AI catch errors in HubSpot Marketing Hub data?

Yes. Every response from tools like hslistlandingpages is validated against your Pydantic models. The agent throws a validation error immediately if a required field is missing.

Q: Which transport method connects Pydantic AI to HubSpot Marketing Hub?

Use the unified MCPToolset approach with a Streamable HTTP or SSE transport. The older MCPServerHTTP class is deprecated and should not be used for this MCP connection.

Connect HubSpot Marketing Hub to Pydantic AI for type-safe agents that validate every campaign and form record at runtime.

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 Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Lead Capture Reads

The `hs_form_submissions` tool pulls visitor field values and dates, forcing the output through strict Pydantic models. If the API returns a malformed date string, the framework fails loudly instead of passing garbage data to your agent. You must supply a valid ID to get those submissions. The agent uses `hs_list_forms` to grab the exact IDs, field counts, and types. Every step of the retrieval process guarantees structural correctness.

Validate Campaigns via MCP Server

Use `hs_list_campaigns` to extract initiative names, statuses, and associated dates with zero silent failures. Your agent reads the exact state of your marketing efforts and halts if the schema mismatches. You cross-check these initiatives using `hs_list_marketing_emails`. The agent reads the subject lines and publish states, ensuring your automated emails align with the active campaign dates.

Strict Audience Segmentation

The `hs_list_contact_lists` tool returns list names, dynamic types, and contact counts directly into your validated pipeline. Your agent knows exactly how many contacts sit in each segment before making decisions. Pair this with `hs_list_landing_pages` to verify destination URLs. The agent checks the publish status and slug, ensuring the target page matches the expected format before generating reports.

Setup guide

Set up HubSpot Marketing Hub MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "hubspot-marketing-hub-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to HubSpot Marketing Hub tools.",
)

result = await agent.run("List recent HubSpot Marketing Hub transactions")
print(result.output)

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 Pydantic AI

Install `pydantic-ai-slim[mcp]` and define an `MCPToolset` with your Vinkius HTTP URL. Pass the MCP Server toolset to your agent to enable type-safe interactions.

Yes. Every response from tools like `hs_list_landing_pages` is validated against your Pydantic models. The agent throws a validation error immediately if a required field is missing.

Use the unified `MCPToolset` approach with a Streamable HTTP or SSE transport. The older `MCPServerHTTP` class is deprecated and should not be used for this MCP connection.

No. The tools only read data. You check the status of an email, but you can't change it from draft to published.

List names and contact counts are processed in a V8 Isolate Sandbox. Vinkius handles the MCP Server authentication securely, and the ephemeral execution environment leaves no trace of your data after the read operation completes.

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