API docs / Integrations

Ship from the chat: compare rates, book, get labels, track and estimate duties with Claude or ChatGPT.

With our MCP server you connect your ParcelParcel account to your AI assistant. Then you just ask, in plain language: "What does it cost to send this box to New York?", "Book the cheapest one", "Where is my shipment to Paris?" The assistant uses the same prices, carriers and shipments as your MyParcelParcel account, and asks you to confirm before anything is booked.

You don't need to write code or create API keys: you log in with your ParcelParcel account once.

#Server URL

You only need one thing, this server URL:

ParcelParcel

https://services.parcelparcel.com/mcp

LetMeShip Next

https://services.letmeship.com/mcp

#What the assistant can do

When you connect, the assistant gets these tools. You don't call them yourself: the assistant picks the right one from what you ask.

#Use cases

#Compare rates and transit times

The assistant uses compare_shipping_options and shows the options with price (excluding VAT) and transit time, cheapest first. Mention a zipcode or city for the most accurate price: without them we use the capital of the country. Want insurance? Say so and give the value of the goods; it's included in the price.

Other things you can ask:

• "Compare DHL and FedEx for a pallet of 120 kg to Antwerp, delivered to a business."
• "What's the cheapest way to send documents to Tokyo?"

#Book a shipment

Booking always takes two steps:

1. Draft. create_shipment_draft makes a draft with your chosen option and shows the price. Is something missing, such as a phone number of the recipient? The assistant asks you for it. It never makes up names, phone numbers or email addresses.
2. Book. After you confirm, book_shipment books it at the carrier and gives you a link to the PDF label. The link works for about an hour; ask "Give me the label again" for a new one.

You can also stop after step 1: the draft stays in API shipments in MyParcelParcel, where you can check it and book it yourself.

Add-ons. You can ask for extras: insurance, scheduled_pickup (the carrier picks it up on the date you give), and for pallets truck and hydraulic. Paid add-ons, and fields we fill in for you (such as an importer address that we copy from the destination), are shown to you before booking and only go through when you confirm them.

#Ship outside the EU (customs)

For shipments outside the EU, every item needs a description, an HS code, the country where it was made, a quantity and a price per unit. Depending on your account, the assistant also asks for incoterms (DAP or DDP) and an importer address. The customs value is the total of the items. Is the shipment a gift, sample or return instead of a sale? Tell the assistant; otherwise the reason for export is commercial.

#Estimate duties and taxes

estimate_duties_taxes returns the estimated duties and VAT per line and the total. It's an estimate: what customs actually charges can be different.

#Track a shipment

track_shipment shows the status (info_received, in_transit, exception or delivered) and every scan with time and place. Don't have the tracking number at hand? Ask "Where is my shipment to Jane Smith?": the assistant finds it first with find_shipments.

#Find shipments

find_shipments searches by reference, tracking number, address, status, carrier, origin and destination country and booking date, 25 per page (up to 100). Handy for questions like "Show my DHL shipments of this week" or "Find order #123126".

#Get a label again

The assistant finds the shipment and uses get_shipment_labels for a new link to the PDF.

#Cancel a shipment

cancel_shipment cancels it, as long as the carrier hasn't picked up or scanned the parcel. This is permanent: the shipment can't be used again. If the parcel is already on its way, the assistant tells you it can no longer be cancelled.

#You stay in control

• Nothing is booked without you. Booking is always a separate step after a draft, and paid add-ons need your confirmation.
• No guessing. Contact details, phone numbers and email addresses come from you; the assistant asks when something is missing and doesn't fill in placeholders.
• No double bookings. If a booking is sent twice (for example after a time-out), the second attempt returns the first booking instead of booking again.
• Read or write. When you connect, you approve access to your account. Booking, creating drafts and cancelling need write access (mcp:write); everything else only reads.
• Real bookings. The MCP has no sandbox mode: a booked shipment is booked at the carrier and charged to your account. Want to try things out first? Stop at the draft step, or use the API with your sandbox key.

#Connect in ChatGPT

Important: you first need to turn on "Developer mode" in ChatGPT, otherwise you can't add a custom connector.

1. Click your workspace (bottom left) → Settings.
2. Go to Security and login.
3. Turn on the Developer mode toggle. (ChatGPT shows an "elevated risk" warning; that's normal for custom connectors.)
4. Then go to Plugins / Connectors (or open directly: https://chatgpt.com/plugins#settings/Connectors?create-connector=true).
5. Click New plugin / Add connector.
6. Fill in:
   • Name: ParcelParcel or LetMeShip Next
   • Connection: Server URL
   • URL: https://services.parcelparcel.com/mcp (or https://services.letmeship.com/mcp for LetMeShip Next)
   • Authentication: OAuth
7. Tick "I understand and want to continue" and click Create.
8. Click Connect → Sign in with ParcelParcel/LetMeShip Next and log in with your ParcelParcel/LetMeShip Next account.
9. Click Approve to grant access. Done!

Now try asking, for example: "Where is my latest shipment?"

#Connect in Claude

Who can connect?

• Individual accounts (Pro/Max): you can add and authorise the connector yourself.
• Team/Enterprise: an Organisation Owner must add the connector organisation-wide first; after that, everyone can connect.

Steps:

1. Open Claude and click Settings.
2. Go to Connectors → Discover.
3. Search for "ParcelParcel" and click Add on the ParcelParcel connector.
4. Log in with your ParcelParcel account and approve access.
5. Done! Try asking, for example: "Compare shipping options to Germany for a 2 kg parcel."

Fallback: manual setup (if ParcelParcel doesn't show up in Discover)

1. Open Claude and click Settings.
2. Go to Connectors → Add custom connector.
3. Paste https://services.parcelparcel.com/mcp and confirm.
4. Log in with your ParcelParcel account and approve access.

#Connect in Claude Code

Add the server from the terminal:

claude mcp add --transport http parcelparcel https://services.parcelparcel.com/mcp

To make it available across all your projects (instead of just the current one), add --scope user:

claude mcp add --transport http parcelparcel https://services.parcelparcel.com/mcp --scope user

Run /mcp inside a Claude Code session to log in and check that the parcelparcel server is connected.

Questions, feedback, or something not working? Email [email protected].