# ourairports-mcp-server

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1344 installs · ★ 1 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/ourairports-mcp-server
- Updated: 2026-10-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ourairports-mcp-server

## What it 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.

## Requirements
- Remote server: `https://ourairports-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http ourairports-mcp-server https://ourairports-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add ourairports-mcp-server --url https://ourairports-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ourairports-mcp-server": {
            "url": "https://ourairports-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ourairports-mcp-server": {
            "type": "http",
            "url": "https://ourairports-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http ourairports-mcp-server https://ourairports-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- 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.

## Similar
- [Ignav Flights](https://affpapa.org/en/nevibecode/mcp/ignav-flights.md) — MCP server · 7205 installs
- [Airport Lounge List](https://affpapa.org/en/nevibecode/mcp/airport-lounge-list.md) — MCP server
- [The Local Intel](https://affpapa.org/en/nevibecode/mcp/the-local-intel.md) — MCP server · 2761 installs
- [WorldMonitor MCP](https://affpapa.org/en/nevibecode/mcp/worldmonitor-mcp.md) — MCP server · 2840 installs
- [faa-aircraft-registry-mcp-server](https://affpapa.org/en/nevibecode/mcp/faa-aircraft-registry-mcp-server.md) — MCP server · 1820 installs
- [google-flights](https://affpapa.org/en/nevibecode/mcp/google-flights.md) — MCP server · ★ 81 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
