The Track123 API Model Context Protocol (MCP) server enables AI-powered code editors like Cursor and Windsurf, plus general-purpose tools like Claude Desktop, to interact directly with your Track123 API and documentation.
What is MCP?
Model Context Protocol (MCP) is an open standard that allows AI applications to securely access external data sources and tools. The Track123 API MCP server provides AI agents with:
- Direct API access to Track123 API functionality
- Documentation search capabilities
- Real-time tracking data for any shipment
- Code generation assistance for Track123 API integrations
Track123 API MCP Server Setup
Track123 API hosts a remote MCP server at https://docs.track123.com/mcp. Configure your AI development tools to connect to this server. If your APIs require authentication, you can pass in headers via query parameters or however headers are configured in your MCP client.
When configuring the headers, please ensure you replace the <YOUR_TRACK123_API_SECRET> placeholder with your actual Track123 API secret key, making sure to remove the angle brackets (< and >) entirely.
Add to~/.cursor/mcp.json:
{
"mcpServers": {
"track123-api": {
"type": "http",
"url": "https://docs.track123.com/mcp",
"headers": {
"Track123-Api-Secret": "<YOUR_TRACK123_API_SECRET>"
}
}
}
} Add toclaude_desktop_config.json:
{
"mcpServers": {
"track123-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://docs.track123.com/mcp",
"--header",
"Track123-Api-Secret:${TRACK123_API_SECRET}",
"--transport",
"http-first"
],
"env": {
"TRACK123_API_SECRET": "<YOUR_TRACK123_API_SECRET>"
}
}
}
}Add to~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"track123-api": {
"serverUrl": "https://docs.track123.com/mcp",
"headers": {
"Track123-Api-Secret": "<YOUR_TRACK123_API_SECRET>"
}
}
}
}Testing Your MCP Setup
Once configured, you can test your MCP server connection:
- Open your AI editor (Cursor, Windsurf, etc.)
- Start a new chat with the AI assistant
- Ask about Track123 API - try questions like:
- "Show me tracking status for a FedEx shipment **********"
The AI should now have access to your Track123 API account data and documentation through the MCP server.