PopMCP
route_cancel_Cancel a shipment in Route, or take some items out of it.
Route MCP server for your AI
Sync an order with Route, add each package as it ships, correct or cancel either one, look up a package's status, and see what protection would cost for a cart.
PopMCPRoute
Where is the package with this tracking number on order 11003271211
Supported Route tools
Every order, shipment and quote call Route publishes for merchants, plus a lookup for the courier code each shipment needs.
12 tools in the full catalog: 4 read and 8 write. 10 load by default, and the rest are found with tool search.
route_create_Add a package to an order once it has a carrier tracking number.
route_find_Find the courier_id Route uses for a courier, before route_create_shipment or route_update_shipment.
route_get_Read one package's tracking status from Route.
route_track_Check up to 10 packages in one call.
route_update_Change what is in a package, or its courier.
route_cancel_Tell Route an order was canceled, or that protection was removed from it.
route_create_Send a store order to Route so it can be protected and claims can be filed against it.
route_update_Replace an order Route already has, after the store's order changed.
route_get_Price Route protection for a cart before an order exists.
route_create_The older way to send an order to Route.
route_update_Change an order Route already has, using the older version of the call.
Connect Route to Claude, ChatGPT and Claude Code
Credentials off one Route screen, then an endpoint your client signs into. Nothing to deploy, and nothing to install.
Paste your Secret API token, from the Admin section of the Route dashboard or the email Route sent when your account was made. The token belongs to one merchant account, so there is nothing else to choose. Use the Test-Secret token to try things first.
Secret API token
••••••••••••3f7aMerchant ID
merch_...ConnectionVerified
With a live token, creating an order makes a real order in Route, and canceling one changes what Route protects. Route has no read-only token, so use a read-only connection in PopMCP to limit the AI to tracking and quotes.
Reach Route
Reach other connectors
Teammates on read-only
Drop the PopMCP URL into Claude, ChatGPT, Claude Code, Codex or any other supported client. It signs in through PopMCP with OAuth, so your Route credential never leaves the server.
app.popmcp.com/mcp
Claude wants to connectApproveAsk for something harmless before the agent changes anything. Writes run as soon as it calls them, so confirm it reads the right account first.
Where is the package with this tracking number on order 11003271211
route_get_shipmentok
Then just ask for the work
“Where is the package with this tracking number on order 11003271211”
- get_shipment
“Price protection for this cart, send the order to Route, then add its package and tracking number”
- get_quote
- create_order
- create_shipment
“Two items from order 2210 moved to a second box, so update the first shipment and add the new one”
- update_shipment
- create_shipment
“Order 1042 was canceled, so cancel its shipment and the order in Route”
- cancel_shipment
- cancel_order
Use Route from the assistant you already open
One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.
Claude DesktopCustom connector
Add the PopMCP URL under Customize → Connectors and the tools appear in every chat.
Claude WebCustom connector
The same endpoint, registered in the browser. Nothing to install on the machine you are working from.
ChatGPTCustom connector
Register PopMCP as a custom connector, then let ChatGPT read and update the account.
CodexDesktop & CLI
Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.
OpenCodeCoding agent
Register the remote MCP server in OpenCode's config for terminal-first and scripted agent runs.
ZCodeDesktop app
Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.
Explore other MCP servers
Every one of them runs on the same hosted endpoint, with the same controls.
FAQ
Route MCP server questions
What teams ask before putting Route behind an AI client.
What do I need to connect Route?
One token. Copy the Secret API token from the Admin section of the Route dashboard, or from the email Route sent when your account was made, and paste it into PopMCP. There is no app to register and no redirect URL. The Test-Secret token, which starts with test-, works too, and Route flags the orders it creates as test orders.
How many Route operations can the agent call?
10 operations, which is every order, shipment and quote call Route publishes: 8 write and 2 read. 8 load into your AI client by default, along with two helpers: one checks several packages at once, and one finds the courier code a shipment needs. The two older order calls stay searchable.
Can the agent list my orders or read my claims?
No. Route publishes no call to list orders or shipments, read an order, or read or file a claim, so no connector can offer them. The agent reads one package at a time, and it needs the tracking number and your store's order number to do it. Use the Route dashboard for claims.
Does the agent change real orders?
It can. With a live token, create_order makes a real order in Route, protected when insurance_selected is true, and cancel_order tells Route an order was canceled or that protection was removed. To try things first, connect the Test-Secret token. To block changes entirely, use a read-only connection, which leaves tracking and quotes.
Does getting a quote place an order?
No. get_quote prices protection for a cart and creates no order. It needs your merchant ID, which starts with merch_ and is shown in the Route dashboard. You can save it under More options when you connect, so the agent does not have to ask.
Can the agent use Route's claim and return webhooks?
Not through this connector. Route describes webhooks for refund, replacement and return events, but publishes no call to set one up, so there is nothing for the agent to subscribe to. Ask Route support about setting them up for your store.
Do I have to run or host the Route MCP server myself?
No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.
Which AI clients can use this MCP server?
Any client that supports a remote Streamable HTTP MCP server: Claude Desktop, Claude Web, Claude Code, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.
How do I connect Route to Claude Code?
Connect Route in PopMCP first, then run claude mcp add --transport http popmcp https://app.popmcp.com/mcp in a terminal. Inside Claude Code, run /mcp and sign in to PopMCP in the browser window it opens, ticking Route on the consent screen. The Route tools are then available in that session, and no Route credential is stored on your machine.
Why do only 10 of the 12 tools load by default?
Loading 12 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 10-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. Every tool stays searchable, and on Scale the owner can load the full catalog for a teammate's connection.
What is the difference between a tool and a trigger?
A tool is something your AI calls, and there are 12 here. A trigger is an event PopMCP watches for on its own. Route has no triggers yet, so everything on this page happens when your AI calls a tool.
Connect Route to your AI in minutes
Launch a hosted MCP endpoint for Route, keep tool access under control, and start testing real workflow prompts right away.