# ourairports-mcp-server [Health: Active]

**Category:** 🚀 Aerospace & Astrodynamics  
**Repository:** https://github.com/cyanheads/ourairports-mcp-server  
**GitHub Stars:** 1  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ourairports-mcp-server

## Description
Offline global aviation reference — airports, runways, navaids, frequencies from OurAirports.

## Tools
Capabilities this server exposes over MCP:

- **ourairports_search_airports** — Full-text and faceted search over the airport corpus by name, municipality, country, region, or type. Ranked summaries, closed airports excluded by default.
- **ourairports_search_runways** — Search runways across all airports by surface, length, width, and lighting, joined back to their airports and filtered by country, region, or airport type. One flat `{ airport, runway }` row per matching runway.
- **ourairports_get_airport** — Full record for one airport resolved by any code (IATA/ICAO/GPS/local/ident), with its runways and radio frequencies inline.
- **ourairports_find_airports** — Airports within a radius of a coordinate, ranked nearest-first by great-circle distance, with distance and bearing.
- **ourairports_find_navaids** — Navigation aids (VOR, VOR-DME, DME, NDB, NDB-DME, TACAN, VORTAC) near a coordinate or serving a specific airport.
- **ourairports_list_countries** — Countries with airport counts and optional nested regions, filtered by country and/or continent. The lookup table for valid `country`/`region` filters on both search tools.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `bunx` (confidence: high):

```json
"mcpServers": {
  "ourairports-mcp-server": {
    "command": "bunx",
    "args": ["@cyanheads/ourairports-mcp-server@latest"]
  }
}
```

## Documentation

## What ourairports-mcp-server MCP server does

The ourairports-mcp-server MCP server provides agent access to airports, runways, navigation aids, radio frequencies, countries, and regions from the bundled public-domain OurAirports dataset. It is intended for aviation reference and lookup tasks rather than live operational data. The package exposes six tools and an `airport://{code}` resource for retrieving a single airport record.

Airport records can be resolved through IATA, ICAO, GPS, local, or ident codes. Returned airport data can include runways and radio frequencies, along with the identifiers used for resolution. The dataset is bundled, so lookup does not require a live connection to OurAirports.

## How it works

The ourairports-mcp-server MCP server accepts MCP tool calls over STDIO or Streamable HTTP. Airport searches support free text and filters for municipality, country, region, and airport type. Runway searches first narrow airports with airport-level filters, then apply runway properties such as surface, minimum length, minimum width, and lighting.

Coordinate-based tools use latitude and longitude supplied by the caller. Nearby airports and navaids are ranked by great-circle distance and include distance and bearing. The server does not geocode place names, so an upstream component must convert a place name into coordinates first.

The `airport://{code}` resource and `ourairports_get_airport` tool provide overlapping single-airport access. Tool-only clients can use the airport tool without resource support.

## Setup and configuration

The repository provides installation links for Claude Desktop, Cursor, and VS Code. The Cursor and VS Code configurations use `npx -y @cyanheads/ourairports-mcp-server`, and the project also publishes a public Streamable HTTP endpoint at `https://ourairports.caseyjhand.com/mcp`.

No required environment variables are documented. Search tools use `OURAIRPORTS_DEFAULT_SEARCH_LIMIT` as the default result limit when configured; individual tool limits and maximums still apply. Search results default to excluding closed airports, while airport-code resolution can return closed airports.

## Tools and capabilities

- Search airports by text and facets, with ranked summaries and airport codes.
- Search runways by surface, dimensions, lighting, country, region, and airport type.
- Resolve a complete airport record from any supported code.
- Find airports within a coordinate radius with distance and bearing.
- Find VOR, VOR-DME, DME, NDB, NDB-DME, TACAN, and VORTAC facilities by location or airport.
- List countries with airport counts and optionally nested regions.

Result limits, truncation details, validation errors, and empty-result guidance are returned by the tools. Country and region filters are checked against bundled lookup tables.

## Limitations and notes

Runway length represents the full surface recorded by OurAirports, including displaced thresholds and overruns; it is not a usable takeoff or landing distance. Unknown runway dimensions do not satisfy minimum-dimension filters. Surface matching is a case-insensitive substring match against the upstream text, not a controlled vocabulary.

Nearby searches require coordinates and do not perform geocoding. Radius-based airport and navaid queries support distances up to 500 km, with result caps defined by each tool. The data is a bundled reference dataset, so the material does not establish that records are current operational information.

_Full upstream README: https://allmcps.com/mcp/ourairports-mcp-server/readme_