{
  "protocolVersion": "0.3.0",
  "name": "AwardSecrets",
  "description": "Award-travel intelligence: an AI-augmented data set derived from GDS inventory and lived award-travel experience, checked multiple times per day. Answers whether a specific flight has seats bookable with points or miles, and which loyalty programme books them most cheaply. Operated by MetroSpaces LLC, an ARC-accredited travel entity (VTC #45616745)",
  "url": "https://awardsecrets.com/mcp",
  "preferredTransport": "JSONRPC",
  "version": "1.0.0",
  "documentationUrl": "https://awardsecrets.com/api.html",
  "iconUrl": "https://awardsecrets.com/favicon.png",
  "provider": {
    "organization": "MetroSpaces LLC",
    "url": "https://awardsecrets.com"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "award_availability_search",
      "name": "Award availability search",
      "description": "Query the AwardSecrets data set for award seats on a given carrier, route, date and cabin. Returns availability facts only: flight number, operating and marketing carrier, schedule, aircraft, cabin, verified seat count and verification timestamp. Seat counts we cannot verify are filtered out rather than shown. No fare codes, no pricing, no PNR data, and no booking capability.",
      "tags": [
        "travel",
        "flights",
        "award-travel",
        "loyalty",
        "miles",
        "availability",
        "gds"
      ],
      "examples": [
        "Is there business class award space from Hong Kong to New York on Cathay Pacific in March?",
        "Which dates in February have Delta One award seats from Atlanta to Paris?",
        "Find business award availability from the US east coast to Athens in mid-July."
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    },
    {
      "id": "award_pricing",
      "name": "Least-cost award pricing",
      "description": "Given a route and cabin, rank the loyalty programmes that can book it by points cost from published award charts, with credit-card transfer paths and ratios, and flag programmes known to add high carrier surcharges. Distinguishes programmes that still publish fixed award charts from those that have moved to dynamic pricing. Derived from public programme information; independent of any GDS feed.",
      "tags": [
        "travel",
        "loyalty",
        "points",
        "transfer-partners",
        "award-charts",
        "pricing"
      ],
      "examples": [
        "What is the cheapest way to book Cathay Pacific business class from Hong Kong to New York?",
        "Which of my Chase transfer partners can book ANA First, and at what rate?"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/plain",
        "application/json"
      ]
    }
  ],
  "securitySchemes": {
    "apiKey": {
      "type": "apiKey",
      "in": "header",
      "name": "X-API-Key",
      "description": "Comes with an AwardSecrets API membership, started online at https://awardsecrets.com/api.html#pricing (Sandbox or Developer; Enterprise by arrangement). Each plan has a monthly query allowance; no per-query charges. Requests without a valid key receive 401 with a WWW-Authenticate header pointing at the protected-resource metadata."
    }
  },
  "security": [
    {
      "apiKey": []
    }
  ],
  "additionalInterfaces": [
    {
      "url": "https://awardsecrets.com/mcp",
      "transport": "JSONRPC",
      "description": "Model Context Protocol over Streamable HTTP. Authorisation metadata at /.well-known/oauth-protected-resource per RFC 9728."
    },
    {
      "url": "https://awardsecrets.com/api.php",
      "transport": "HTTP+JSON",
      "description": "REST API. Schema at https://awardsecrets.com/openapi.json"
    }
  ],
  "x_access": {
    "provisioning": "self-serve-membership",
    "plans": [
      {
        "name": "Sandbox",
        "price_usd_month": 49,
        "monthly_queries": 1000,
        "award_ai_users": 1
      },
      {
        "name": "Developer",
        "price_usd_month": 499,
        "monthly_queries": 10000,
        "award_ai_users": 1
      },
      {
        "name": "Enterprise",
        "price": "custom",
        "note": "tailored to specific business needs"
      }
    ],
    "start": "https://awardsecrets.com/api.html#pricing",
    "contact": "api@awardsecrets.com",
    "note": "Membership to the AwardSecrets data set; no per-query charges. We expose our tools over MCP and REST; we do not currently implement A2A task delegation, so a2a/message and task lifecycle calls will not be served."
  },
  "x_usage_terms": {
    "termsUrl": "https://awardsecrets.com/terms.html",
    "llmsTxt": "https://awardsecrets.com/llms.txt",
    "attribution": "On Sandbox and Developer plans, attribute availability data shown publicly to AwardSecrets and carry the verification timestamp shown alongside each seat count. White-label on Enterprise by agreement.",
    "cacheMaxHours": 24,
    "prohibited": [
      "resale-as-dataset",
      "competing-dataset-or-model",
      "bulk-extraction",
      "presenting-cached-data-as-current"
    ]
  }
}