Ryanair MCP Server - Public API Documentation

Getting Started

The public MCP server provides read-only access to Ryanair flight data. No authentication is required.

Endpoint: https://services-api.ryanair.com/mcp-server/mcp

Connect with Claude.ai

Add the connector

Go to claude.ai/settings/connectors and add a new MCP connector with the endpoint URL above.

Start using it

Ask Claude to search for flights, e.g. "Find the cheapest flights from Dublin to Warsaw next week". Claude will use the tools automatically and display interactive results.

Connect with VS Code / Cursor

Add the following to your .vscode/mcp.json or IDE MCP settings:

{
  "servers": {
    "ryanair": {
      "type": "http",
      "url": "https://services-api.ryanair.com/mcp-server/mcp"
    }
  }
}

Connect with any MCP client

The server supports Streamable HTTP transport. Point any MCP-compatible client to the endpoint URL above.

Tools (7)

All tools are read-only and return real-time data from Ryanair. Flight results include direct booking links to ryanair.com.

`search-routes`

Search available Ryanair routes from a given airport. Returns a list of destinations with airport codes, names, and countries.

Parameter	Type	Required	Description
`origin`	string	Required	IATA code of departure airport (e.g. `WRO`)

`locate-get-active-airports`

Interactive Map

List active Ryanair airports shown on an interactive map, with IATA codes, cities, countries, and coordinates. Optionally filter by country.

Parameter	Type	Required	Description
`countryCodes`	string	Optional	Comma-separated ISO 2-letter country codes (e.g. `pl,ie,es`). Omit to return all airports.

`locate-get-routes`

Interactive Map

Get available Ryanair routes from a given airport, shown on an interactive map with route lines. Optionally filter by arrival country.

Parameter	Type	Required	Description
`departureIataCode`	string	Required	Departure IATA code (e.g. `DUB`)
`arrivalCountryCodes`	string	Optional	Comma-separated ISO 2-letter country codes to filter arrivals (e.g. `es,gb,it`)

`locate-search-connections`

Interactive UI

Search for connecting flights between two airports without a direct route. Returns journey options with intermediate stops, layover times, and total duration.

Parameter	Type	Required	Description
`origin`	string	Required	Departure airport IATA code (e.g. `WRO`)
`destination`	string	Required	Arrival airport IATA code (e.g. `MAD`)
`dateFrom`	string	Required	Start of date range (`YYYY-MM-DD`)
`dateTo`	string	Optional	End of date range (`YYYY-MM-DD`). Defaults to `dateFrom`.
`maxLayover`	string	Optional	Maximum layover time in hours (1-12). Defaults to 6.

`pricing-get-cheapest-one-way-flight`

Flight Cards

Find the cheapest one-way Ryanair flights for a date range. Filter by departure/arrival airports or countries, day of week, time of day, and flight duration. Returns interactive flight cards with prices and booking links.

Parameter	Type	Required	Description
`outboundDepartureDateFrom`	string	Required	Start date (`YYYY-MM-DD`)
`outboundDepartureDateTo`	string	Required	End date (`YYYY-MM-DD`)
`departureIataCodes`	string	Optional	Departure IATA codes (e.g. `WAW,KRK`)
`departureCountryCodes`	string	Optional	Departure country codes (e.g. `pl,de`)
`arrivalIataCodes`	string	Optional	Arrival IATA codes (e.g. `STN,DUB`)
`arrivalCountryCodes`	string	Optional	Arrival country codes (e.g. `es,it`)
`excludedDepartureIataCodes`	string	Optional	IATA codes to exclude from departure
`excludedArrivalIataCodes`	string	Optional	IATA codes to exclude from arrival
`outboundDepartureDaysOfWeek`	string	Optional	Filter by day (e.g. `MONDAY,FRIDAY`)
`outboundDepartureTimeFrom`	string	Optional	Earliest departure time (e.g. `08:00`)
`outboundDepartureTimeTo`	string	Optional	Latest departure time (e.g. `20:00`)
`currency`	string	Optional	Currency code (e.g. `EUR`)
`limit`	integer	Optional	Max results per page
`pageNumber`	integer	Optional	Page number (0-based)

`pricing-get-cheapest-round-trip-flights`

Flight Cards

