protogrid

Search / com.awardsecrets/award-availability

AwardSecrets Award Availability

R1· needs a key

Award seat availability from a contracted GDS. One route, one airline, one date.

v1.0.0 · active · website · descriptor JSON · versions

An agent can connect on its own if it already holds AWARD_AVAILABILITY_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality76good
Trust80of 100
Uptime, 30 days100%
Latency p50513 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "award-availability": {
      "type": "http",
      "url": "https://awardsecrets.com/mcp",
      "headers": {
        "Authorization": "Bearer ${AWARD_AVAILABILITY_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http award-availability https://awardsecrets.com/mcp --header "Authorization: Bearer ${AWARD_AVAILABILITY_TOKEN}"
[mcp_servers.award-availability]
url = "https://awardsecrets.com/mcp"
bearer_token_env_var = "AWARD_AVAILABILITY_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "award-availability": {
      "type": "remote",
      "url": "https://awardsecrets.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:AWARD_AVAILABILITY_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "award-availability": {
      "type": "http",
      "url": "https://awardsecrets.com/mcp",
      "headers": {
        "Authorization": "Bearer ${AWARD_AVAILABILITY_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=award-availability&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXdhcmRzZWNyZXRzLmNvbS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtBV0FSRF9BVkFJTEFCSUxJVFlfVE9LRU59In19"
}
{
  "servers": {
    "award-availability": {
      "type": "http",
      "url": "https://awardsecrets.com/mcp",
      "headers": {
        "Authorization": "Bearer ${AWARD_AVAILABILITY_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "award-availability": {
      "httpUrl": "https://awardsecrets.com/mcp",
      "headers": {
        "Authorization": "Bearer ${AWARD_AVAILABILITY_TOKEN}"
      }
    }
  }
}
extensions:
  "award-availability":
    enabled: true
    name: "award-availability"
    type: streamable_http
    uri: "https://awardsecrets.com/mcp"
    headers:
      "Authorization": "Bearer ${AWARD_AVAILABILITY_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${AWARD_AVAILABILITY_TOKEN}. The registry never accepts secret values.

Quality 76 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene64 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • warn
    tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search_award_availability (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
  • pass
    tools.token_costabout 696 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changes1 tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

1 tools, about 696 tokens to load them all · tool set b00f7b9c590a · tools last changed 2026-10-09 · checked 2026-10-20 09:31 UTC

Tool changes

  • search_award_availabilitychangeddescription
    before

    Look up award (points/miles) seat availability for ONE specific flight route on ONE specific date with ONE specific airline, sourced from a contracted GDS rather than scraped. Returns the flights found with cabin and seat count. IMPORTANT — this tool is strictly literal. Every argument takes a single concrete value: • origin / destination: exactly one 3-letter IATA airport code each. Not a city, not a list, not a region. • airline: exactly one 2-letter IATA carrier code (e.g. VS, CX, NH). Not an alliance and not a loyalty programme. • date: exactly one date, YYYY-MM-DD. Not a range and not a month. To cover several airports, airlines or dates, CALL THIS TOOL ONCE PER COMBINATION and combine the results yourself. Award space is scarce and volatile, so an empty result for one date says nothing about another — checking several dates is normal and expected. Interpreting the result: • seats is an availability indicator, not a guaranteed bookable count, and not a reservation. Low counts are the more precise signal; treat higher ones as less certain. Do not present any count as a firm number of seats a user can book. • cabin is one of business, first, economy or premium_economy. • An empty result means no availability was surfaced for that exact combination at that moment; it is not proof that the route never has space. • Availability changes fast. Treat every result as a point-in-time observation, not a reservation. If the call is declined for want of an API key, say so plainly and point the user at https://awardsecrets.com/api.html — access is in limited release and keys are issued individually. Do not invent availability, and do not substitute a guess for a result you could not retrieve.

    after · 83% of words in common

    Query the AwardSecrets data set (award-travel intelligence, AI-augmented and derived from GDS inventory and lived award-travel experience; not scraped) for award (points/miles) seat availability on ONE route, ONE date and ONE airline. Returns the flights found with cabin and seat count. IMPORTANT — this tool is strictly literal. Every argument takes a single concrete value: • origin / destination: exactly one 3-letter IATA airport code each. Not a city, not a list, not a region. • airline: exactly one 2-letter IATA carrier code (e.g. VS, CX, NH). Not an alliance and not a loyalty programme. • date: exactly one date, YYYY-MM-DD. Not a range and not a month. To cover several airports, airlines or dates, CALL THIS TOOL ONCE PER COMBINATION and combine the results yourself. Award space is scarce and volatile, so an empty result for one date says nothing about another — checking several dates is normal and expected. Interpreting the result: • seats is an availability indicator, not a guaranteed bookable count, and not a reservation. Low counts are the more precise signal; treat higher ones as less certain. Do not present any count as a firm number of seats a user can book. • cabin is one of business, first, economy or premium_economy. • An empty result means no availability was surfaced for that exact combination at that moment; it is not proof that the route never has space. • Availability changes fast. Treat every result as a point-in-time observation, not a reservation. If the call is declined for want of an API key, say so plainly and point the user at https://awardsecrets.com/api.html — access comes with an AwardSecrets API membership (monthly plans). If it is declined because the monthly query allowance is reached, say when it resets. Do not invent availability, and do not substitute a guess for a result you could not retrieve.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 80 / 100

no-repository
provenance55
liveness100
freshness85
hygiene80

+dns-namespace +website +reachable +uptime-100% ~updated-69d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://awardsecrets.com/mcp streamable-httpapi_key ${AWARD_AVAILABILITY_TOKEN}yes100%513 ms2025-06-182026-10-20

Tools (1)

search_award_availabilityQuery the AwardSecrets data set (award-travel intelligence, AI-augmented and derived from GDS inventory and lived award-travel experience; not scraped) for award (points/miles) seat availability on ONE route, ONE date and ONE airline. Returns the flights found with cabin and seat count. IMPORTANT — this tool is strictly literal. Every argument takes a single concrete value: • origin / destination: exactly one 3-letter IATA airport code each. Not a city, not a list, not a region. • airline: exactly one 2-letter IATA carrier code (e.g. VS, CX, NH). Not an alliance and not a loyalty programme. • date: exactly one date, YYYY-MM-DD. Not a range and not a month. To cover several airports, airlines or dates, CALL THIS TOOL ONCE PER COMBINATION and combine the results yourself. Award space is scarce and volatile, so an empty result for one date says nothing about another — checking several dates is normal and expected. Interpreting the result: • seats is an availability indicator, not a guaranteed bookable count, and not a reservation. Low counts are the more precise signal; treat higher ones as less certain. Do not present any count as a firm number of seats a user can book. • cabin is one of business, first, economy or premium_economy. • An empty result means no availability was surfaced for that exact combination at that moment; it is not proof that the route never has space. • Availability changes fast. Treat every result as a point-in-time observation, not a reservation. If the call is declined for want of an API key, say so plainly and point the user at https://awardsecrets.com/api.html — access comes with an AwardSecrets API membership (monthly plans). If it is declined because the monthly query allowance is reached, say when it resets. Do not invent availability, and do not substitute a guess for a result you could not retrieve.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "com.awardsecrets/award-availability",
  "title": "AwardSecrets Award Availability",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://awardsecrets.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer ak_live_... API access is in limited release; request access at [email protected]"
        }
      ]
    }
  ],
  "version": "1.0.0",
  "websiteUrl": "https://awardsecrets.com/api.html",
  "description": "Award seat availability from a contracted GDS. One route, one airline, one date."
}