MCP server

The Shipmondo MCP server lets AI assistants like Claude, ChatGPT and Gemini work with a Shipmondo account through the Model Context Protocol. It is a thin layer on top of the Shipmondo API, with a set of tools designed for assistants rather than one tool per endpoint.

The assistant connects with OAuth, so no API key is pasted into the assistant.

• Server URL: https://mcp.shipmondo.com/mcp
• Transport: Streamable HTTP (stateless, JSON responses)

Connecting an assistant

Any MCP client that supports remote servers with OAuth can connect. Add the server URL to your client, and the client will open Shipmondo in your browser. Log in as the account owner and approve the connection.

See Connect an AI assistant to Shipmondo (MCP) for step-by-step guides for Claude, ChatGPT and Gemini.

Claude Code

claude mcp add --transport http shipmondo https://mcp.shipmondo.com/mcp

Start Claude Code and run /mcp to log in.

Cursor

Add the server to .cursor/mcp.json in your project, or ~/.cursor/mcp.json for all projects:

{
  "mcpServers": {
    "shipmondo": {
      "url": "https://mcp.shipmondo.com/mcp"
    }
  }
}

VS Code

Add the server to .vscode/mcp.json in your workspace:

{
  "servers": {
    "shipmondo": {
      "type": "http",
      "url": "https://mcp.shipmondo.com/mcp"
    }
  }
}

Tools

Tool	Description	Access
list_carriers	List the carriers available for a destination country.	Read
list_products	List the shipping products and product codes available on the account.	Read
find_service_points	Find service points near an address.	Read
compare_quotes	Get a quick shortlist of estimated prices.	Read
quote_shipment	Get the exact price for a single product.	Read
shipment_draft	Create, update, list, retrieve and delete shipment drafts.	Write
create_shipment	Book a shipment.	Write, charges the account
find_shipments	Search booked shipments.	Read
get_shipment	Retrieve a single shipment.	Read
cancel_shipment	Cancel a shipment.	Write
find_sales_orders	Search sales orders, or retrieve a single sales order.	Read
create_sales_order	Create a sales order.	Write
update_sales_order	Update a sales order, set its note, or hold and unhold it.	Write
fulfil_sales_order	Create and list fulfillments, and ship orders and fulfillments.	Write, shipping charges the account
get_statistics	Query statistics on shipments, sales orders, sales order lines, fulfillments and invoices.	Read
list_ledger_entries	List balance movements with a running balance.	Read
manage_items	List, retrieve, create and update items.	Write
pickup	Find pickup points, and create and list carrier pickups.	Write
print_document	List printers and print documents through the Print Client.	Write
list_account_setup	Read account setup, e.g. package types, shipment templates, payment gateways and staff accounts.	Read
manage_webhooks	List, create, update and delete webhooks.	Write

Write tools are annotated with destructiveHint, so clients that support it will ask before running them. The server instructs the assistant to quote a price and get a clear confirmation before booking anything that charges the account.

What the MCP server can't do

Some tasks are deliberately left out of the MCP server:

• Retrieving labels and other documents as files
• Tracking information
• Refunding, capturing or voiding payments
• Arbitrary API calls outside the tools above

Use the Shipmondo CLI or the API for these.

Safeguards

Duplicate bookings

If an assistant books the same shipment or creates the same sales order twice within 10 minutes, the second call returns the result of the first call instead of booking again. The response is marked with duplicate_of_earlier_call: true.

Write limits

Each connection can make up to 120 write calls and 60 bookings per hour. When a limit is reached, tools return a write_budget_exceeded error until the next hour.

Untrusted content

Text that comes from outside Shipmondo, such as order notes and addresses from a webshop, is wrapped in a marker telling the assistant to treat it as data and not to follow any instructions in it.

Managing connections

All connected assistants are listed under Settings > Integrations > MCP in Shipmondo, together with who connected them and when they were last used. Removing a connection revokes access immediately.

A connection also stops working if the user who approved it is no longer the account owner.