Find the cheapest round-trip Ryanair flights. Filter by airports, countries, days of week, time, trip duration, and max price. Returns paired outbound + return flight cards with booking links.

Parameter	Type	Required	Description
`outboundDepartureDateFrom`	string	Required	Outbound start date (`YYYY-MM-DD`)
`outboundDepartureDateTo`	string	Required	Outbound end date (`YYYY-MM-DD`)
`inboundDepartureDateFrom`	string	Required	Return start date (`YYYY-MM-DD`)
`inboundDepartureDateTo`	string	Required	Return end date (`YYYY-MM-DD`)
`departureAirportIataCodes`	string	Optional	Departure IATA codes (e.g. `WAW,KRK`)
`departureCountryCodes`	string	Optional	Departure country codes (e.g. `pl,de`)
`arrivalAirportIataCodes`	string	Optional	Arrival IATA codes
`arrivalCountryCodes`	string	Optional	Arrival country codes (e.g. `es,it`)
`tripDurationFrom`	number	Optional	Minimum trip duration in days
`tripDurationTo`	number	Optional	Maximum trip duration in days
`priceValueTo`	number	Optional	Maximum total price
`currency`	string	Optional	Currency code (e.g. `EUR`)
Also supports: day-of-week filters, time filters, excluded airports, pagination (same as one-way)

`pricing-get-cheapest-flight-per-day`

Price Calendar

Find the cheapest Ryanair flight for each day on a specific route. Returns an interactive price calendar with daily prices, cheapest days highlighted, and booking links.

Parameter	Type	Required	Description
`departureIataCode`	string	Required	Departure IATA code (e.g. `WAW`)
`arrivalIataCode`	string	Required	Arrival IATA code (e.g. `DUB`)
`outboundDepartureDateFrom`	string	Required	Start date (`YYYY-MM-DD`)
`outboundDepartureDateTo`	string	Required	End date (`YYYY-MM-DD`)
`outboundDepartureTimeFrom`	string	Optional	Earliest departure time (e.g. `08:00`)
`outboundDepartureTimeTo`	string	Optional	Latest departure time (e.g. `20:00`)
`flightDurationTo`	number	Optional	Maximum flight duration in minutes
`currency`	string	Optional	Currency code (e.g. `EUR`)

MCP Apps (Interactive UIs)

Six of the seven tools return interactive UI components via the MCP Apps protocol. These render as rich widgets inside supported clients (Claude.ai, VS Code).

Airport & Route Map

ui://show-ryanair-map

Interactive OpenStreetMap with airport markers and route lines. Used by locate-get-active-airports and locate-get-routes.

Connections View

ui://show-ryanair-connections

Connecting flight itineraries grouped by date with layover details. Used by locate-search-connections.

Flight Offer Cards

ui://show-ryanair-flight-offers

Flight cards with prices, times, and booking links. Used by one-way and round-trip search tools.

Price Calendar

ui://show-ryanair-price-calendar

Calendar grid showing daily prices with cheapest days highlighted. Used by pricing-get-cheapest-flight-per-day.

Server Capabilities

Tools Resources (read-only) MCP Apps Streamable HTTP SSE Streaming

Protocol Details

Server Name	`ryanair-flight-search`
Version	`1.0.0`
Transport	Streamable HTTP (`POST /mcp-server/mcp`)
Authentication	None (public)
Resource Subscriptions	Not supported
MCP Apps (Claude.ai)	`experimental.mcpApps`
MCP Apps (VS Code)	`extensions["io.modelcontextprotocol/ui"]`

Ryanair MCP Server Public

Getting Started

Connect with Claude.ai

Add the connector

Start using it

Connect with VS Code / Cursor

Connect with any MCP client

Tools (7)

search-routes

locate-get-active-airports

locate-get-routes

locate-search-connections

pricing-get-cheapest-one-way-flight

pricing-get-cheapest-round-trip-flights

pricing-get-cheapest-flight-per-day

MCP Apps (Interactive UIs)

Airport & Route Map

Connections View

Flight Offer Cards

Price Calendar

Server Capabilities

Protocol Details

`search-routes`

`locate-get-active-airports`

`locate-get-routes`

`locate-search-connections`

`pricing-get-cheapest-one-way-flight`

`pricing-get-cheapest-round-trip-flights`

`pricing-get-cheapest-flight-per-day`