docs github

# FLIGHT BOOKING FOR AI AGENTS

a flight booking API and remote MCP server. your agent searches ~300 airlines, picks an offer, and sends the traveler a checkout link. works with claude, cursor, and any MCP client.

booked through Duffel and ticketed by the airline. the fee is shown before you pay.

book me a nonstop LHR to JFK on dec 1, economy
search_flights LHR → JFK...
3 nonstop offers:
$453 BA 117 · LHR 08:20 → JFK 11:05 · 7h 45m
$476 VS 3 · LHR 11:40 → JFK 14:35 · 7h 55m
$489 AA 101 · LHR 13:05 → JFK 16:10 · 8h 05m
book the BA one for me
create_checkout...
here is your checkout link: mcp.flightclaw.com/checkout?id=…
fare $453 + booking fee $25.65 = $478.65
~~~
1. search_flights
──►
2. get_offer
price, bags, fare rules
──►
3. create_checkout
traveler pays by card
airline issues ticket
your agent searches → live fares from ~300 airlines
your agent picks an offer → full price and conditions
your agent sends a link → the traveler pays and gets a ticket
~~~

# CONNECT YOUR AGENT

MCP server URL: https://mcp.flightclaw.com/mcp

sign in by email code. the first time your agent connects, a browser window opens. enter your email, then the 6-digit code we send you, and approve. no API key.

claude (claude.ai and desktop)

open claude connectors → customize → connectors → “+” → add custom connector (free plan: one custom connector). name: flightclaw. URL: https://mcp.flightclaw.com/mcp. click connect.

chatgpt

open chatgpt settings → settings → security and login → turn on developer mode (pro, plus, business, enterprise, edu). then create an app with “+” using URL https://mcp.flightclaw.com/mcp and OAuth.

cursor

add to cursor (one click) → or add to ~/.cursor/mcp.json:

{ "mcpServers": { "flightclaw": { "url": "https://mcp.flightclaw.com/mcp" } } }
click to copy
vs code

add to vs code (one click) →

claude code
# then run /mcp in claude code to sign in claude mcp add --transport http flightclaw https://mcp.flightclaw.com/mcp
click to copy · full tool list in the docs
~~~

# BOOK A FLIGHT

no sign-in. search, choose an offer, enter passengers, then pay on the secure checkout page.

    ~~~

    # TRACK A PRICE

    your agent can watch a route and email you when the price drops. the price is checked on a schedule. the alert goes to your sign-in email when the price reaches your target or drops 10% since the last check. alert prices include the booking fee. to stop tracking, ask your agent.

    # ask your agent track LHR to JFK on dec 1 and email me if it drops under $400
    ~~~

    # PRICING

    Free API. Travelers pay fare + 5% + $3 booking fee (minimum $12).

    the fee is a separate line in the API response and on the checkout page. changes cost $6. 100 flight searches per user per day on the MCP server.

    # PAYMENT

    checkout link (default). create_checkout returns a hosted page and the exact total. the traveler pays there by card and the airline issues the ticket.

    # AUTONOMOUS PAYMENT WITH LINK

    an agent with a Link virtual card can book on its own. it creates a spend request in Link for the exact total from create_checkout. you approve the spend in Link. then the agent pays on the checkout page with the virtual card.

    ~~~

    # FAQ

    Which airlines does flightclaw cover?

    About 300 airlines through Duffel, including full-service carriers and many low-cost carriers.

    What does flightclaw cost?

    The API is free. Travelers pay the airline fare plus a 5% + $3 booking fee (minimum $12), shown as a separate line at checkout.

    How does my agent sign in?

    With OAuth. The first time your agent connects, you enter your email and a 6-digit code we send you. There are no API keys.

    What data does flightclaw store?

    Your email and the traveler profiles you save, per account. Card details go to Duffel's payment form and are never stored by flightclaw.

    Is flightclaw affiliated with Google or an airline?

    No. flightclaw is not affiliated with Google or any airline.

    copied to clipboard