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
claude mcp add --transport http ourairports-mcp-server https://ourairports-mcp-server--cyanheads.run.toolsWhat 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
UUDDand show its runways and frequencies. - Which airports sit closest to this coordinate? Rank them by distance.
- Pull the runways with
aspsurface 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.toolsPlatform CLI: remote server
codex mcp add ourairports-mcp-server --url https://ourairports-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"ourairports-mcp-server": {
"url": "https://ourairports-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"ourairports-mcp-server": {
"type": "http",
"url": "https://ourairports-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http ourairports-mcp-server https://ourairports-mcp-server--cyanheads.run.toolsStep 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.