{
  "schema_version": "2025-11-05",
  "name": "TrackLogy",
  "version": "1.0.0",
  "description": "TrackLogy shipment tracking platform exposed as MCP tools. Track shipments across 900+ global carriers, detect carriers from tracking numbers, and list supported carrier metadata.",
  "contact": {
    "email": "info@tracklogy.com",
    "url": "https://tracklogy.com/contact"
  },
  "documentation": "https://tracklogy.com/developers/",
  "legal": {
    "privacy": "https://tracklogy.com/legal/privacy/",
    "terms": "https://tracklogy.com/legal/terms/"
  },
  "transport": [
    {
      "type": "http",
      "url": "https://api.tracklogy.com/mcp"
    }
  ],
  "auth": {
    "type": "api_key",
    "in": "header",
    "name": "X-API-Key",
    "description": "TrackLogy API key. Generate one at https://my.tracklogy.com → Settings → API Keys."
  },
  "tools": [
    {
      "name": "track_shipment",
      "description": "Retrieve current status and full event history for a shipment by tracking number.",
      "inputSchema": {
        "type": "object",
        "required": ["tracking_number", "store_name"],
        "properties": {
          "tracking_number": { "type": "string", "description": "The carrier tracking number." },
          "store_name": { "type": "string", "description": "Name of the connected TrackLogy store." }
        }
      }
    },
    {
      "name": "create_shipment",
      "description": "Add a new shipment for continuous tracking. TrackLogy auto-detects the carrier if not specified.",
      "inputSchema": {
        "type": "object",
        "required": ["tracking_number", "store_name"],
        "properties": {
          "tracking_number": { "type": "string" },
          "store_name": { "type": "string" },
          "tracking_provider": { "type": "string", "description": "Carrier slug (e.g. ups, fedex). Optional — auto-detected if omitted." },
          "customer_email": { "type": "string", "format": "email" },
          "order_id": { "type": "string" }
        }
      }
    },
    {
      "name": "detect_carrier",
      "description": "Identify which carrier a tracking number belongs to using pattern matching. No authentication required.",
      "inputSchema": {
        "type": "object",
        "required": ["tracking_number"],
        "properties": {
          "tracking_number": { "type": "string" }
        }
      }
    },
    {
      "name": "list_carriers",
      "description": "List all carriers supported by TrackLogy, optionally filtered by name or slug.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "q": { "type": "string", "description": "Search by carrier name or slug." },
          "limit": { "type": "integer", "default": 50, "maximum": 200 }
        }
      }
    },
    {
      "name": "list_shipments",
      "description": "Return a paginated list of all tracked shipments for a store.",
      "inputSchema": {
        "type": "object",
        "required": ["store_name"],
        "properties": {
          "store_name": { "type": "string" },
          "page": { "type": "integer", "default": 1 },
          "limit": { "type": "integer", "default": 50, "maximum": 100 }
        }
      }
    }
  ]
}