How to Use the EasyPost MCP in OpenAI Agents SDK

Q: How do I connect the EasyPost MCP Server to the OpenAI Agents SDK?

Install the SDK using pip install openai-agents. Initialize the server with MCPServerStreamableHttp using your Vinkius endpoint, then pass the server object inside the mcpservers list when creating your Agent.

Q: Can my OpenAI Agents SDK setup check EasyPost tracking details in real time?

Yes. Your agent uses gettrackingdetails to fetch active tracking events. You can also run listactivetrackers to get a complete list of what is currently moving.

Q: How do I keep the EasyPost MCP Server tool discovery fast in OpenAI Agents SDK?

Set cacheToolsList=True in your server configuration. This prevents the agent from querying the server for the tool list on every single turn, keeping your execution fast.

Run production shipping agents using OpenAI Agents SDK and the EasyPost MCP Server to track and audit deliveries without manual work.

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 OpenAI Agents SDK

Create your Vinkius account to connect EasyPost to OpenAI Agents 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 EasyPost with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit EasyPost delivery health inside OpenAI Agents SDK

Stop guessing if your packages are actually arriving. Let your OpenAI Agents SDK run `quick_delivery_health_audit` to get a direct summary of your EasyPost delivery success rates. This tool gives your agents real numbers on shipping performance instead of making them parse endless tracking logs. The OpenAI Agents SDK uses `list_in_transit_packages` to isolate stalled shipments before customers start complaining about their EasyPost orders. You get a clear picture of what is stuck in the wild, keeping your support team ahead of shipping delays.

Check carrier setups with this EasyPost MCP Server

Your OpenAI Agents SDK needs to know which shipping accounts are active before printing labels. Run `list_carrier_accounts` to fetch every connected carrier like FedEx or USPS directly into your OpenAI agent context. This prevents silent failures when an agent tries to route a package through an inactive account. Pair this with `get_easypost_account_metadata` to check your API limits before running batch operations within your OpenAI agent workflow. Your agent checks account health before it triggers a single API call, keeping your rate limits intact.

Inspect EasyPost shipments during agent handoffs

When one OpenAI agent passes a shipping ticket to another, you need exact EasyPost data. The agent runs `get_shipment_details` to pull rates and dimensions directly into the OpenAI handoff payload. No guesswork. Just raw, checked shipment details injected right into the next agent's context. If a customer asks about a specific package, the agent runs `search_by_tracking_code` to pull up the exact tracker, while OpenAI's tracing dashboard records the entire tool execution. This gives you a clear log of what data passed between agents.

Setup guide

Set up EasyPost MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all EasyPost tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives EasyPost tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate EasyPost tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="EasyPost Agent",
            instructions="You have access to EasyPost tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Install the SDK using `pip install openai-agents`. Initialize the server with `MCPServerStreamableHttp` using your Vinkius endpoint, then pass the server object inside the `mcp_servers` list when creating your Agent.

Yes. Your agent uses `get_tracking_details` to fetch active tracking events. You can also run `list_active_trackers` to get a complete list of what is currently moving.

Set `cacheToolsList=True` in your server configuration. This prevents the agent from querying the server for the tool list on every single turn, keeping your execution fast.

The OpenAI Agents SDK features built-in guardrails that validate agent actions before execution. If an agent tries to call an unauthorized tool, the guardrails block the call before it hits the API.

Yes, Vinkius runs this server in an isolated V8 sandbox. Your API keys, carrier credentials, and customer addresses are never stored. The connection is ephemeral, meaning everything clears out the moment the session ends.

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