MCP
Connect your AI assistant to Superroute using the Model Context Protocol (MCP) for package tracking and more.
The Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude, Cursor, and ChatGPT to interact with external tools and services. It enables your AI to perform real actions — such as tracking a package — directly within the conversation.
By configuring the Superroute MCP server, your AI assistant gains access to logistics tools without leaving your workflow.
Public tools like package tracking work without any authentication. Add this configuration to your MCP client:
{
"mcpServers": {
"super-label": {
"type": "url",
"url": "https://api.superlabel.ca/mcp"
}
}
}
To use tools that require user permissions, add your API Bearer token to the configuration:
{
"mcpServers": {
"super-label": {
"type": "url",
"url": "https://api.superlabel.ca/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}
Call the login endpoint with your credentials:
curl -X POST https://api.superlabel.ca/api/v1/user/login \ -H "Content-Type: application/json" \ -d '{"email": "you@example.com", "password": "your-password"}'
The response will include your access token:
{
"access_token": "eyJ0eXAiOiJKV1Qi...",
"token_type": "Bearer",
"expires_at": "2026-02-20 00:00:00"
}
Use the access_token value in the Authorization header of your MCP configuration.
The following tools are currently available on the MCP server:
Direct REST wrappers — one MCP tool per endpoint.
| Tool | Authentication | Description |
|---|---|---|
track_package |
Public | Track a package by its tracking number. Returns delivery status, tracking events timeline, and proof of delivery if available. |
create_order |
Required | Create a delivery, pickup, or peer-to-peer order. |
get_orders |
Required | List orders with filtering and pagination. |
get_order_detail |
Required | Get the full details of a single order by ID. |
cancel_order |
Required | Cancel an order that has not yet been delivered. |
get_routes |
Required | List delivery routes with status and assigned drivers. |
get_operation_events |
Required | Get the full audit trail for one or more orders. |
get_shipping_methods |
Required | List enabled shipping carriers and their IDs. |
get_shipping_rate |
Required | Get a rate quote from a specific carrier (dry-run, no label). |
create_shipping_label |
Required | Book a shipment with a carrier and generate a label. |
search_address |
Required | Search and resolve addresses by free-text query. |
Multi-step business flows in a single MCP tool call. Replaces 3+ chained calls.
| Tool | Authentication | Description |
|---|---|---|
quote_and_ship |
Required | One call: rate across all carriers, pick the best one (strategy=cheapest|fastest), create the label, return tracking number. |
bulk_create_orders |
Required | Create up to 100 orders in a single call. Returns per-row success/failure summary; partial failures do not abort the batch. |
find_order |
Required | Fuzzy search across tracking number, external tracking, ref, recipient name, and phone in one query. |
reroute_to_address |
Required | Change an order's delivery address: cancels the original and recreates it with the new address. Returns both IDs. |
daily_digest |
Required | One-call summary of today's logistics: total orders, by status, exceptions, pending pickups. |
compare_all_carriers |
Required | Get rate quotes from every enabled carrier for the same shipment, sorted cheapest first. |
Read-only summaries and aggregates over the authenticated account's data.
| Tool | Authentication | Description |
|---|---|---|
get_orders_summary |
Required | Aggregate metrics over a window: counts by status, top carriers, on-time rate, exception count. |
get_account_credits |
Required | Get the customer's wallet balance. B2C accounts only — returns a clear error for client/business accounts billed via invoice. |
Select your AI client below for tailored setup instructions:
Claude Code reads MCP configuration from a .mcp.json file in your project root or home directory.
{
"mcpServers": {
"super-label": {
"type": "url",
"url": "https://api.superlabel.ca/mcp"
}
}
}
To use authenticated tools, add the headers field:
{
"mcpServers": {
"super-label": {
"type": "url",
"url": "https://api.superlabel.ca/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}
Cursor supports MCP servers via its built-in configuration.
{
"mcpServers": {
"super-label": {
"type": "url",
"url": "https://api.superlabel.ca/mcp"
}
}
}
Windsurf uses a global MCP configuration file.
{
"mcpServers": {
"super-label": {
"serverUrl": "https://api.superlabel.ca/mcp"
}
}
}
ChatGPT supports MCP connections for Plus, Pro, and Team users.
https://api.superlabel.ca/mcp