MCP docs & quickstart

Copy-paste TrackingMCP configurations for every major MCP client, plus curl, Node, and Python examples to get live freight data into your agent in minutes.

• Claude Desktop and Claude custom connectors.
• Cursor, Windsurf, VS Code, and Cline.
• Authentication with a single API key.
• Example tool calls and a REST fallback.

Try it in 60 seconds — no signup

The public demo key tmcp_demo_public returns synthetic data so you (or your agent) can verify the connection before creating a free key. Endpoint: https://mcp.trackingmcp.com/mcp (Streamable HTTP).

Claude Code

claude mcp add container-tracking --transport http https://mcp.trackingmcp.com/mcp --header "Authorization: Bearer tmcp_demo_public"

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "container-tracking": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.trackingmcp.com/mcp",
               "--header", "Authorization: Bearer tmcp_demo_public"]
    }
  }
}

Requires Node (npx). No Node installed? Use "command": "bunx" with args ["mcp-remote", …] — verified working.

Cursor / Windsurf / VS Code — .cursor/mcp.json

{
  "mcpServers": {
    "container-tracking": {
      "url": "https://mcp.trackingmcp.com/mcp",
      "headers": { "Authorization": "Bearer tmcp_demo_public" }
    }
  }
}

Plain curl

curl -X POST https://mcp.trackingmcp.com/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -H "Authorization: Bearer tmcp_demo_public" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Six tools: get_shipment_summary, get_container_detail, get_vessel_position, get_demurrage_report, get_port_congestion, add_container. For live data, swap the demo key for a free key from your dashboard settings — the free tier includes 100 MCP calls/month, no card. Registry: io.github.lxxmng/container-tracking.