# 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 ``` --- # Product: Agent Flights: cheapest flights worldwide, strong on Africa Agent Flights (https://lowest.flights) finds the cheapest all-in flight fare and a cheapest-sensible alternative (no 20h+ layovers or risky overnight self-transfers). It compares Kiwi.com live fares, Aviasales (Travelpayouts) data and Duffel, expands nearby airports, and combines separate one-way tickets when that is cheaper, with a clear self-transfer warning. ## Key facts - **Price:** free to use. No booking fee: you book and pay on the airline or travel-agency site. - **Coverage:** worldwide, with first-class support for African airports such as Abidjan (ABJ), Dakar (DSS), Lagos (LOS), Accra (ACC), Nairobi (NBO), Casablanca (CMN) and Johannesburg (JNB). - **Currencies:** EUR, USD, XOF (FCFA), GBP, NGN, GHS, MAD, KES, ZAR, CAD. - **Tools:** route search, price calendar (cheapest day in a month), Everywhere search (cheapest destinations from a city). - **For AI agents:** free remote MCP server at https://lowest.flights/mcp and REST API at https://lowest.flights/api/v1 (OpenAPI: https://lowest.flights/api/v1/openapi.json). No key needed; `register_agent` issues one instantly. ## FAQ **Is Agent Flights a travel agency?** No. It is a flight search engine. It shows fares and sends you to the airline or agency to book. **Why are some itineraries marked "separate tickets"?** They combine two one-way tickets. They can be much cheaper, but a missed connection is not protected. **Are prices live?** Kiwi.com and Duffel prices are live. Aviasales prices can be cached; they are labelled indicative and should be re-checked before booking. **How can an AI assistant use it?** Connect the MCP server https://lowest.flights/mcp (Streamable HTTP) in Claude, ChatGPT, Cursor, Codex or any MCP client. ## Popular routes - [Abidjan (ABJ) to Nouakchott (NKC)](https://lowest.flights/flights/abj-nkc) - [Abidjan (ABJ) to Paris (CDG)](https://lowest.flights/flights/abj-cdg) - [Abidjan (ABJ) to Dakar (DSS)](https://lowest.flights/flights/abj-dss) - [Abidjan (ABJ) to Lagos (LOS)](https://lowest.flights/flights/abj-los) - [Abidjan (ABJ) to London (LHR)](https://lowest.flights/flights/abj-lhr) - [Abidjan (ABJ) to Istanbul (IST)](https://lowest.flights/flights/abj-ist) - [Abidjan (ABJ) to Casablanca (CMN)](https://lowest.flights/flights/abj-cmn) - [Abidjan (ABJ) to Brussels (BRU)](https://lowest.flights/flights/abj-bru) - [Abidjan (ABJ) to Accra (ACC)](https://lowest.flights/flights/abj-acc) - [Abidjan (ABJ) to Cotonou (COO)](https://lowest.flights/flights/abj-coo) - [Abidjan (ABJ) to Ouagadougou (OUA)](https://lowest.flights/flights/abj-oua) - [Abidjan (ABJ) to Bamako (BKO)](https://lowest.flights/flights/abj-bko) - [Abidjan (ABJ) to Conakry (CKY)](https://lowest.flights/flights/abj-cky) - [Abidjan (ABJ) to Lomé (LFW)](https://lowest.flights/flights/abj-lfw) - [Abidjan (ABJ) to Douala (DLA)](https://lowest.flights/flights/abj-dla) - [Abidjan (ABJ) to Addis Ababa (ADD)](https://lowest.flights/flights/abj-add) - [Abidjan (ABJ) to Nairobi (NBO)](https://lowest.flights/flights/abj-nbo) - [Abidjan (ABJ) to Johannesburg (JNB)](https://lowest.flights/flights/abj-jnb) - [Abidjan (ABJ) to Dubai (DXB)](https://lowest.flights/flights/abj-dxb) - [Abidjan (ABJ) to New York (JFK)](https://lowest.flights/flights/abj-jfk) - [Abidjan (ABJ) to Madrid (MAD)](https://lowest.flights/flights/abj-mad) - [Dakar (DSS) to Paris (CDG)](https://lowest.flights/flights/dss-cdg) - [Dakar (DSS) to Casablanca (CMN)](https://lowest.flights/flights/dss-cmn) - [Dakar (DSS) to New York (JFK)](https://lowest.flights/flights/dss-jfk) - [Dakar (DSS) to Abidjan (ABJ)](https://lowest.flights/flights/dss-abj) - [Dakar (DSS) to Bamako (BKO)](https://lowest.flights/flights/dss-bko) - [Dakar (DSS) to Nouakchott (NKC)](https://lowest.flights/flights/dss-nkc) - [Dakar (DSS) to Conakry (CKY)](https://lowest.flights/flights/dss-cky) - [Dakar (DSS) to Madrid (MAD)](https://lowest.flights/flights/dss-mad) - [Dakar (DSS) to Lisbon (LIS)](https://lowest.flights/flights/dss-lis) - [Dakar (DSS) to Istanbul (IST)](https://lowest.flights/flights/dss-ist) - [Dakar (DSS) to Brussels (BRU)](https://lowest.flights/flights/dss-bru) - [Dakar (DSS) to Dubai (DXB)](https://lowest.flights/flights/dss-dxb) - [Lagos (LOS) to Abidjan (ABJ)](https://lowest.flights/flights/los-abj) - [Lagos (LOS) to Accra (ACC)](https://lowest.flights/flights/los-acc) - [Lagos (LOS) to London (LHR)](https://lowest.flights/flights/los-lhr) - [Lagos (LOS) to Dubai (DXB)](https://lowest.flights/flights/los-dxb) - [Lagos (LOS) to Johannesburg (JNB)](https://lowest.flights/flights/los-jnb) - [Lagos (LOS) to New York (JFK)](https://lowest.flights/flights/los-jfk) - [Accra (ACC) to Abidjan (ABJ)](https://lowest.flights/flights/acc-abj) - [Accra (ACC) to Lagos (LOS)](https://lowest.flights/flights/acc-los) - [Accra (ACC) to London (LHR)](https://lowest.flights/flights/acc-lhr) - [Accra (ACC) to Dubai (DXB)](https://lowest.flights/flights/acc-dxb) - [Bamako (BKO) to Paris (CDG)](https://lowest.flights/flights/bko-cdg) - [Bamako (BKO) to Dakar (DSS)](https://lowest.flights/flights/bko-dss) - [Ouagadougou (OUA) to Paris (CDG)](https://lowest.flights/flights/oua-cdg) - [Cotonou (COO) to Paris (CDG)](https://lowest.flights/flights/coo-cdg) - [Conakry (CKY) to Paris (CDG)](https://lowest.flights/flights/cky-cdg) - [Nouakchott (NKC) to Paris (CDG)](https://lowest.flights/flights/nkc-cdg) - [Nouakchott (NKC) to Dakar (DSS)](https://lowest.flights/flights/nkc-dss) - [Nouakchott (NKC) to Casablanca (CMN)](https://lowest.flights/flights/nkc-cmn) - [Douala (DLA) to Paris (CDG)](https://lowest.flights/flights/dla-cdg) - [Lomé (LFW) to Paris (CDG)](https://lowest.flights/flights/lfw-cdg) - [Niamey (NIM) to Paris (CDG)](https://lowest.flights/flights/nim-cdg) - [Casablanca (CMN) to Dakar (DSS)](https://lowest.flights/flights/cmn-dss) - [Casablanca (CMN) to Abidjan (ABJ)](https://lowest.flights/flights/cmn-abj) - [Addis Ababa (ADD) to Abidjan (ABJ)](https://lowest.flights/flights/add-abj) - [Nairobi (NBO) to Johannesburg (JNB)](https://lowest.flights/flights/nbo-jnb) - [Johannesburg (JNB) to Cape Town (CPT)](https://lowest.flights/flights/jnb-cpt) - [Cairo (CAI) to Dubai (DXB)](https://lowest.flights/flights/cai-dxb) - [Paris (PAR) to Abidjan (ABJ)](https://lowest.flights/flights/par-abj) - [Paris (PAR) to Dakar (DSS)](https://lowest.flights/flights/par-dss) - [Paris (PAR) to Bamako (BKO)](https://lowest.flights/flights/par-bko) - [London (LON) to Lagos (LOS)](https://lowest.flights/flights/lon-los) - [London (LON) to Accra (ACC)](https://lowest.flights/flights/lon-acc) - [London (LON) to Barcelona (BCN)](https://lowest.flights/flights/lon-bcn) - [Paris (PAR) to Rome (FCO)](https://lowest.flights/flights/par-fco) - [New York (NYC) to London (LON)](https://lowest.flights/flights/nyc-lon) - [Nairobi (NBO) to Dubai (DXB)](https://lowest.flights/flights/nbo-dxb) - [Casablanca (CMN) to Paris (CDG)](https://lowest.flights/flights/cmn-cdg) - [Johannesburg (JNB) to London (LHR)](https://lowest.flights/flights/jnb-lhr) - [Abuja (ABV) to London (LHR)](https://lowest.flights/flights/abv-lhr) - [Lagos (LOS) to Paris (CDG)](https://lowest.flights/flights/los-cdg) - [Accra (ACC) to New York (JFK)](https://lowest.flights/flights/acc-jfk) - [Addis Ababa (ADD) to Dubai (DXB)](https://lowest.flights/flights/add-dxb) - [Cairo (CAI) to Jeddah (JED)](https://lowest.flights/flights/cai-jed) - [Lagos (LOS) to Istanbul (IST)](https://lowest.flights/flights/los-ist) - [Accra (ACC) to Paris (CDG)](https://lowest.flights/flights/acc-cdg) - [Dakar (DSS) to London (LHR)](https://lowest.flights/flights/dss-lhr) - [Abidjan (ABJ) to Montreal (YUL)](https://lowest.flights/flights/abj-yul) - [Dakar (DSS) to Montreal (YUL)](https://lowest.flights/flights/dss-yul) - [Nairobi (NBO) to London (LHR)](https://lowest.flights/flights/nbo-lhr) - [Johannesburg (JNB) to Dubai (DXB)](https://lowest.flights/flights/jnb-dxb) - [Casablanca (CMN) to New York (JFK)](https://lowest.flights/flights/cmn-jfk) - [Algiers (ALG) to Paris (CDG)](https://lowest.flights/flights/alg-cdg) - [Tunis (TUN) to Paris (CDG)](https://lowest.flights/flights/tun-cdg) - [Lomé (LFW) to Accra (ACC)](https://lowest.flights/flights/lfw-acc) - [Kinshasa (FIH) to Paris (CDG)](https://lowest.flights/flights/fih-cdg) - [Libreville (LBV) to Paris (CDG)](https://lowest.flights/flights/lbv-cdg) - [Yaoundé (NSI) to Paris (CDG)](https://lowest.flights/flights/nsi-cdg) - [Nairobi (NBO) to Paris (CDG)](https://lowest.flights/flights/nbo-cdg) - [Nairobi (NBO) to Addis Ababa (ADD)](https://lowest.flights/flights/nbo-add) - [Nairobi (NBO) to Istanbul (IST)](https://lowest.flights/flights/nbo-ist) - [Nairobi (NBO) to Amsterdam (AMS)](https://lowest.flights/flights/nbo-ams) - [Nairobi (NBO) to Doha (DOH)](https://lowest.flights/flights/nbo-doh) - [Johannesburg (JNB) to Nairobi (NBO)](https://lowest.flights/flights/jnb-nbo) - [Johannesburg (JNB) to Addis Ababa (ADD)](https://lowest.flights/flights/jnb-add) - [Johannesburg (JNB) to Paris (CDG)](https://lowest.flights/flights/jnb-cdg) - [Johannesburg (JNB) to Lagos (LOS)](https://lowest.flights/flights/jnb-los) - [Johannesburg (JNB) to Frankfurt (FRA)](https://lowest.flights/flights/jnb-fra) - [Cairo (CAI) to Paris (CDG)](https://lowest.flights/flights/cai-cdg) - [Cairo (CAI) to London (LHR)](https://lowest.flights/flights/cai-lhr) - [Cairo (CAI) to Istanbul (IST)](https://lowest.flights/flights/cai-ist) - [Cairo (CAI) to Riyadh (RUH)](https://lowest.flights/flights/cai-ruh) - [Cairo (CAI) to Addis Ababa (ADD)](https://lowest.flights/flights/cai-add) - [Addis Ababa (ADD) to Paris (CDG)](https://lowest.flights/flights/add-cdg) - [Addis Ababa (ADD) to London (LHR)](https://lowest.flights/flights/add-lhr) - [Addis Ababa (ADD) to Nairobi (NBO)](https://lowest.flights/flights/add-nbo) - [Addis Ababa (ADD) to Johannesburg (JNB)](https://lowest.flights/flights/add-jnb) - [Addis Ababa (ADD) to Lagos (LOS)](https://lowest.flights/flights/add-los) - [Kinshasa (FIH) to Johannesburg (JNB)](https://lowest.flights/flights/fih-jnb) - [Kinshasa (FIH) to Addis Ababa (ADD)](https://lowest.flights/flights/fih-add) - [Kinshasa (FIH) to Brussels (BRU)](https://lowest.flights/flights/fih-bru) - [Kinshasa (FIH) to Douala (DLA)](https://lowest.flights/flights/fih-dla) - [Kinshasa (FIH) to Nairobi (NBO)](https://lowest.flights/flights/fih-nbo) - [Kinshasa (FIH) to Istanbul (IST)](https://lowest.flights/flights/fih-ist) - [Douala (DLA) to Abidjan (ABJ)](https://lowest.flights/flights/dla-abj) - [Douala (DLA) to Brussels (BRU)](https://lowest.flights/flights/dla-bru) - [Douala (DLA) to Istanbul (IST)](https://lowest.flights/flights/dla-ist) - [Douala (DLA) to Lagos (LOS)](https://lowest.flights/flights/dla-los) - [Douala (DLA) to Yaoundé (NSI)](https://lowest.flights/flights/dla-nsi) - [Bamako (BKO) to Abidjan (ABJ)](https://lowest.flights/flights/bko-abj) - [Bamako (BKO) to Istanbul (IST)](https://lowest.flights/flights/bko-ist) - [Bamako (BKO) to Casablanca (CMN)](https://lowest.flights/flights/bko-cmn) - [Bamako (BKO) to Ouagadougou (OUA)](https://lowest.flights/flights/bko-oua) - [Casablanca (CMN) to London (LHR)](https://lowest.flights/flights/cmn-lhr) - [Casablanca (CMN) to Istanbul (IST)](https://lowest.flights/flights/cmn-ist) - [Accra (ACC) to Istanbul (IST)](https://lowest.flights/flights/acc-ist) --- ## Resource agent-flights://docs/getting-started: Getting started # Agent Flights MCP: getting started Agent Flights (v1.2.0) finds the cheapest flights worldwide, with first-class coverage of African routes (Abidjan, Dakar, Lagos, Accra, Nairobi, Casablanca, Johannesburg…). Travellers book on the airline or agency site; Agent Flights never sells tickets or charges a fee. - MCP endpoint (Streamable HTTP): https://lowest.flights/mcp - REST API: https://lowest.flights/api/v1 (OpenAPI: https://lowest.flights/api/v1/openapi.json) - Auth: optional. Guests use every tool with no key (fair-use limits). Call `register_agent` once for your own API key (higher limits, click attribution) and send `Authorization: Bearer `. ## Recommended tool sequence 1. `search_flights` with origin, destination and departureDate (add returnDate for a round trip). Pass `flexDays: 3` unless the traveller's date is fixed. 2. Show both `cheapest` and `cheapestSensible`. Warn about `separateTickets` (self-transfer) and `priceKind: "indicative"` (cached price, confirm before paying). 3. Send the traveller to the offer's `bookingLink` (also returned by `get_booking_link`). It is a https://lowest.flights/go/{offerId}?a={agentId}&src={client} redirect to the best bookable partner. `alternatives[]` lists the same route on other partner sites when enabled. 4. Unknown date? `find_cheapest_dates` for a month. Unknown destination? `explore_cheap_destinations`. Offer ids expire about 30 minutes after a search: search again instead of reusing old ids. ## Places Use 3-letter IATA airport or metro codes (ABJ, DSS, LOS, ACC, NBO, CMN, JNB, CDG, LON, NYC) or plain city names. See `agent-flights://markets` for the curated list. ## Currencies Any ISO 4217 code. XOF is shown as FCFA; zero-decimal currencies (XOF, XAF, JPY) are rounded. ## Resource agent-flights://docs/booking: Booking, affiliate links and warnings # Booking and money - Agent Flights is a meta-search. The traveller pays the airline or agency directly. - Booking links are affiliate links (Travelpayouts / Kiwi.com / Aviasales and other partners). The traveller pays the same price; Agent Flights may earn a commission. Disclose this if the traveller asks. - Self-transfer itineraries (`separateTickets: true`) are separate tickets: a missed connection is not protected. - Cached prices (`priceKind: "indicative"`) can move; the partner site shows the final price. - Never ask the traveller for card details in chat. Never claim a booking is confirmed. ## Resource agent-flights://docs/errors: Tool errors # Tool errors Tool errors come back with `isError: true` and a one-line message. Common cases: | Message contains | What to do | | --- | --- | | `unknown or expired` | The offer id is older than ~30 minutes. Run `search_flights` again. | | `Timed out` / `took too long` | An upstream fare source was slow. Retry once, or narrow flexDays. | | `Use YYYY-MM-DD` | Fix the date format. Dates must be today or later. | | `Unknown place` | Use a 3-letter IATA code or a clearer city name. | | `rate limit` | Wait a minute before the next call. | Successful results are JSON (in `structuredContent` and as text). A search where every source failed returns an empty `offers` array plus `sources[]` with each source's error: tell the traveller and retry later. ## Resource agent-flights://routes/popular: Popular routes [ { "origin": "ABJ", "destination": "NKC", "page": "https://lowest.flights/flights/abj-nkc" }, { "origin": "ABJ", "destination": "CDG", "page": "https://lowest.flights/flights/abj-cdg" }, { "origin": "ABJ", "destination": "DSS", "page": "https://lowest.flights/flights/abj-dss" }, { "origin": "ABJ", "destination": "LOS", "page": "https://lowest.flights/flights/abj-los" }, { "origin": "ABJ", "destination": "LHR", "page": "https://lowest.flights/flights/abj-lhr" }, { "origin": "ABJ", "destination": "IST", "page": "https://lowest.flights/flights/abj-ist" }, { "origin": "ABJ", "destination": "CMN", "page": "https://lowest.flights/flights/abj-cmn" }, { "origin": "ABJ", "destination": "BRU", "page": "https://lowest.flights/flights/abj-bru" }, { "origin": "ABJ", "destination": "ACC", "page": "https://lowest.flights/flights/abj-acc" }, { "origin": "ABJ", "destination": "COO", "page": "https://lowest.flights/flights/abj-coo" }, { "origin": "ABJ", "destination": "OUA", "page": "https://lowest.flights/flights/abj-oua" }, { "origin": "ABJ", "destination": "BKO", "page": "https://lowest.flights/flights/abj-bko" }, { "origin": "ABJ", "destination": "CKY", "page": "https://lowest.flights/flights/abj-cky" }, { "origin": "ABJ", "destination": "LFW", "page": "https://lowest.flights/flights/abj-lfw" }, { "origin": "ABJ", "destination": "DLA", "page": "https://lowest.flights/flights/abj-dla" }, { "origin": "ABJ", "destination": "ADD", "page": "https://lowest.flights/flights/abj-add" }, { "origin": "ABJ", "destination": "NBO", "page": "https://lowest.flights/flights/abj-nbo" }, { "origin": "ABJ", "destination": "JNB", "page": "https://lowest.flights/flights/abj-jnb" }, { "origin": "ABJ", "destination": "DXB", "page": "https://lowest.flights/flights/abj-dxb" }, { "origin": "ABJ", "destination": "JFK", "page": "https://lowest.flights/flights/abj-jfk" }, { "origin": "ABJ", "destination": "MAD", "page": "https://lowest.flights/flights/abj-mad" }, { "origin": "DSS", "destination": "CDG", "page": "https://lowest.flights/flights/dss-cdg" }, { "origin": "DSS", "destination": "CMN", "page": "https://lowest.flights/flights/dss-cmn" }, { "origin": "DSS", "destination": "JFK", "page": "https://lowest.flights/flights/dss-jfk" }, { "origin": "DSS", "destination": "ABJ", "page": "https://lowest.flights/flights/dss-abj" }, { "origin": "DSS", "destination": "BKO", "page": "https://lowest.flights/flights/dss-bko" }, { "origin": "DSS", "destination": "NKC", "page": "https://lowest.flights/flights/dss-nkc" }, { "origin": "DSS", "destination": "CKY", "page": "https://lowest.flights/flights/dss-cky" }, { "origin": "DSS", "destination": "MAD", "page": "https://lowest.flights/flights/dss-mad" }, { "origin": "DSS", "destination": "LIS", "page": "https://lowest.flights/flights/dss-lis" }, { "origin": "DSS", "destination": "IST", "page": "https://lowest.flights/flights/dss-ist" }, { "origin": "DSS", "destination": "BRU", "page": "https://lowest.flights/flights/dss-bru" }, { "origin": "DSS", "destination": "DXB", "page": "https://lowest.flights/flights/dss-dxb" }, { "origin": "LOS", "destination": "ABJ", "page": "https://lowest.flights/flights/los-abj" }, { "origin": "LOS", "destination": "ACC", "page": "https://lowest.flights/flights/los-acc" }, { "origin": "LOS", "destination": "LHR", "page": "https://lowest.flights/flights/los-lhr" }, { "origin": "LOS", "destination": "DXB", "page": "https://lowest.flights/flights/los-dxb" }, { "origin": "LOS", "destination": "JNB", "page": "https://lowest.flights/flights/los-jnb" }, { "origin": "LOS", "destination": "JFK", "page": "https://lowest.flights/flights/los-jfk" }, { "origin": "ACC", "destination": "ABJ", "page": "https://lowest.flights/flights/acc-abj" }, { "origin": "ACC", "destination": "LOS", "page": "https://lowest.flights/flights/acc-los" }, { "origin": "ACC", "destination": "LHR", "page": "https://lowest.flights/flights/acc-lhr" }, { "origin": "ACC", "destination": "DXB", "page": "https://lowest.flights/flights/acc-dxb" }, { "origin": "BKO", "destination": "CDG", "page": "https://lowest.flights/flights/bko-cdg" }, { "origin": "BKO", "destination": "DSS", "page": "https://lowest.flights/flights/bko-dss" }, { "origin": "OUA", "destination": "CDG", "page": "https://lowest.flights/flights/oua-cdg" }, { "origin": "COO", "destination": "CDG", "page": "https://lowest.flights/flights/coo-cdg" }, { "origin": "CKY", "destination": "CDG", "page": "https://lowest.flights/flights/cky-cdg" }, { "origin": "NKC", "destination": "CDG", "page": "https://lowest.flights/flights/nkc-cdg" }, { "origin": "NKC", "destination": "DSS", "page": "https://lowest.flights/flights/nkc-dss" }, { "origin": "NKC", "destination": "CMN", "page": "https://lowest.flights/flights/nkc-cmn" }, { "origin": "DLA", "destination": "CDG", "page": "https://lowest.flights/flights/dla-cdg" }, { "origin": "LFW", "destination": "CDG", "page": "https://lowest.flights/flights/lfw-cdg" }, { "origin": "NIM", "destination": "CDG", "page": "https://lowest.flights/flights/nim-cdg" }, { "origin": "CMN", "destination": "DSS", "page": "https://lowest.flights/flights/cmn-dss" }, { "origin": "CMN", "destination": "ABJ", "page": "https://lowest.flights/flights/cmn-abj" }, { "origin": "ADD", "destination": "ABJ", "page": "https://lowest.flights/flights/add-abj" }, { "origin": "NBO", "destination": "JNB", "page": "https://lowest.flights/flights/nbo-jnb" }, { "origin": "JNB", "destination": "CPT", "page": "https://lowest.flights/flights/jnb-cpt" }, { "origin": "CAI", "destination": "DXB", "page": "https://lowest.flights/flights/cai-dxb" }, { "origin": "PAR", "destination": "ABJ", "page": "https://lowest.flights/flights/par-abj" }, { "origin": "PAR", "destination": "DSS", "page": "https://lowest.flights/flights/par-dss" }, { "origin": "PAR", "destination": "BKO", "page": "https://lowest.flights/flights/par-bko" }, { "origin": "LON", "destination": "LOS", "page": "https://lowest.flights/flights/lon-los" }, { "origin": "LON", "destination": "ACC", "page": "https://lowest.flights/flights/lon-acc" }, { "origin": "LON", "destination": "BCN", "page": "https://lowest.flights/flights/lon-bcn" }, { "origin": "PAR", "destination": "FCO", "page": "https://lowest.flights/flights/par-fco" }, { "origin": "NYC", "destination": "LON", "page": "https://lowest.flights/flights/nyc-lon" }, { "origin": "NBO", "destination": "DXB", "page": "https://lowest.flights/flights/nbo-dxb" }, { "origin": "CMN", "destination": "CDG", "page": "https://lowest.flights/flights/cmn-cdg" }, { "origin": "JNB", "destination": "LHR", "page": "https://lowest.flights/flights/jnb-lhr" }, { "origin": "ABV", "destination": "LHR", "page": "https://lowest.flights/flights/abv-lhr" }, { "origin": "LOS", "destination": "CDG", "page": "https://lowest.flights/flights/los-cdg" }, { "origin": "ACC", "destination": "JFK", "page": "https://lowest.flights/flights/acc-jfk" }, { "origin": "ADD", "destination": "DXB", "page": "https://lowest.flights/flights/add-dxb" }, { "origin": "CAI", "destination": "JED", "page": "https://lowest.flights/flights/cai-jed" }, { "origin": "LOS", "destination": "IST", "page": "https://lowest.flights/flights/los-ist" }, { "origin": "ACC", "destination": "CDG", "page": "https://lowest.flights/flights/acc-cdg" }, { "origin": "DSS", "destination": "LHR", "page": "https://lowest.flights/flights/dss-lhr" }, { "origin": "ABJ", "destination": "YUL", "page": "https://lowest.flights/flights/abj-yul" }, { "origin": "DSS", "destination": "YUL", "page": "https://lowest.flights/flights/dss-yul" }, { "origin": "NBO", "destination": "LHR", "page": "https://lowest.flights/flights/nbo-lhr" }, { "origin": "JNB", "destination": "DXB", "page": "https://lowest.flights/flights/jnb-dxb" }, { "origin": "CMN", "destination": "JFK", "page": "https://lowest.flights/flights/cmn-jfk" }, { "origin": "ALG", "destination": "CDG", "page": "https://lowest.flights/flights/alg-cdg" }, { "origin": "TUN", "destination": "CDG", "page": "https://lowest.flights/flights/tun-cdg" }, { "origin": "LFW", "destination": "ACC", "page": "https://lowest.flights/flights/lfw-acc" }, { "origin": "FIH", "destination": "CDG", "page": "https://lowest.flights/flights/fih-cdg" }, { "origin": "LBV", "destination": "CDG", "page": "https://lowest.flights/flights/lbv-cdg" }, { "origin": "NSI", "destination": "CDG", "page": "https://lowest.flights/flights/nsi-cdg" }, { "origin": "NBO", "destination": "CDG", "page": "https://lowest.flights/flights/nbo-cdg" }, { "origin": "NBO", "destination": "ADD", "page": "https://lowest.flights/flights/nbo-add" }, { "origin": "NBO", "destination": "IST", "page": "https://lowest.flights/flights/nbo-ist" }, { "origin": "NBO", "destination": "AMS", "page": "https://lowest.flights/flights/nbo-ams" }, { "origin": "NBO", "destination": "DOH", "page": "https://lowest.flights/flights/nbo-doh" }, { "origin": "JNB", "destination": "NBO", "page": "https://lowest.flights/flights/jnb-nbo" }, { "origin": "JNB", "destination": "ADD", "page": "https://lowest.flights/flights/jnb-add" }, { "origin": "JNB", "destination": "CDG", "page": "https://lowest.flights/flights/jnb-cdg" }, { "origin": "JNB", "destination": "LOS", "page": "https://lowest.flights/flights/jnb-los" }, { "origin": "JNB", "destination": "FRA", "page": "https://lowest.flights/flights/jnb-fra" }, { "origin": "CAI", "destination": "CDG", "page": "https://lowest.flights/flights/cai-cdg" }, { "origin": "CAI", "destination": "LHR", "page": "https://lowest.flights/flights/cai-lhr" }, { "origin": "CAI", "destination": "IST", "page": "https://lowest.flights/flights/cai-ist" }, { "origin": "CAI", "destination": "RUH", "page": "https://lowest.flights/flights/cai-ruh" }, { "origin": "CAI", "destination": "ADD", "page": "https://lowest.flights/flights/cai-add" }, { "origin": "ADD", "destination": "CDG", "page": "https://lowest.flights/flights/add-cdg" }, { "origin": "ADD", "destination": "LHR", "page": "https://lowest.flights/flights/add-lhr" }, { "origin": "ADD", "destination": "NBO", "page": "https://lowest.flights/flights/add-nbo" }, { "origin": "ADD", "destination": "JNB", "page": "https://lowest.flights/flights/add-jnb" }, { "origin": "ADD", "destination": "LOS", "page": "https://lowest.flights/flights/add-los" }, { "origin": "FIH", "destination": "JNB", "page": "https://lowest.flights/flights/fih-jnb" }, { "origin": "FIH", "destination": "ADD", "page": "https://lowest.flights/flights/fih-add" }, { "origin": "FIH", "destination": "BRU", "page": "https://lowest.flights/flights/fih-bru" }, { "origin": "FIH", "destination": "DLA", "page": "https://lowest.flights/flights/fih-dla" }, { "origin": "FIH", "destination": "NBO", "page": "https://lowest.flights/flights/fih-nbo" }, { "origin": "FIH", "destination": "IST", "page": "https://lowest.flights/flights/fih-ist" }, { "origin": "DLA", "destination": "ABJ", "page": "https://lowest.flights/flights/dla-abj" }, { "origin": "DLA", "destination": "BRU", "page": "https://lowest.flights/flights/dla-bru" }, { "origin": "DLA", "destination": "IST", "page": "https://lowest.flights/flights/dla-ist" }, { "origin": "DLA", "destination": "LOS", "page": "https://lowest.flights/flights/dla-los" }, { "origin": "DLA", "destination": "NSI", "page": "https://lowest.flights/flights/dla-nsi" }, { "origin": "BKO", "destination": "ABJ", "page": "https://lowest.flights/flights/bko-abj" }, { "origin": "BKO", "destination": "IST", "page": "https://lowest.flights/flights/bko-ist" }, { "origin": "BKO", "destination": "CMN", "page": "https://lowest.flights/flights/bko-cmn" }, { "origin": "BKO", "destination": "OUA", "page": "https://lowest.flights/flights/bko-oua" }, { "origin": "CMN", "destination": "LHR", "page": "https://lowest.flights/flights/cmn-lhr" }, { "origin": "CMN", "destination": "IST", "page": "https://lowest.flights/flights/cmn-ist" }, { "origin": "ACC", "destination": "IST", "page": "https://lowest.flights/flights/acc-ist" } ] --- # MCP tool schemas ### 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}. ```json { "type": "object", "properties": { "origin": { "type": "string", "minLength": 3, "maxLength": 64, "description": "Departure airport or city: a 3-letter IATA airport/metro code (ABJ, DSS, LOS, CDG, LON, NYC) or a plain name (\"Abidjan\", \"Paris\").", "examples": [ "ABJ", "DSS", "Lagos" ] }, "destination": { "type": "string", "minLength": 3, "maxLength": 64, "description": "Arrival airport or city: a 3-letter IATA airport/metro code (ABJ, DSS, LOS, CDG, LON, NYC) or a plain name (\"Abidjan\", \"Paris\").", "examples": [ "CDG", "LON", "Nairobi" ] }, "departureDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "Outbound date, YYYY-MM-DD.", "examples": [ "2026-12-18" ] }, "returnDate": { "description": "Return date YYYY-MM-DD. Omit for one-way.", "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "examples": [ "2026-12-18" ] }, "flexDays": { "description": "Also search ± this many days around the dates. 3 finds the cheapest fare that exists.", "type": "integer", "minimum": 0, "maximum": 10 }, "nearbyAirports": { "description": "Include metro and alternate airports (LON, PAR, NYC, DKR/DSS, LOS/ABV, ACC/KMS). Default true.", "type": "boolean" }, "stitchSelfTransfer": { "description": "Combine one-way tickets through hubs (CMN, LFW, LIS, IST…) when cheaper. Default true.", "type": "boolean" }, "adults": { "description": "Adults (12+). Default 1.", "type": "integer", "minimum": 1, "maximum": 9 }, "children": { "description": "Children (2–11). Default 0.", "type": "integer", "minimum": 0, "maximum": 8 }, "infants": { "description": "Infants on lap (<2). Default 0.", "type": "integer", "minimum": 0, "maximum": 4 }, "currency": { "description": "ISO 4217 display currency. Default EUR. XOF is shown as FCFA.", "examples": [ "EUR", "USD", "XOF", "NGN", "GBP" ], "type": "string", "pattern": "^[A-Za-z]{3}$" }, "cabinClass": { "description": "Cabin. Default economy.", "type": "string", "enum": [ "economy", "premium_economy", "business", "first" ] }, "checkedBagsPerAdult": { "description": "Checked bags per adult to price in. Default 0.", "type": "integer", "minimum": 0, "maximum": 2 }, "allowSelfTransfer": { "description": "Allow self-transfer itineraries. Default true.", "type": "boolean" }, "maxStops": { "description": "Maximum stops per direction. 0 = direct only.", "type": "integer", "minimum": 0, "maximum": 4 }, "limit": { "description": "Max offers returned. Default 20.", "type": "integer", "minimum": 1, "maximum": 50 } }, "required": [ "origin", "destination", "departureDate" ] } ``` ### 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. ```json { "type": "object", "properties": { "origin": { "type": "string", "minLength": 3, "maxLength": 64, "description": "Departure airport or city: a 3-letter IATA airport/metro code (ABJ, DSS, LOS, CDG, LON, NYC) or a plain name (\"Abidjan\", \"Paris\").", "examples": [ "ABJ", "DSS", "Lagos" ] }, "destination": { "type": "string", "minLength": 3, "maxLength": 64, "description": "Arrival airport or city: a 3-letter IATA airport/metro code (ABJ, DSS, LOS, CDG, LON, NYC) or a plain name (\"Abidjan\", \"Paris\").", "examples": [ "CDG", "LON", "Nairobi" ] }, "month": { "type": "string", "pattern": "^\\d{4}-\\d{2}$", "description": "Month, YYYY-MM.", "examples": [ "2026-12" ] }, "currency": { "description": "ISO 4217 display currency. Default EUR. XOF is shown as FCFA.", "examples": [ "EUR", "USD", "XOF", "NGN", "GBP" ], "type": "string", "pattern": "^[A-Za-z]{3}$" } }, "required": [ "origin", "destination", "month" ] } ``` ### 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"}. ```json { "type": "object", "properties": { "origin": { "type": "string", "minLength": 3, "maxLength": 64, "description": "Departure airport or city: a 3-letter IATA airport/metro code (ABJ, DSS, LOS, CDG, LON, NYC) or a plain name (\"Abidjan\", \"Paris\").", "examples": [ "ABJ", "DSS", "Lagos" ] }, "month": { "description": "Travel month, YYYY-MM. Default: next 30 days.", "type": "string", "pattern": "^\\d{4}-\\d{2}$", "examples": [ "2026-12" ] }, "budget": { "description": "Max price per person in the display currency.", "type": "number", "minimum": 0 }, "currency": { "description": "ISO 4217 display currency. Default EUR. XOF is shown as FCFA.", "examples": [ "EUR", "USD", "XOF", "NGN", "GBP" ], "type": "string", "pattern": "^[A-Za-z]{3}$" } }, "required": [ "origin" ] } ``` ### 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. ```json { "type": "object", "properties": { "id": { "type": "string", "minLength": 4, "description": "Offer id returned by search_flights (offers[].id). Valid for about 30 minutes." } }, "required": [ "id" ] } ``` ### 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"}. ```json { "type": "object", "properties": { "id": { "type": "string", "minLength": 4, "description": "Offer id returned by search_flights (offers[].id). Valid for about 30 minutes." } }, "required": [ "id" ] } ``` ### list_flight_sources Which flight data sources are live right now (Kiwi.com, Duffel, Aviasales) and cache status. No input. ```json { "type": "object", "properties": {} } ``` ### 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. ```json { "type": "object", "properties": { "name": { "type": "string", "minLength": 2, "maxLength": 80, "description": "Your agent or app name, e.g. \"Trip planner GPT\"." }, "client": { "description": "Host client, e.g. claude, chatgpt, cursor, codex. Used for attribution.", "type": "string", "maxLength": 30 }, "website": { "description": "Optional homepage of the agent or app.", "type": "string", "format": "uri" }, "contact": { "description": "Optional developer email for key notices. Never shared.", "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } }, "required": [ "name" ] } ``` ### 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. ```json { "type": "object", "properties": { "email": { "description": "Where the receipt and lifetime MCP token are sent. Required only when a paid unlock is on.", "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "payCurrency": { "description": "Price basis currency for the paid unlock (EUR or USD). Default EUR.", "type": "string", "enum": [ "EUR", "USD" ] }, "chargeCurrency": { "description": "Currency actually charged. XOF uses the fixed EUR peg. Default = payCurrency.", "type": "string", "enum": [ "EUR", "USD", "XOF" ] } } } ```