How to Use the HiDeliver MCP in Pydantic AI

Q: How do I attach the HiDeliver tools to Pydantic AI?

Install the slim package with MCP support. Create an MCPToolset using your Vinkius HTTP URL and pass it to your Agent via the toolsets array.

Expose HiDeliver to Pydantic AI to guarantee type-safe, validated email marketing operations.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HiDeliver MCP to Pydantic AI

Create your Vinkius account to connect HiDeliver 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 HiDeliver with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Schedule broadcasts with Pydantic AI

The `create_delivery` tool logs and schedules fresh pickup deliveries while Pydantic strictly validates every parameter the agent tries to pass. If the LLM hallucinates an invalid email format or missing subject line, the framework fails loudly before the request ever hits the network. You manage existing campaigns via `update_delivery` and `cancel_delivery` with the same strict runtime checks. Agents pull active lists using `list_deliveries` or isolate a specific run with `get_delivery`, knowing the response structure will exactly match your defined Python models.

Validate account balances instantly

Checking `get_account_balance` evaluates your remaining cash thresholds without risking silent data corruption. Pydantic ensures the returned float or integer maps directly to your internal billing logic. Your agent pulls global ledger events using `list_transactions` and verifies individual charges via `get_transaction`. It then confirms the authenticated account logic through `get_profile`, giving you a mathematically certain view of your marketing spend.

Flawless MCP Server connection

You connect this MCP Server using the unified `MCPToolset` approach. Pass the Vinkius HTTP endpoint into the constructor, and Pydantic AI handles the Streamable HTTP transport automatically. Every operation runs inside an ephemeral V8 Isolate Sandbox on the Vinkius platform. This guarantees your agent executes its type-safe logic in a secure, isolated environment that requires only a single endpoint token.

Setup guide

Set up HiDeliver 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": {
        "hideliver-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent HiDeliver 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 HiDeliver. 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 HiDeliver 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 HiDeliver MCP in Pydantic AI

Install the slim package with MCP support. Create an `MCPToolset` using your Vinkius HTTP URL and pass it to your Agent via the `toolsets` array.

The framework throws a severe validation error immediately. Pydantic refuses to forward malformed requests to the API, protecting your deliverability reputation.

Yes. The framework is model-agnostic, meaning you can wire up local LLMs to trigger campaigns or check balances just as easily as using Anthropic or OpenAI.

Pydantic handles async execution natively. Your agent can fire off a broadcast and continue processing other tasks while waiting for the HTTP response.

Vinkius processes your HTML payloads and recipient lists in a zero-trust, ephemeral memory space. The moment the transaction finishes, the sandbox is destroyed, leaving no trace of your corporate communications.

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