Skip to main content

​
My AI client won’t connect

Most connection failures fall into two buckets: Expired session or token
  • Symptom: you were connected before, but requests now fail with an authentication or 401 error.
  • Fix: your AI client should re-open the FreightPOP login popup automatically. If it doesn’t, remove the FreightPOP connector from your AI client settings and re-add it using the connector URL from your client setup guide.
Wrong connector URL
  • Symptom: the client shows “connector unreachable” or a 404 during setup.
  • Fix: the connector URL is https://tms-mcp.freightpop.com/mcp, including the /mcp path. Copy-paste it rather than typing it, and make sure no trailing slash or extra path was added.

​
My request was rejected

The server validates every input before making a call. Requests are rejected when required fields are missing or values are outside allowed ranges. Common examples: If your AI client shows a raw validation message, read it carefully. It names the field that failed. Correct that field and try again.

​
I think I imported a duplicate order

Order numbers must be unique. freightpop_import_orders rejects an order number that already exists rather than overwriting it, so you cannot end up with two conflicting versions of the same order. To confirm what actually happened, ask the AI client:
“Look up order number SO-1042 in FreightPOP.”
Or open the FreightPOP web app and search for the order number.

​
A shipment wouldn’t cancel

freightpop_cancel_shipment can fail when the carrier has already picked up the freight or the shipment is too far along to accept a cancellation. The response tells you the cancellation did not succeed rather than failing silently. Check the shipment in the FreightPOP web app, and contact the carrier directly if it has already moved.

​
The tool timed out

Occasionally a tool call fails with a timeout, usually because a downstream carrier or system was slow to respond.
  • The error comes back as a plain text message, for example: “FreightPop API error (503): the FreightPop service is temporarily unavailable. Please retry shortly.” There’s no separate retryable flag on the response; the message itself tells you whether retrying is worth it.
  • If the message suggests retrying, ask the AI client to try the same request again.
  • If it doesn’t, or the same tool keeps timing out, wait a minute and try again, or use the FreightPOP web app to complete the action.
  • For repeated timeouts on the same tool, contact support.

​
Rate limits

The MCP Server limits each user to 10 tool calls per 60 seconds. If you cross that limit, the tool returns:
“Rate limit exceeded. Please slow down and try again shortly.”
This shows up most often during multi-step workflows, for example quoting several lanes back to back. Wait a few seconds and retry; the limit resets on a rolling 60-second window.

​
Something else

If your issue isn’t covered here, contact support with:
  • The name of your AI client (Claude Desktop, Claude.ai, ChatGPT)
  • The prompt you used
  • The exact error message shown by the AI client
  • Approximate time of the request