# Agent Flights > Agent Flights: cheapest flights worldwide, strong on Africa. Flight search for AI agents: cheapest all-in fare first, plus a cheapest-sensible alternative. Tracked booking links. Remote MCP server (Streamable HTTP), free for now, no key or payment. Service: https://lowest.flights Version: 1.2.0 MCP: https://lowest.flights/mcp (Streamable HTTP) REST: https://lowest.flights/api/v1 OpenAPI: https://lowest.flights/api/v1/openapi.json Health: https://lowest.flights/api/v1/health Server card: https://lowest.flights/.well-known/mcp/server-card.json MCP Registry name: io.github.princemuichkine/agent-flights Docs: https://lowest.flights/connect Agent quickstart (MCP URL, register, attribution): https://lowest.flights/agents Full context for LLMs: https://lowest.flights/llms-full.txt Markdown: https://lowest.flights/index.md and https://lowest.flights/flights/{origin}-{destination}.md Sitemap: https://lowest.flights/sitemap.xml ## Auth (optional) - Guests: every tool and REST search works with no key (fair-use limits). - Self-serve key: MCP tool `register_agent` or `POST https://lowest.flights/api/v1/agents/register` with {"name":"My agent","client":"claude"} → `apiKey` (shown once, stored hashed). - Send `Authorization: Bearer ` (or `x-api-key`). Keys raise limits and tag booking clicks with your agent id. ## What agents should do 1. Call `search_flights` (MCP) or `GET/POST /api/v1/search` with IATA codes or city names and ISO dates (`YYYY-MM-DD`). Pass `flexDays=3` unless the date is fixed. 2. Present `cheapest` and `cheapestSensible` first. JSON shape: `cheapest`, `cheapestSensible`, `offers`, `sources`, `notes`. 3. If `separateTickets` is true (or `labels` contains `stitched`), warn that these are separate tickets with no missed-connection protection. 4. Read `feeNotes` for baggage, long layover, and transit-visa warnings. 5. If `priceKind` is `indicative`, say the price is cached (include `indicativeAgeHours`) and must be re-checked before booking. 6. Send travellers to `bookingLink` (`https://lowest.flights/go/{offerId}?a={agentId}&src={client}`): it redirects to the best bookable partner (Kiwi.com, Aviasales, Trip.com) and attributes the click to your agent. Agent Flights earns a partner commission; never add a booking fee. 7. Use `explore_cheap_destinations` for cheap destinations and `find_cheapest_dates` for the cheapest day. 8. `get_flight_offer` / `get_booking_link` only work for offers from the last ~30 minutes. 9. MCP is free for now: every tool works with no key and no payment. No unlock is needed. 10. REST search stays free for now. Paid REST comes later. ## MCP tools - search_flights: Search cheap flights between two airports or cities and return the cheapest all-in fare plus a cheapest-sensible alternative (penalises 20h+ layovers and risky overnight transfers). Compares Kiwi.com live fares with Duffel and Aviasales data, expands nearby airports and combines self-transfer one-ways when cheaper. Strong on Africa routes (Abidjan, Dakar, Lagos, Accra, Nairobi, Casablanca). One-way, return, multi-passenger, cabin and bag filters. Example: {"origin":"ABJ","destination":"CDG","departureDate":"2026-12-18","returnDate":"2027-01-05","flexDays":3,"currency":"XOF"}. Returns {cheapest, cheapestSensible, offers[], sources, notes}. - find_cheapest_dates: Cheapest known fare for each day of a month on one route: a price calendar to pick the cheapest day to fly. Example: {"origin":"DSS","destination":"LIS","month":"2026-12","currency":"EUR"}. Prices may be cached (priceKind indicative); confirm with search_flights before booking. - explore_cheap_destinations: Where can I fly cheaply from here? Lists the cheapest destinations from an origin for a month, optionally under a budget. Example: {"origin":"ABJ","month":"2026-12","budget":400,"currency":"EUR"}. - get_flight_offer: Full details of one offer from search_flights: legs, segments, layovers, baggage, fees and warnings. Example: {"id":"off_8f2c1a"}. Offers expire about 30 minutes after the search. - get_booking_link: Booking link for an offer: bookingLink is a lowest.flights redirect that picks the best bookable partner (Kiwi.com, Aviasales, Trip.com) and attributes the click to your agent; alternatives lists other partners. Includes self-transfer and cached-price warnings to show the traveller. Example: {"id":"off_8f2c1a"}. - list_flight_sources: Which flight data sources are live right now (Kiwi.com, Duffel, Aviasales) and cache status. No input. - register_agent: Self-register this agent and get an Agent Flights API key instantly (free; no email confirmation). Use it as Authorization: Bearer (or x-api-key) on /mcp and /api/v1 for higher limits and booking-click attribution. Optional: guests can use every tool without a key. Example: {"name":"Trip planner","client":"claude"}. The key is shown once. - unlock_mcp: MCP is free for now: every Agent Flights tool works with no key and no payment. Calling this returns that notice and creates no checkout. No input needed. ## REST - GET/POST https://lowest.flights/api/v1/search - GET https://lowest.flights/api/v1/explore?origin=ABJ&month=2026-12&budget=400 - GET https://lowest.flights/api/v1/calendar?origin=LON&destination=BCN&month=2026-12 - GET https://lowest.flights/api/v1/offers/{id} - GET https://lowest.flights/api/v1/offers/{id}/booking - GET https://lowest.flights/api/v1/fx - POST https://lowest.flights/api/v1/agents/register - GET https://lowest.flights/api/v1/orders/{id}?t={accessToken} (the MCP key is only shown with the order's accessToken) - POST https://lowest.flights/api/v1/keys (preview REST key, not full MCP) - GET https://lowest.flights/api/v1/admin/summary - POST https://lowest.flights/api/v1/webhooks/lomi - POST https://lowest.flights/api/v1/webhooks/stripe Default currency is EUR. Display currencies: EUR, USD, XOF, GBP, NGN, GHS, MAD, KES, ZAR, CAD. FX uses ECB rates via Frankfurter, with a fallback table and a fixed EUR/XOF peg (655.957). ## Sources - Kiwi.com public MCP (always on, live) - Duffel flights API (when DUFFEL_ACCESS_TOKEN is set) - Travelpayouts/Aviasales Data API (when TRAVELPAYOUTS_TOKEN is set) Payments (test/sandbox): MCP unlock via lomi. (primary), Stripe, or local sandbox. Live keys need AIRBOT_ALLOW_LIVE_PAYMENTS. Fulfill only on signed PAYMENT_SUCCEEDED. Refunds send Idempotency-Key. Agent Flights does not scrape airline sites, meta-search sites, or Google Flights. ## West Africa ABJ (Abidjan) and DSS/DKR (Dakar) are first-class origins. ASKY, Air Burkina and Transair still have no public fare API. ## Install ### Claude Desktop / claude.ai Settings → Connectors → Add custom connector, then paste the URL. Older builds: claude_desktop_config.json via mcp-remote. ``` { "mcpServers": { "agent-flights": { "command": "npx", "args": [ "-y", "mcp-remote", "https://lowest.flights/mcp" ] } } } ``` ### Claude Code Terminal ``` claude mcp add --transport http agent-flights https://lowest.flights/mcp ``` ### Cursor ~/.cursor/mcp.json (or .cursor/mcp.json in a project) ``` { "mcpServers": { "agent-flights": { "url": "https://lowest.flights/mcp" } } } ``` ### VS Code (Copilot agent mode) .vscode/mcp.json ``` { "servers": { "agent-flights": { "type": "http", "url": "https://lowest.flights/mcp" } } } ``` ### Windsurf ~/.codeium/windsurf/mcp_config.json ``` { "mcpServers": { "agent-flights": { "serverUrl": "https://lowest.flights/mcp" } } } ``` ### ChatGPT, Le Chat, other remote-MCP clients Add a custom connector / MCP server with this URL (Streamable HTTP, no auth needed for the preview) ``` https://lowest.flights/mcp ```