{"$schema":"https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json","version":"1.0","protocolVersion":"2025-06-18","serverInfo":{"name":"agent-flights","title":"Agent Flights","version":"1.2.0"},"description":"Agent Flights: cheapest flights worldwide, strong on Africa","iconUrl":"https://lowest.flights/icon.svg","documentationUrl":"https://lowest.flights/connect","transport":{"type":"streamable-http","endpoint":"/mcp","url":"https://lowest.flights/mcp"},"capabilities":{"tools":{"listChanged":false},"resources":{"listChanged":false},"prompts":{"listChanged":false}},"authentication":{"required":false,"schemes":["bearer"]},"instructions":"Agent Flights: cheapest flights worldwide, strong on Africa (Abidjan, Dakar, Lagos, Accra, Nairobi…). Use search_flights for a route and dates; pass flexDays=3 unless the date is fixed. Use find_cheapest_dates for the cheapest day in a month and explore_cheap_destinations when the destination is open. Always show cheapest and cheapestSensible. Warn on separateTickets (self-transfer) and on indicative/cached prices. Send travellers to bookingLink (a lowest.flights redirect to the best partner; also returned by get_booking_link). Offers expire about 30 minutes after search. No key needed (guest limits apply); call register_agent once for your own API key, higher limits and click attribution, then send Authorization: Bearer <apiKey>. Read agent-flights://docs/getting-started for the full guide; prompts cheapest_trip, flexible_dates and explore_from_city show the tool sequence. All tools are free for now; no key or payment needed.","tools":[{"name":"search_flights","title":"Search cheapest flights","description":"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}.","inputSchema":{"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"]},"annotations":{"title":"Search cheapest flights","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"find_cheapest_dates","title":"Find cheapest dates","description":"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.","inputSchema":{"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"]},"annotations":{"title":"Find cheapest dates","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"explore_cheap_destinations","title":"Explore cheap destinations","description":"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\"}.","inputSchema":{"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"]},"annotations":{"title":"Explore cheap destinations","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_flight_offer","title":"Get flight offer","description":"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.","inputSchema":{"type":"object","properties":{"id":{"type":"string","minLength":4,"description":"Offer id returned by search_flights (offers[].id). Valid for about 30 minutes."}},"required":["id"]},"annotations":{"title":"Get flight offer","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_booking_link","title":"Get booking link","description":"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\"}.","inputSchema":{"type":"object","properties":{"id":{"type":"string","minLength":4,"description":"Offer id returned by search_flights (offers[].id). Valid for about 30 minutes."}},"required":["id"]},"annotations":{"title":"Get booking link","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"list_flight_sources","title":"List flight sources","description":"Which flight data sources are live right now (Kiwi.com, Duffel, Aviasales) and cache status. No input.","inputSchema":{"type":"object","properties":{}},"annotations":{"title":"List flight sources","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"register_agent","title":"Register agent (get API key)","description":"Self-register this agent and get an Agent Flights API key instantly (free; no email confirmation). Use it as Authorization: Bearer <apiKey> (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.","inputSchema":{"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"]},"annotations":{"title":"Register agent","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"unlock_mcp","title":"MCP access (free for now)","description":"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.","inputSchema":{"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"]}}},"annotations":{"title":"MCP access (free for now)","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}],"resources":[{"name":"getting-started","uri":"agent-flights://docs/getting-started","title":"Getting started","description":"How to use the Agent Flights tools: recommended sequence, places, currencies.","mimeType":"text/markdown"},{"name":"booking","uri":"agent-flights://docs/booking","title":"Booking, affiliate links and warnings","description":"How booking works (partner sites, affiliate disclosure, self-transfer and cached-price warnings).","mimeType":"text/markdown"},{"name":"errors","uri":"agent-flights://docs/errors","title":"Tool errors","description":"Error messages the tools return and what to do about each one.","mimeType":"text/markdown"},{"name":"sources","uri":"agent-flights://sources","title":"Live fare sources","description":"Which fare sources (Kiwi.com, Duffel, Aviasales) are live right now, and why any is off.","mimeType":"application/json"},{"name":"markets","uri":"agent-flights://markets","title":"Supported markets","description":"Curated countries, cities and airports (strongest in Africa), self-transfer hubs and currencies.","mimeType":"application/json"},{"name":"popular-routes","uri":"agent-flights://routes/popular","title":"Popular routes","description":"High-demand routes with a landing page on lowest.flights.","mimeType":"application/json"}],"prompts":[{"name":"cheapest_trip","title":"Cheapest trip","description":"Find the cheapest sensible flight for a route and dates, then get the booking link.","arguments":[{"name":"origin","description":"From: IATA code or city name, e.g. ABJ, Dakar, LOS.","required":true},{"name":"destination","description":"To: IATA code or city name, e.g. ABJ, Dakar, LOS.","required":true},{"name":"departureDate","description":"Outbound date, YYYY-MM-DD.","required":true},{"name":"returnDate","description":"Return date, YYYY-MM-DD. Omit for one-way.","required":false},{"name":"currency","description":"Display currency, e.g. EUR, XOF, NGN.","required":false}]},{"name":"flexible_dates","title":"Flexible dates","description":"Find the cheapest days to fly a route in a given month.","arguments":[{"name":"origin","description":"From: IATA code or city name, e.g. ABJ, Dakar, LOS.","required":true},{"name":"destination","description":"To: IATA code or city name, e.g. ABJ, Dakar, LOS.","required":true},{"name":"month","description":"Travel month, YYYY-MM.","required":true},{"name":"currency","description":"Display currency, e.g. EUR, XOF.","required":false}]},{"name":"explore_from_city","title":"Explore from a city","description":"Where can I go cheaply from my city, optionally under a budget?","arguments":[{"name":"origin","description":"From: IATA code or city name, e.g. ABJ, Dakar, LOS.","required":true},{"name":"month","description":"Travel month, YYYY-MM. Default: next 30 days.","required":false},{"name":"budget","description":"Max price per person, a number in the display currency.","required":false},{"name":"currency","description":"Display currency, e.g. EUR, XOF.","required":false}]}]}