- Who can: any member of a brand connects an assistant by signing in. The API tab with the API key shows only to users with the “Manage API tokens” permission.
- Where: MCP & API in the left menu
What it is
MCP is the way an AI assistant connects to Cargofy. You add Cargofy to Claude, ChatGPT, Gemini or another assistant, sign in, and the assistant works in your account: finds shipments, creates tasks, updates records and runs actions of your integrations. You talk to it in plain language: “Show our tenders in Matching” or “Create a task to call the consignee”.
The assistant acts as you, in one brand. Every change it makes is saved under your name.
Server URL
Every assistant connects to the same address:
https://api.cargofy.com/mcpYou also find it in Cargofy: MCP & API › MCP › “MCP server URL”, with a copy button next to it.
Two ways to sign in
- Sign in with Cargofy. The assistant opens Cargofy, you see “Connect an app” and click Allow. Use it for Claude, ChatGPT, Gemini, Perplexity and other assistants. You see this screen every time you connect an app, and you can revoke the app at any time.
- API key. You copy the key from MCP & API › API and give it to the tool as a Bearer token. Use it for scripts and tools that cannot open a browser sign-in. The same key also works for the Cargofy API, so keep it like a password.
Which brand the assistant works in
- Signed in with Cargofy: your active brand at the moment of each request. “Connect an app” shows the brand that is active now. When your active brand changes, the assistant works in the new brand from its next request.
- API key: the brand that was active when you generated the key. A change of your active brand does not move the key.
What it can do
- Run your tenders. Create shipment drafts with route, cargo and auction rules, add the bids carriers give you and close bidding. See Freight Procurement.
- Build your carrier network. Add or invite carriers without duplicates. See Carrier Network.
- Keep your fleet current. Add and link trucks, trailers and drivers, and follow your trips. See Fleets.
- Work with your records. Find, read, create, update and delete records of your data models, and export any list to a file.
- Import locations. Load up to 1,000 warehouses and addresses from a table in one request. See Locations.
- See the load board. List the loads on LoadHub, bid on a tender and withdraw the bid. See LoadHub.
- Manage tasks. Create, update, assign and comment on tasks, read and add attachments. A task in “To do” assigned to a Digital Worker starts that worker right away. See Tasks and Digital Workers.
- Keep facts in memory. Save a fact for you or the whole account, find it by meaning and forget it. See Memory.
- Send an email from Cargofy. The Cargofy email action can also attach an exported list.
- Read your account setup. See workflows, Digital Workers, products, business flows, knowledge bases and integrations.
The full list is in Tools.
Limits
- Your role decides what the assistant can do with records. The assistant sees every record tool in its list, and an action your role does not allow fails. Integration actions are open to every member; some sending actions also need a send permission in your role.
- Some actions are open to every member of the brand, whatever the role: tasks, the carrier list, the load board, memory and sending an email. Saving a fact for the whole account needs the “Manage account knowledge” permission.
- An app signed in with Cargofy asks you to sign in again after 30 days without use.
- An API key does not expire. It stops working when you click Delete on the API tab, when you leave the brand or when your access is blocked.
- Cargofy takes up to 300 requests per minute with one key or one sign-in session.
- In the activity log, an action made over MCP carries the app’s name, for example “via Claude”, or “via api-key” for an API key.
Next steps
What happens behind one request.
What the assistant does in each product, starting with tenders.
Claude, ChatGPT, Gemini, Perplexity, agent platforms and developer tools.
Every action the assistant can take and what it needs.
Sign-in problems, brands, permissions and revoking access.
AI workers that run inside Cargofy by your instructions.