Model Context Protocol

Give your AI agent shipment tracking

Shipyu has an official MCP server. Connect it once and Claude Code, Cursor, Codex, or any MCP client can create trackers, read live shipment status, manage webhooks, and check your usage. Test keys are free — an agent can verify the whole integration without spending money.

Claude Code — one command

Replace the key with an API key from the console — a free test key is issued the moment you sign up.

claude mcp add shipyu --scope user --transport http https://shipyu.com/api/mcp --header "Authorization: Bearer sk_shipyu_test_YOUR_KEY"

Then try it:

Track 9400111899560000000000 with USPS and tell me where it is.

Cursor and other MCP clients

Add this to your mcp.json. The server speaks MCP Streamable HTTP (JSON) and authenticates with your Shipyu API key as a Bearer token.

{
  "mcpServers": {
    "Shipyu": {
      "type": "http",
      "url": "https://shipyu.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_shipyu_test_YOUR_KEY"
      }
    }
  }
}

7 tools, the full tracking workflow

create_tracker	Start tracking a carrier tracking number
get_tracker	Read a tracker's status and timeline
delete_tracker	Stop tracking a shipment
list_webhooks	List webhook endpoints and their health
create_webhook	Register a signed event endpoint
test_webhook	Send a sample event end to end
get_usage	Check request counts and success rate

Start with a free test key

Sign up, copy your test key, run the command above. Test mode returns realistic sample data and costs nothing. Live tracking is $0.020 per tracker, falling with volume.

Get a free test key API reference