Skip to content
Back to AwardSecrets

Card snapshot

awardsecrets.com · 2026-09-11 16:23:15 UTC · 3bd57b2a631beb0d489f6dcd3072534844fe742bc6c3652ef2c7bc8e400824d2

This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.

{
  "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"
    ]
  }
}