AENA Flights MCP server

✈️ AENA Flights MCP

Español: README.es.md

Live flight data for the 50 Spanish airports run by AENA, as an MCP server. Ask Claude things like "what departures leave Santiago this afternoon?" or "is IB0459 delayed?" and it answers from real airport data: times, gates, terminals, aircraft, status and codeshares.

It puts both of AENA's flight APIs behind one clean set of tools, so an agent asks for flights and gets back the same flight shape no matter which API answered.

🚀 Use it in 30 seconds (no install)

The server runs publicly at https://aena-mcp.carlos-ls.workers.dev/mcp. Add it to Claude with one click:

➕ Add to Claude

That link opens claude.ai with the connector prefilled; just confirm. Works on every plan, Free included, and once added it is available in the Claude apps too, phone included. No account, no API key, nothing to configure.

Prefer to add it by hand? Claude → Settings → Connectors → Add custom connector, name it AENA Flights and paste the URL above.

🤖 Also works in ChatGPT

ChatGPT has no one-click install link, but the same server works there (Plus, Pro and Business plans, web only):

1. Settings → Apps → Advanced settings → enable Developer mode
2. In the Apps panel press + and add the server with URL https://aena-mcp.carlos-ls.workers.dev/mcp, authentication: none

💬 Things you can ask

• 🛫 "Departures from MAD between 16:00 and 18:00"
• 🛬 "What flights arrive at BCN from London tomorrow afternoon?"
• 🔍 "Where is flight UX7235 right now, which gate?"
• 🏝️ "List all AENA airports in the Canary Islands"

🖥️ Other ways to run it

Config for npm-based clients:

{
  "mcpServers": {
    "aena": {
      "command": "npx",
      "args": ["-y", "mcp-aena"]
    }
  }
}

For Claude Code it is one command:

claude mcp add aena -- npx -y mcp-aena

🧰 Tools

• search_flights — arrivals or departures for an airport. Filter by flight number, by date, or by a local-time window (afternoon = fromLocal 12:00, toLocal 20:00). Codeshares of the same physical flight collapse into one entry, and every time in the output is local Madrid time.
• get_flight — one flight by number at an airport.
• list_airports — every AENA airport with IATA/ICAO codes, fetched live.

🔀 Why two APIs

AENA exposes two ways to read flights, and each covers a gap the other leaves open.

• 🌐 The website API is public and needs no credentials. It sees roughly 14 days ahead but has no past data. Good for discovery.
• 🔐 The REST API uses OAuth2 and needs a client secret. It sees about 54 hours into the past and 24 ahead, and tells you the real operating flight behind a codeshare. Good for tracking.

The server picks the right one for you (source: "auto"), or you can force either. Without a secret it runs in website-only mode and still works. The public remote server has full REST access already configured.

🛠️ From source

Shortened. The full README is on GitHub.