Skip to content

lomiafrica/agent-flights

v1.2.2MIT

Cheapest flights worldwide, strong on Africa: search fares, find the cheapest dates or destinations, and hand travellers a booking link. Free remote MCP, no key needed.

Agent Flights MCP

Cheapest flights worldwide, strong on Africa, for AI agents. Agent Flights (lowest.flights) is a free remote MCP server and REST API that compares live and cached fares from several sources and booking sites, expands nearby airports, combines self-transfer one-ways when cheaper, and returns the cheapest all-in fare plus a cheapest-sensible alternative (no 20h layovers or risky overnight transfers).

Tools

ToolWhat it does
search_flightsCheapest fare + cheapest-sensible alternative for a route and dates (one-way/return, passengers, cabin, bags, flexDays).
find_cheapest_datesPrice calendar: cheapest fare per day of a month on one route.
explore_cheap_destinationsCheapest destinations from an origin for a month, optionally under a budget.
get_flight_offerFull details of one offer: legs, layovers, baggage, fees, warnings.
get_booking_linkBooking link that redirects to the best bookable booking site.
list_flight_sourcesWhich flight data sources are live right now.
register_agentSelf-register your agent and get an af_live_ API key instantly (no email).
unlock_mcpReturns a notice that MCP is free; creates no checkout.

Install

Any client that supports remote MCP (Claude.ai, ChatGPT connectors, Cursor, VS Code, Windsurf…)

Use the URL https://lowest.flights/mcp.

Cursor (~/.cursor/mcp.json)

{ "mcpServers": { "agent-flights": { "url": "https://lowest.flights/mcp" } } }

VS Code (.vscode/mcp.json)

{ "servers": { "agent-flights": { "type": "http", "url": "https://lowest.flights/mcp" } } }

Claude Code

claude mcp add --transport http agent-flights https://lowest.flights/mcp

Claude (claude.ai, Desktop, mobile)

Settings → Connectors → Add custom connector → https://lowest.flights/mcp (no sign-in).

ChatGPT

Settings → Apps → Advanced settings → Developer mode → Create app → https://lowest.flights/mcp, Authentication: none.

Grok and Grok Bot

  • grok.com: Connectors → New Connector → Custom → https://lowest.flights/mcp.
  • Grok CLI: grok mcp add --transport http agent-flights https://lowest.flights/mcp
  • Grok Bot: ask “Add a custom MCP server called agent-flights at https://lowest.flights/mcp” and approve the card.

Codex CLI (~/.codex/config.toml)

[mcp_servers.agent_flights]
url = "https://lowest.flights/mcp"

Gemini CLI

gemini extensions install https://github.com/lomiafrica/agent-flights-mcp

Plugin (Cursor, Claude Code, Codex)

This repo is also an agent plugin: .cursor-plugin/plugin.json, .claude-plugin/plugin.json (+ marketplace.json), .codex-plugin/plugin.json, root plugin.json, mcp.json and the skills/agent-flights skill. Claude Code:

/plugin marketplace add lomiafrica/agent-flights-mcp
/plugin install agent-flights@agent-flights

Framework quickstarts

Vercel AI SDK, OpenAI Agents SDK, Claude Agent SDK, LangChain, CrewAI, Google ADK and the xAI API: lowest.flights/agents#frameworks.

Claude Desktop, Cline, Windsurf, or any stdio-only client

{
  "mcpServers": {
    "agent-flights": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://lowest.flights/mcp"]
    }
  }
}

Or use the tiny stdio bridge in this repo (bin/agent-flights-mcp.js, wraps mcp-remote):

{
  "mcpServers": {
    "agent-flights": {
      "command": "npx",
      "args": ["-y", "github:lomiafrica/agent-flights-mcp"],
      "env": { "AGENT_FLIGHTS_API_KEY": "optional af_live_ key" }
    }
  }
}

Optional API key

Call the register_agent tool, or:

curl -X POST https://lowest.flights/api/v1/agents/register \
  -H 'content-type: application/json' -d '{"name":"My agent","client":"claude"}'

Send it as Authorization: Bearer <apiKey>. Keys raise limits and attribute booking clicks to your agent.

Example

"Find me the cheapest flight from Abidjan to Paris around 18 December, back 5 January."

{ "origin": "ABJ", "destination": "CDG", "departureDate": "2026-12-18", "returnDate": "2027-01-05", "flexDays": 3, "currency": "XOF" }

Privacy Policy

Agent Flights receives only the tool arguments your agent sends (route, dates, passengers, cabin, currency), plus IP address and client name for rate limits. It collects no traveller names, IDs, payment data or conversation history. Search caches expire within about 24 hours; usage counters within 3 days. Full policy: https://lowest.flights/privacy · Terms: https://lowest.flights/terms

Support

Email babacar@lowest.flights or open an issue in this repository.

About

Built by lomi. (LOMI. INC). Agent Flights earns a partner commission on bookings and never adds a booking fee. This repo holds the public install material; the hosted server runs at lowest.flights.

License: MIT