How to Use the Shipday MCP in Pydantic AI

Q: How does Shipday manage status changes with Pydantic AI?

You use updateorderstatus to change the job's state. Because of Pydantic validation, if you try to set an invalid status value (like 'Flying'), the agent fails loudly before writing bad data.

Q: What happens when I list all open jobs with Shipday and Pydantic AI?

Running listactiveorders returns a structured, validated list of job objects. You can immediately trust the format of the data without needing extra validation layers.

Q: Do I need to manually check driver availability with Shipday and Pydantic AI?

No. First call listdrivers to get all available worker records. Then, use assigndriver to link the job ID to a known, validated driver ID.

Q: Can I delete a job using Shipday and Pydantic AI safely?

Yes, just call deleteorder. Since every tool output is validated, you know the deletion request was processed correctly against your defined data schema.

Guarantee perfect data structure validation for Shipday using Pydantic AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Shipday MCP to Pydantic AI

Create your Vinkius account to connect Shipday to Pydantic AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Shipday with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Retrieving Typed Order Details

Need specific information on a shipment? Call `get_order` and the response will be validated against your defined Pydantic models. You'll never get unexpected fields. Similarly, if you need external carrier details, use `get_carrier_order`. The data is guaranteed to match your schema at runtime, preventing silent corruption.

Tracking Status with Schema Enforcement

Use `get_tracking_progress` to check the status of a delivery. The resulting data stream ensures that the progress updates (like ETA or current location) always conform to your expected Python types. If you need to see all ongoing jobs, `list_active_orders` gives you a validated list every time.

Setting Up and Assigning Jobs

Start a job by calling `create_order`, passing customer details and restaurant info. This initial data must conform to the required types for the agent to proceed. Once the order exists, use `assign_driver` to link it to a worker ID, ensuring both IDs are valid strings before proceeding with the delivery.

Setup guide

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

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

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

You use `update_order_status` to change the job's state. Because of Pydantic validation, if you try to set an invalid status value (like 'Flying'), the agent fails loudly before writing bad data.

Running `list_active_orders` returns a structured, validated list of job objects. You can immediately trust the format of the data without needing extra validation layers.

No. First call `list_drivers` to get all available worker records. Then, use `assign_driver` to link the job ID to a known, validated driver ID.

This server handles order numbers and customer contact information. The strict typing means you know exactly which fields are being passed around in the agent's memory.

Yes, just call `delete_order`. Since every tool output is validated, you know the deletion request was processed correctly against your defined data schema.

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