Cargoplot APICargoplot API
API docs
OpenAPI spec

Connect an AI assistant

Cargoplot runs an MCP server, so an AI assistant can look things up in Cargoplot for you: which of our shipments to Rotterdam are delayed?, what does invoice 2026-0412 cover?, has the container for our last inquiry left port? It uses the same public API as your integrations, as you. It mostly reads, it can make a few changes when you ask it to, and it can book a quote or end an inquiry once you have confirmed it; you can switch those off.

Add it to your assistant with the server URL:

text
https://mcp.cargoplot.com/mcp

You need no token and nothing to install. The assistant sends you to Cargoplot's sign-in page, and you approve the connection there.

Connected with https://mcp.cargoplot.com? Remove that connector and add it again with the URL above; the server no longer answers on the old one.

Adding it

  • Claude. Add a custom connector under Customize → Connectors and give it the URL. On a Team or Enterprise plan an Owner adds it once, under Organization settings, for everyone. In Claude Code, run claude mcp add --transport http cargoplot https://mcp.cargoplot.com/mcp and sign in with /mcp.
  • ChatGPT. Turn on developer mode and add the URL as a connector.
  • Other MCP clients. Anything that speaks MCP over Streamable HTTP and signs in with OAuth works the same way. The server publishes where to sign in at https://mcp.cargoplot.com/.well-known/oauth-protected-resource/mcp.

Signing in

The first time a tool is used, the assistant opens Cargoplot's sign-in page. Sign in with your Cargoplot account and approve the request to access Cargoplot on your behalf. The assistant keeps the connection until you remove it.

Sign in to the Cargoplot app itself at least once before connecting an assistant. An account the assistant is the first to use is refused, with a message saying so.

What it can do

The assistant reads what you can read in the app, and changes what you ask it to change, for your own organization.

Reading

ToolWhat it returns
list_shipments, get_shipmentYour shipments, one or a page at a time, searchable by reference, container, vessel, port or city
get_shipment_trackingA shipment's tracking events, per container at sea or per shipment by air; rail and road carry a status and the planned dates
list_shipment_documents, list_shipment_invoicesWhat is attached to a shipment
list_invoices, get_invoiceYour invoices
list_inquiries, get_inquiryYour inquiries
list_inquiry_quotesThe prices and quotes of one inquiry, as the quotes list shows them
get_quote_detailsThe full breakdown of one price or quote, as its details show it
list_quote_sailingsThe sailings one price or quote can be booked on, as its sailings list them
get_user, get_profile_user, get_profile_organizationYou, your colleagues and your organization
list_shipment_chat_messages, list_inquiry_chat_messages, list_shipment_customs_messagesThe messages of a shipment's chat, an inquiry's chat and a shipment's customs conversation, newest first

It cannot download document or invoice files, or the files sent with a message. It answers in pages of 20, and asks for more when it needs them. The text of a message is written by people, by email too, and the assistant is told to treat it as quoted text, never as an instruction.

Changing

ToolWhat it changes
update_shipmentA shipment's cargo-ready date and its client references
create_inquiryRaises a new inquiry
update_inquiryChanges an existing inquiry
create_shipment_chat_message, create_inquiry_chat_messagePosts a message to the chat of a shipment or an inquiry, as you
create_shipment_customs_messageReplies to the shipment's customs agent, once the customs conversation holds a message
mark_shipment_chat_read, mark_inquiry_chat_read, mark_shipment_customs_readMarks a conversation read up to a message, which clears your unread badge for it

These do what the matching calls of the API do, with the same rules: a cargo-ready date cannot move once the cargo has been picked up, and an inquiry whose quote has been accepted can only have its description changed. An assistant is told to change something only when you asked for it in the conversation. Sending the same change again changes nothing more, and an identical new inquiry within ten minutes returns the first one instead of raising a second.

A change it makes to a shipment is recorded under your name in the shipment's history, with an AI label next to it, so you and your colleagues can tell it from your own changes.

A message it posts is sent as you, with the same notifications as a message you write in the app, and it shows as your own: it carries no AI label. Asking it to post twice posts twice.

Booking, cancelling and deleting

These take two steps, so nothing happens until you have seen it and said yes.

ToolsWhat they do
prepare_booking, confirm_bookingBook a price or quote, with up to two preferred sailings
prepare_cancel_inquiry, confirm_cancel_inquiryCancel an inquiry
prepare_delete_inquiry, confirm_delete_inquiryDelete an inquiry

The prepare step changes nothing. It shows what would happen: for a booking the route, the price, the carrier and the sailings; for an inquiry its reference, route and status. The assistant shows you that and confirms only once you agree in the conversation. A confirmation is for you alone and lasts ten minutes; after that the assistant prepares it again. It books or changes exactly what it showed you:

  • If a quote's price or carrier has changed since, nothing is booked, and the assistant prepares it again so you see the new price.
  • Confirming twice within the ten minutes does it once: the second time answers with the same result. After that the confirmation has expired, and preparing again shows that the quote is booked or the inquiry already changed.

A booking starts your shipment with our forwarding agents, so it cannot be cancelled through an assistant or the API. To cancel a booking, contact Cargoplot. An inquiry with a booked quote cannot be cancelled or deleted for the same reason.

Switching changes off

Each user decides for themselves, in the Cargoplot app under Profile → API/MCP access, with two switches, both on by default:

  • Let AI assistants make changes for me covers every change above, including cancelling and deleting an inquiry.
  • Let AI assistants book quotes for me covers booking. A booking is a change as well, so it also needs the first switch on.

Switched off, the assistant can still read everything above, but the tools it covers are refused, with a message saying you switched them off, and it tells you so. Switch them on again there at any time.

The tab appears when API access is enabled for you. If you cannot see it, ask Cargoplot.

Cargoplot can also block all assistants of an organization, for reading as well as for changing, whatever its users chose. They are then refused with a message to contact Cargoplot.

Limits

An assistant's reads count against your rate limit, the same one your access tokens share. A long conversation that looks through many shipments can reach it; the assistant is told when to try again. Calls to the quote endpoints count against the separate quote allowance instead: listing an inquiry's quotes, reading a quote's details or its sailings.

Changes made through an assistant, bookings included, spend an allowance of their own, ahead of the others: 10 per minute per user. Your access tokens do not spend it, and an assistant's changes do not spend the write allowance of your tokens. Past it the assistant is told to wait and try again. The figure is published as assistant_write_rate_limit in /api-info.json.

Preparing a booking reads the quote, so it counts against the quote allowance, and so does confirming it, which reads the quote again to check its price.

Disconnecting

Remove the connector in your assistant. Its sign-in stops working within the hour, when the access it holds expires, and connecting again asks you to sign in and approve it anew.

Your assistant's provider sees what the tools return, as it sees anything else you share in a conversation. Connect only an assistant your company allows for its shipping data.