AENA Flights MCP

Name: AENA Flights MCP
Author: MrGo2

by MrGo2version 0.1.3i★ –iRuns on your computer

Registry nameio.github.MrGo2/aena-mcp

Install

Overview

Description from the maker (original English)

Flight data for Spain's 50 AENA airports over the public and OAuth2 REST APIs

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Travel, maps & weather
You need to fill in: AENA_CLIENT_SECRET

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: AENA_CLIENT_SECRET, AENA_CLIENT_ID, AENA_TENANT_ID

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "aena": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aena"
      ],
      "env": {
        "AENA_CLIENT_SECRET": "your-value",
        "AENA_CLIENT_ID": "your-value",
        "AENA_TENANT_ID": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add aena --env AENA_CLIENT_SECRET=your-value --env AENA_CLIENT_ID=your-value --env AENA_TENANT_ID=your-value -- npx -y mcp-aena

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "aena": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aena"
      ],
      "env": {
        "AENA_CLIENT_SECRET": "your-value",
        "AENA_CLIENT_ID": "your-value",
        "AENA_TENANT_ID": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "aena": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-aena"
      ],
      "env": {
        "AENA_CLIENT_SECRET": "your-value",
        "AENA_CLIENT_ID": "your-value",
        "AENA_TENANT_ID": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

AENA_CLIENT_SECRET secret env
OAuth2 client secret for the REST API. Omit for website-only mode (still fully functional for discovery).
AENA_CLIENT_ID env
OAuth2 client id. Has a working default.
AENA_TENANT_ID env
Azure AD tenant id. Has a working default.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account MrGo2, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Travel, maps & weatheri

More stars than 0% of the other 1706 servers in this category
Published to the registry more recently than 25% of the other 1706 servers in this category
Basic checks equal to or better than 100% of the other 1706 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is AENA Flights MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: AENA_CLIENT_SECRET

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.3) reached the registry 3 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: CGC Airport Transfers, Flightaware MCP, Killbottleneck

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

CGC Airport Transfers

by cgctransfers.com.au

Fixed-price quotes and bookings for private airport transfers: Gold Coast, Brisbane, Byron Bay.

Runs in the cloudUpdated today

Install

Flightaware MCP

by chrischall

Live flight tracking and aviation data via FlightAware AeroAPI (flights, airports, alerts).

Runs on your computerUpdated today

Install

Killbottleneck

by tengolabs

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

✈️ AENA Flights MCP

Español: [README.es.md](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](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=AENA%20Flights&connectorUrl=https%3A%2F%2Faena-mcp.carlos-ls.workers.dev%2Fmcp)

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):

Settings → Apps → Advanced settings → enable Developer mode
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

How	For whom	Setup
☁️ Remote connector (above)	Everyone, iPhone included	One click
📦 Desktop extension	Claude Desktop	Download `aena-mcp.mcpb` from the latest release, double click
🟩 npm	Claude Code, Cursor, any MCP client	`npx mcp-aena`
🔧 From source	Developers	See below

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

pnpm install

pnpm build # tsc → dist/ pnpm test # unit tests over captured fixtures, no network, no credentials pnpm inspect # drive a live stdio session with the MCP inspector

Copy .env.example to .env. The website API needs nothing. For the REST API set AENA_CLIENT_SECRET; AENA_CLIENT_ID and AENA_TENANT_ID already have working defaults.

The public remote server lives in worker/ (Cloudflare Workers, Streamable HTTP, no auth). To host your own:

cd worker

pnpm install npx wrangler deploy npx wrangler secret put AENA_CLIENT_SECRET # optional, enables the REST source

Parsing lives in pure normalizers (normalizeWebsiteRow, normalizeRestRow) so the mapping is tested without a live call. See CONTRIBUTING.md.

CI runs the tests on Node 20 and 22 plus an MCP inspector smoke. Tagged pushes (v*) publish to npm (OIDC trusted publishing), the MCP Registry, and attach a .mcpb bundle to the GitHub release.

📝 Notes on the data

Arrivals is "A" in the REST API but "L" in the website API. The server hides this.
The REST airlineIATA field actually carries the ICAO code. The server resolves both.
Flight numbers differ by source: the REST API names flights by ICAO (VLG1674), the website by IATA (VY1674).
Neither API filters by flight number on the server, so searches pull the whole airport and filter locally.
Neither gives real takeoff or landing times, only scheduled and estimated. For wheels-off and wheels-on you need a source like FlightRadar24.

📄 License

MIT

AENA Flights MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Travel, maps & weatheri

Common questions

Alternatives

CGC Airport Transfers

Flightaware MCP

Killbottleneck

README from the maker

✈️ AENA Flights MCP

🚀 Use it in 30 seconds (no install)

🤖 Also works in ChatGPT

💬 Things you can ask

🖥️ Other ways to run it

🧰 Tools

🔀 Why two APIs

🛠️ From source

📝 Notes on the data

📄 License