Skip to content

Recipe · Flights API

Round-trip search with Claude

Round-trip is a first-class paired-leg search: one object per itinerary with both legs already matched and a combined total, not two one-way lists the agent has to cross-join. The agent reads total_price and presents real bookable combinations.

Free tier on RapidAPI. No card to try.

Step 1 · Connect

Add the MCP server as a connector

Settings → Connectors → Add custom connector, paste the URL. If your client supports custom headers, prefer sending the key as x-rapidapi-key instead of in the URL.

connect
https://flights.flightpowers.com/mcp?rapidapi_key=YOUR_RAPIDAPI_KEY

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.

I need a round trip New York to Paris, out October 6, back October 13. What are my options?

Step 3 · Under the hood

What the agent calls

No glue code: the agent reads the tool schema, picks the tool, and fills these parameters from your prompt.

tool call
// search_roundtrip_flights
{
  "from_airport": "JFK",
  "to_airport": "CDG",
  "departure_date": "2026-10-06",
  "return_date": "2026-10-13",
  "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.

total_pricestring

The combined price of the paired round-trip itinerary: one number for both legs, because they were searched together. total_price_as_number is the integer.

total_duration_secondsnumber

Travel time across both legs, in seconds, sortable without parsing a display string.

departure_flight_airlinestring

Operating carrier on the outbound leg.

return_flight_airlinestring

Operating carrier on the return leg, paired to the same itinerary, not cross-joined.

buy_linkstring (URL)

A Google Flights deep link that reopens this exact itinerary. Hand it to the user; it just works.

Questions, answered plainly

Is my key billed to me?
Yes. The MCP server is bring-your-own-key: Claude sends your RapidAPI key with each call and usage 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 MCP servers are hosted at flights.flightpowers.com and hotels.flightpowers.com: you add a URL to Claude, not a deployment.
What does it cost?
The Google Flights Live API's free tier is 10 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.

Ready to judge a fare, not just fetch it?

Live Google Flights and Booking.com data, with the price band and verdict attached to every result. Free tier on RapidAPI, no card to try.

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