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.

book me a nonstop LHR to JFK on dec 1, economy
search_flights LHR → JFK...
3 nonstop offers:
$465 BA 117 · LHR 08:20 → JFK 11:05 · 7h 45m
$488 VS 3 · LHR 11:40 → JFK 14:35 · 7h 55m
$501 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.

    ~~~

    # 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.

    ~~~

    # LOCAL SKILL (OPEN SOURCE)

    want local price tracking instead? the open-source flightclaw skill runs locally with fli to search Google Flights and alert you when prices drop.

    # install the local skill npx skills add jackculpan/flightclaw
    click to copy
    copied to clipboard