Skip to content

Recipe · Flights API

Cheapest-date scan with Claude Code

On the MCP server the tool accepts a date RANGE and expands it internally: one call, not thirty. The agent gets a fare per day and answers with the cheapest date and how much picking it saves. Over REST, the same scan is a parallel burst of per-date requests, which the rate limits (150–500/min by tier) exist for; an Apify run takes one departure date, so the scan is one run per date.

Free tier on RapidAPI. No card to try.

Step 1 · Connect

Add the MCP server, or install the skills

The MCP servers have no ads: sign in with Google and the first 10 searches a day are free, then your own RapidAPI key. The eight MIT-licensed skills (cheapest dates, fare watch, trip planning, hotel search, rate-parity monitoring…) talk to the same API over MCP or plain REST with your key.

install
npx skills add mtnrabi/travel-agent-skills

Bring your own RapidAPI key: every request is billed to your own subscription, never ours.

Step 2 · Ask it

The prompt

Verbatim: paste it, or anything shaped like it. The agent maps it to the call below.

“What is the cheapest day to fly LIS to New York in June?”

Step 3 · Under the hood

What the skill calls

The skill calls the same API with your key. This is the call behind the answer, with real parameter names.

the call the skill makes
// search_oneway_flights
{
  "from_airport": "LIS",
  "to_airport": "JFK",
  "departure_date_from": "2027-06-01",
  "departure_date_to": "2027-06-30",
  "limit": 5
}

Step 4 · Read the response

Fields your logic reads

The response is flat JSON. These are the fields this recipe branches on, with what each one means.

departure_datestring (YYYY-MM-DD)

The date this fare applies to, the axis a date-range scan pivots on.

pricestring

The fare as Google Flights displays it: “$56”. The numeric twin price_as_number rides alongside for sorting and arithmetic.

price_range_in_relation_to_other_periods"low" | "typical" | "high" | null

Google’s verdict on the current fare against that band, the single field alerting, ranking, and “book now” logic branch on.

Questions, answered plainly

Is my key billed to me?
Yes. The skill uses your own RapidAPI key, so every call meters against your own subscription on RapidAPI. There is no FlightPowers account and no second bill.
Does this need a server of mine?
No. The skill runs inside Claude Code and calls the hosted API over the network. Nothing to deploy, nothing to keep warm.
What does it cost?
The Google Flights Live API's free tier is 50 requests/month with a hard cap: enough to verify your key works, not to evaluate. The PRO plan is $10/month for 2,500 requests, and every plan includes every endpoint. Budget one request per date scanned: a 30-day sweep meters as 30 requests.

Get live flight and hotel data

Live Google Flights and Booking.com data as clean JSON. Free tier on RapidAPI, no card to try.

Free tier: 50 requests/month. No card to try.

Docs: the Flights API and the MCP servers.