Skip to main content
MCP server CX Codex

ourairports-mcp-server — Claude Code MCP server: airport lookup

An MCP server carrying the OurAirports dataset: airport records, runways, navaids and radio frequencies. Useful when an agent has to work out codes or coordinates offline.

Apache-2.0 1,344 installs ★ 1 updated 2026-10-19

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http ourairports-mcp-server https://ourairports-mcp-server--cyanheads.run.tools
Open on GitHub

What ourairports-mcp-server does

The server hands an agent an airport reference built on the OurAirports dataset, bundled so lookups run without network access. Any code, whether IATA, ICAO, GPS or local, resolves to a single record with runways and frequencies attached. Text search covers name, municipality, country, region and type; closed airports stay out of results unless you ask for them.

Runways get their own tool with filters on surface, length, width and lighting. Surface matching is a substring test against the raw upstream string, so asp catches ASP, ASPH and Asphalt alike. The length field describes the full paved surface, displaced thresholds and overruns included. That is not takeoff or landing distance. A runway with unknown length is dropped once a minimum filter is set.

Two deployment shapes exist: a hosted HTTP endpoint or a local npx process over STDIO. Coordinate queries come back with great-circle distance and bearing, and navaids can be found near a point or at a named airport.

What it helps with

  • resolve an airport from an IATA or ICAO code
  • filter runways by surface and minimum length inside a country
  • list airports within a radius of a coordinate
  • check which navaids serve a given airport
  • pull country and region codes to use as search filters

Example prompts for the agent

  • Find the airport with code UUDD and show its runways and frequencies.
  • Which airports sit closest to this coordinate? Rank them by distance.
  • Pull the runways with asp surface in this country and tell me which airports they belong to.

How to install ourairports-mcp-server

Platform CLI: remote server

claude mcp add --transport http ourairports-mcp-server https://ourairports-mcp-server--cyanheads.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about ourairports-mcp-server

How to install ourairports-mcp-server in Claude Code?

Run claude mcp add --transport http ourairports-mcp-server https://ourairports-mcp-server--cyanheads.run.tools. The server is then available to the agent in your session.

What does ourairports-mcp-server do?

It answers airport questions: resolves a record from any code, searches by name and facets, finds runways and navaids, and ranks airports near a coordinate.

Is the runway length field the takeoff distance?

No. It covers the whole runway surface, including displaced thresholds and overruns, so it does not give you usable takeoff or landing distance.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open