ryanair-mcp
An MCP server that exposes Ryanair's anonymous flight APIs as tools an LLM can call.
Fare search · price calendars · timetables · the airport/route network — over stdio or streamable HTTP.
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
An MCP server that exposes Ryanair's anonymous flight APIs as tools an LLM can call.
Fare search · price calendars · timetables · the airport/route network — over stdio or streamable HTTP.
Unofficial MCP server exposing Ryanair's anonymous flight APIs (fares, calendars, timetables, network) as LLM tools. Go, stdio + HTTP.
[!WARNING] Unofficial. This project consumes Ryanair's public, unauthenticated endpoints and is not affiliated with or endorsed by Ryanair. The APIs are undocumented and may change or rate-limit without notice.
previous_price / price_updated /
new_route when Ryanair reports them, so callers can spot price drops and
newly-added routes.Requires Go 1.26+.
go build -o ryanair-mcp ./cmd/ryanair-mcp
# stdio (default) — for MCP clients that spawn the server as a subprocess
./ryanair-mcp
# streamable HTTP
./ryanair-mcp --transport http --addr :8080
For a stdio client (e.g. Claude Desktop), point it at the built binary:
{
"mcpServers": {
"ryanair": {
"command": "/absolute/path/to/ryanair-mcp"
}
}
}
Multi-arch images (linux/amd64, linux/arm64) are published to
GHCR
on every release, tagged with the version (e.g. 0.2.0), MAJOR.MINOR, and
latest.
# stdio (attach via -i so the client can speak over stdin/stdout)
docker run -i --rm ghcr.io/adambenhassen/ryanair-mcp:latest
# streamable HTTP
docker run --rm -p 8080:8080 ghcr.io/adambenhassen/ryanair-mcp:latest \
--transport http --addr :8080
Airport inputs are IATA codes (e.g. DUB, STN). Dates are ISO YYYY-MM-DD.
Currencies are ISO 4217 (e.g. EUR).
A SKILL.md ships under
skills/ryanair-flights/, following the Agent Skills
open standard (compatible with Claude, Hermes, Cursor, and Codex). It tells an
agent when to reach for this server and how to drive its tools. Point your
agent's skills directory at that folder, or copy it in.
403, so
the client warms a cookie jar against www.ryanair.com once before the first
request.list_airports and
explore_destinations is cached for 6 hours.429, 5xx, and network errors. Other failures surface immediately
as an APIError carrying the endpoint, status, and a body snippet.go test ./... # unit tests (parsing, quirks, retry classification, validation)
golangci-lint run # lint (strict config in .golangci.yml)
Tests run against recorded fixtures in internal/ryanair/testdata/ — no network
access required.
A build-tagged live smoke test hits the real Ryanair endpoints to catch
wire-format or endpoint drift. It is excluded from build/PR CI (so pull requests
never depend on Ryanair's availability) and instead runs on a daily schedule via
.github/workflows/live.yml. Run it locally too:
go test -tags live ./internal/ryanair/ -v
cmd/ryanair-mcp entry point, flag parsing, transport selection
internal/server builds the MCP server, runs stdio / streamable HTTP
internal/tools MCP tool definitions; clean domain types only
internal/ryanair typed client; all Ryanair wire-format quirks live here
409 without one. Bringing these in means
reverse-engineering and maintaining that auth flow — a larger, more fragile
effort tracked here as future scope, not yet started.Contributions are welcome — see CONTRIBUTING.md for the dev workflow and conventions, and SECURITY.md to report a vulnerability. Notable changes are tracked in CHANGELOG.md.
MIT © Adam Benhassen
Unofficial MCP server exposing Ryanair's anonymous flight APIs (fares, calendars, timetables, network) as LLM tools. Go, stdio + HTTP.
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Ryanair runs locally over stdio.
Last checked 2026-10-27. Unofficial MCP server exposing Ryanair's anonymous flight APIs (fares, calendars, timetables, network) as LLM tools. Go, stdio + HTTP.