{"server":"Agent Flights","checked":"2026-11-22","tools":[{"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","$schema":"https://json-schema.org/draft/2020-12/schema","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":{"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","$schema":"https://json-schema.org/draft/2020-12/schema","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":{"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 /go URL to send the traveller to. It attributes the click to your agent. For separate tickets, tickets[] has one /go link each. Includes self-transfer and cached-price warnings to show the traveller. Example: {\"id\":\"off_8f2c1a\"}.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"id":{"type":"string","minLength":4,"description":"Offer id returned by search_flights (offers[].id). Valid for about 30 minutes."}},"required":["id"]},"annotations":{"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","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"id":{"type":"string","minLength":4,"description":"Offer id returned by search_flights (offers[].id). Valid for about 30 minutes."}},"required":["id"]},"annotations":{"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 and cache status. No input.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{}},"annotations":{"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","$schema":"https://json-schema.org/draft/2020-12/schema","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":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"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 live fares and cached data where available, expands nearby airports and combines self-transfer one-ways when cheaper. 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[] (each with bookingLink and bookingOptions on several booking sites), sources, notes}. Compact by default; view=full for every field.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","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 10 in compact view, 20 in full view.","type":"integer","minimum":1,"maximum":50},"view":{"description":"compact (default): about 500 bytes per offer (price in your currency, times, stops, carriers, flight numbers, warnings, one tracked bookingLink). full: every field incl. per-site bookingOptions and segment airport names.","type":"string","enum":["compact","full"]}},"required":["origin","destination","departureDate"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"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","$schema":"https://json-schema.org/draft/2020-12/schema","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":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}],"resources":[{"uri":"agent-flights://docs/getting-started","name":"getting-started","title":"Getting started","description":"How to use the Agent Flights tools: recommended sequence, places, currencies.","mimeType":"text/markdown"},{"uri":"agent-flights://docs/booking","name":"booking","title":"Booking, affiliate links and warnings","description":"How booking works (partner sites, affiliate disclosure, self-transfer and cached-price warnings).","mimeType":"text/markdown"},{"uri":"agent-flights://docs/errors","name":"errors","title":"Tool errors","description":"Error messages the tools return and what to do about each one.","mimeType":"text/markdown"},{"uri":"agent-flights://sources","name":"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"},{"uri":"agent-flights://markets","name":"markets","title":"Supported markets","description":"Curated countries, cities and airports (strongest in Africa), self-transfer hubs and currencies.","mimeType":"application/json"},{"uri":"agent-flights://routes/popular","name":"popular-routes","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."},{"name":"flexible_dates","title":"Flexible dates","description":"Find the cheapest days to fly a route in a given month."},{"name":"explore_from_city","title":"Explore from a city","description":"Where can I go cheaply from my city, optionally under a budget?"}]}