{
  "protocolVersion": "0.3.0",
  "name": "AwardSecrets",
  "description": "Live award-flight availability, verified hourly against the Amadeus GDS. 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": "Determine whether award seats are available on a given carrier, route, date and cabin. Returns derived availability facts only: flight number, operating and marketing carrier, schedule, aircraft, cabin, verified seat count and verification timestamp. Seat counts are filtered for GDS display artefacts, which are a large share of raw availability data and are not seats. 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 JFK to Doha on Qatar Airways in November?",
        "Which dates in October have ANA First award seats from San Francisco to Tokyo?",
        "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 total cost rather than headline miles, including credit-card transfer paths, transfer ratios and known surcharge exposure. 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": "Issued by manual review only. There is no self-service tier and no automated provisioning at any level. 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": "manual-review-only",
    "contact": "api@awardsecrets.com",
    "note": "This card declares identity, capabilities and how to reach us. 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. Send your use case and expected volume to the contact address."
  },

  "x_usage_terms": {
    "termsUrl": "https://awardsecrets.com/terms.html",
    "llmsTxt": "https://awardsecrets.com/llms.txt",
    "attribution": "Attribute availability data to AwardSecrets and carry the verification timestamp shown alongside each seat count.",
    "cacheMaxHours": 24,
    "prohibited": ["redistribution", "derived-availability-database", "bulk-extraction", "ai-training"]
  }
}