MCP

MCP Server Configuration Guide

Connect your AI assistant to Superroute using the Model Context Protocol (MCP) for package tracking and more.

MCP track_package(tracking_number) Tool
RPC tools/list JSON-RPC 2.0
RPC tools/call JSON-RPC 2.0
Documentation

What is MCP?

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.

Quick Start

Public tools like package tracking work without any authentication. Add this configuration to your MCP client:

JSON
{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp"
    }
  }
}
Try it! After setup, ask your AI assistant: "Track package SR100012345"

Authenticated Access

To use tools that require user permissions, add your API Bearer token to the configuration:

JSON
{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

How to Get an API Token

Call the login endpoint with your credentials:

Bash
curl -X POST https://api.miliexpress.com/api/v1/user/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}'

The response will include your access token:

JSON Response
{
  "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.

Available Tools

The following tools are currently available on the MCP server:

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.

More tools will be added over time. Authenticated tools will only appear when a valid token is provided.

Client-Specific Setup

Select your AI client below for tailored setup instructions:

Claude Code

Claude Code reads MCP configuration from a .mcp.json file in your project root or home directory.

  1. Create a .mcp.json file in your project root (or ~/.claude/.mcp.json for global access).
  2. Add the following configuration:
.mcp.json
{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp"
    }
  }
}

To use authenticated tools, add the headers field:

.mcp.json (with authentication)
{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

Cursor

Cursor supports MCP servers via its built-in configuration.

  1. Create a .cursor/mcp.json file in your project root.
  2. Add the following configuration:
  3. Restart Cursor to load the new MCP server.
.cursor/mcp.json
{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp"
    }
  }
}

Windsurf

Windsurf uses a global MCP configuration file.

  1. Edit ~/.codeium/windsurf/mcp_config.json (create it if it does not exist).
  2. Add the following configuration:
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mili-express": {
      "serverUrl": "https://api.miliexpress.com/mcp"
    }
  }
}

ChatGPT

ChatGPT supports MCP connections for Plus, Pro, and Team users.

  1. Open ChatGPT and go to Settings.
  2. Navigate to "Connected apps" or "Tools" section.
  3. Add a new MCP server with the endpoint URL shown above.
ChatGPT MCP support may vary depending on your plan and region. Refer to OpenAI documentation for the latest instructions.

Technical Details