MCP Setup and usage
Connect ChatGPT, Claude, Cursor, and other MCP clients to OpenTrack to look up shipments, start tracking, and manage webhooks.
OpenTrack MCP
Connect ChatGPT, Claude, Cursor, or another AI client to OpenTrack so it can look up shipments, start tracking, and manage webhooks for you.
Server URL: https://api.opentrack.co/mcp
If you are writing code against OpenTrack yourself, use the REST API instead (see Getting Started).
Authentication
Sign in through your browser when you connect. There is no API key to paste.
Tools run with the permissions of the account you sign in with, so an assistant sees the same shipments you would see in the dashboard.
Connect Claude
- Open OpenTrack in Claude's connector directory.
- Click Connect and sign in to OpenTrack.
- Start a new chat, enable OpenTrack, and ask “Look up container [add your container number here]”.
Connect ChatGPT
Custom MCP connectors need a paid plan with developer mode turned on (Settings → Apps → Advanced settings). On Business, Enterprise, and Edu plans an admin has to enable developer mode and publish the connector before members can use it.
- Open Settings → Connectors and create a connector.
- Name it OpenTrack and set the URL to
https://api.opentrack.co/mcp. - Sign in to OpenTrack in the browser.
- Start a new chat, enable the OpenTrack connector, and ask “Look up container [your container number here]”.
If you are adding OpenTrack from the ChatGPT app directory, click Connect and sign in the same way.
Connect Cursor
Add an entry to .cursor/mcp.json (or Cursor Settings → MCP):
{
"mcpServers": {
"opentrack": {
"url": "https://api.opentrack.co/mcp"
}
}
}Restart Cursor, then sign in when prompted.
Other clients
Any client that supports Streamable HTTP MCP and OAuth can connect to the same URL, including MCP Inspector.
What to ask
Try these once the connector is on:
- “Look up container [your container number here].”
- “What is the route for that container?”
- “List containers with an ETA at Los Angeles in the next 7 days.”
- “Start tracking container [container number] on master bill [MBL number].”
- “List my webhooks.”
When a port or carrier name is ambiguous, the assistant asks you to confirm which one you meant. Tracking coverage matches the supported carriers and terminals list.
Tools
Read-only:
| Tool | What it does |
|---|---|
getContainer | Container details: status, ETAs, last free days, holds, demurrage, history |
getContainers | Search and list containers |
getContainerRoute | Journey legs and itinerary for a container |
getMbl | Master bill and its containers |
getMblList | Search master bills |
getFilterSchema, getFilterRules, listFilterOptions | Help the assistant build correct filters and resolve port, carrier, and terminal names |
listWebhooks | Webhooks on the account |
listWebhookEvents | Playback of delivered webhook events |
Makes changes:
| Tool | What it does |
|---|---|
trackContainer | Start tracking a container |
trackMasterBill | Start tracking every container on a master bill or booking |
registerWebhook | Create a webhook |
updateWebhook | Change an existing webhook |
unregisterWebhook | Delete a webhook. This cannot be undone |
Writes require an account role that allows the same action in OpenTrack. See Webhooks for how webhook delivery works.
Limits and support
Requests are rate limited per client IP (5 per second, 120 per minute). Normal conversation will not reach this; a scripted agent might.
- Support: [email protected]
- Privacy policy · Terms of service
Updated about 1 month ago
