shippo-mcp

Official Shippo MCP server: compare multi-carrier rates, buy labels, track packages, and validate addresses from a prompt.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Shippo List Tools: List Shippo API operations available through this server. Use this FIRST to discover what operations exist before calling shippo_describe_tool or one of the execute tools. Returns e
  • Shippo Describe Tool: Get the full input schema, detailed description, and kind classification for a Shippo operation. Call this AFTER shippo_list_tools to learn the exact parameters (required + optio
  • Shippo Read Execute Tool: Execute a READ-only Shippo API operation (List*, Get*, Validate*, Parse*, etc.). Returns the Shippo API response. Does NOT mutate any state. Use this tool ONLY for operations

What data it sees

Do you need an account

No: the server works without sign-in

Official Shippo MCP server: compare multi-carrier rates, buy labels, track packages, and validate addresses from a prompt.

How to connect

How to connect shippo-mcp to Claude

The server address to paste into Claude settings:

https://shippo.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect shippo-mcp to ChatGPT

The server address to paste into ChatGPT settings:

https://shippo.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect shippo-mcp to Cursor

The server address to paste into Cursor settings:

https://shippo.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (4)

Raw names from tools/list. Only developers need these.

shippo_list_toolsList Shippo API operations available through this server. Use this FIRST to discover what operations exist before calling shippo_describe_tool or one of the execute tools. Returns each operation's short name, category, kind (read or write), and one-line description. Filter by `category` (e.g. 'Webhooks', 'Manifests', 'Address Book'), `kind` ('read' or 'write'), or `query` (natural-language keywords matched against names and descriptions). Pass no arguments to list everything. There are ~74 operations spanning 17 categories: Addresses, Address Book, Batches, Carrier Accounts, Customs, Manifests, Orders, Parcels, Pickups, Rates, Refunds, Service Groups, Shipments, Shippo Accounts, Tracking, Transactions, Webhooks.
shippo_describe_toolGet the full input schema, detailed description, and kind classification for a Shippo operation. Call this AFTER shippo_list_tools to learn the exact parameters (required + optional, types, enum values) AND to confirm which execute tool to use (read or write). Pass the short operation name from shippo_list_tools (e.g. 'listWebhooks', 'CreateAddress', 'GetTrack'). Name lookup is case-insensitive.
shippo_read_execute_toolExecute a READ-only Shippo API operation (List*, Get*, Validate*, Parse*, etc.). Returns the Shippo API response. Does NOT mutate any state. Use this tool ONLY for operations whose kind is 'read' per shippo_describe_tool. Calling a write operation here will be rejected — use shippo_write_execute_tool for those. Get the operation name from shippo_list_tools and its argument shape from shippo_describe_tool first. Name lookup is case-insensitive.
shippo_write_execute_toolExecute a WRITE Shippo API operation (Create*, Update*, Delete*, *Refund, etc.). Returns the Shippo API response. WILL mutate state on the user's Shippo account. Use this tool ONLY for operations whose kind is 'write' per shippo_describe_tool. Calling a read operation here will be rejected — use shippo_read_execute_tool for those. Get the operation name from shippo_list_tools and its argument shape from shippo_describe_tool first. Name lookup is case-insensitive.