How to Use the EasyPost MCP in Pydantic AI

Q: How do I add the EasyPost MCP Server to my Pydantic AI project?

Install the package with pip install "pydantic-ai-slimmcp". Use the unified MCPToolset class with your Vinkius HTTP URL, and pass that toolset directly to your Agent constructor.

Q: Does this EasyPost MCP Server integration support SSE transports in Pydantic AI?

Yes. The MCPToolset supports both Streamable HTTP and SSE transports. This allows you to connect to your externally running Vinkius server without complex network configurations.

Build type-safe shipping agents using Pydantic AI and the EasyPost MCP Server to handle logistics with zero runtime type errors.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect EasyPost MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate EasyPost shipping data with this MCP Server

If you care about data integrity, stop guessing. Pydantic AI validates every response from `get_shipment_details` against strict Pydantic models at runtime to ensure your EasyPost data is clean. If the API returns unexpected data, the framework fails loud and clear. Run `get_easypost_account_metadata` to check your account limits before executing shipping actions inside your Pydantic AI agent. This ensures that any metadata matches your exact Python type definitions before your agent makes a decision.

Monitor active EasyPost pipelines using Pydantic AI

The Pydantic AI agent runs `list_in_transit_packages` to pull all active shipments currently moving through your EasyPost carrier networks. Because Pydantic AI handles the validation, you don't have to write manual type checks for carrier response objects. If an EasyPost package is stalled, the Pydantic AI agent runs `get_tracking_details` to inspect individual transit events with full runtime validation. Every transit milestone is checked before it updates your database, preventing silent data corruption.

Audit EasyPost delivery health with type-safe tools

Run `quick_delivery_health_audit` to get a fast, structured summary of your overall EasyPost delivery success rates directly inside your Pydantic AI workflows. The returned audit fields are validated instantly, giving your agent clean data to generate reports. To find specific orders, the Pydantic AI agent runs `search_by_tracking_code` and validates the resulting tracker schema against your strict types. This ensures that any tracking codes passed to downstream systems are perfectly formatted.

Setup guide

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

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

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

Install the package with `pip install "pydantic-ai-slim[mcp]"`. Use the unified `MCPToolset` class with your Vinkius HTTP URL, and pass that toolset directly to your Agent constructor.

The system fails loudly with a validation error. Instead of passing corrupt tracking data to your database, the framework halts execution so you can fix the schema mismatch immediately.

Yes. The `MCPToolset` supports both Streamable HTTP and SSE transports. This allows you to connect to your externally running Vinkius server without complex network configurations.

Pydantic AI is model-agnostic. You can run this shipping setup with OpenAI, Anthropic, Gemini, or even a local model, while keeping the same strict type-validation on your shipping tools.

All customer address data, tracking codes, and shipment values are processed inside a secure, ephemeral V8 isolate sandbox. Vinkius uses zero-trust architecture, meaning no shipping data is cached or stored after execution.

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