AwardSecrets Award Availability
Award seat availability from a contracted GDS. One route, one airline, one date.
Should I use this
Quality & Safety
Findings (2)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainin search_award_availability
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"award-availability": {
"url": "https://awardsecrets.com/mcp"
}
}
}Remote endpoints
https://awardsecrets.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (1)
🟢search_award_availability(origin, destination, airline, date, cabin, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"origin": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Departure airport, one 3-letter IATA code (e.g. JFK)."
},
"destination": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Arrival airport, one 3-letter IATA code (e.g. LHR)."
},
"airline": {
"type": "string",
"pattern": "^[A-Za-z0-9]{2}$",
"description": "One 2-letter IATA airline code (e.g. VS, CX, NH)."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "One departure date, YYYY-MM-DD."
},
"cabin": {
"type": "string",
"enum": [
"business",
"first",
"economy",
"premium_economy"
],
"default": "business",
"description": "Cabin to search. Defaults to business."
},
"passengers": {
"type": "integer",
"minimum": 1,
"maximum": 9,
"default": 1,
"description": "Number of seats required. Defaults to 1."
}
},
"required": [
"origin",
"destination",
"airline",
"date"
],
"additionalProperties": false
}Community
Evidence