Skip to main content

MCP Server Setup

The Aphelios MCP server exposes logistics tools over HTTP using the Model Context Protocol. Any MCP-compatible client (Claude Desktop, Cursor, custom agents) can connect and call tools to query shipment data.

Prerequisites​

  • An Aphelios account with an API key (aph_live_*)
  • An MCP-compatible client

Server URL​

https://api.aphelios.ai/v1/mcp

The server uses stateless HTTP transport (SSE). No persistent connections or WebSocket upgrades required.

Quick test​

Verify your connection works by listing available tools:

curl -X POST https://api.aphelios.ai/v1/mcp \
  -H "Authorization: Bearer aph_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

You should get back a response listing list_shipments_summary and get_shipment_details.

Available tools​

ToolPurpose
list_shipments_summarySearch and filter shipments with pagination
get_shipment_detailsFetch full details by tracking number, BOL, AWB, or container

See Tools Reference for full parameter documentation.

Client configuration​

Ready-to-copy configs for popular clients: