Log inSubmit server
Ourairports MCP Server logo

Ourairports MCP Server

Searches a bundled OurAirports dataset for airports, runways, navaids, frequencies, and nearby facilities.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Ourairports MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ourairports-mcp-server": {
      "command": "bunx",
      "args": [
        "@cyanheads/ourairports-mcp-server@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

bunx @cyanheads/ourairports-mcp-server@latest

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 2d ago.

Overview

The ourairports-mcp-server MCP server exposes the bundled public-domain OurAirports dataset through six MCP tools and one airport resource. It resolves airport identifiers, searches airport and runway records, finds nearby airports or navaids, and lists country and region metadata. The dataset is bundled for offline reference, while the server supports STDIO and Streamable HTTP. Use it when an agent needs structured aviation reference data without a separate geocoding or aviation database service.

Use cases

  • Resolve airport records from IATA, ICAO, GPS, local, or ident codes
  • Search airports by country, region, type, or municipality
  • Find nearby airports and navaids from coordinates
  • Filter runways by surface, dimensions, and lighting
  • Inspect airport frequencies and runway records

Key features

  • Offline bundled OurAirports dataset
  • Airport and runway search
  • Multi-code airport resolution
  • Coordinate-based airport and navaid lookup
  • Country and region metadata
  • STDIO and Streamable HTTP transports

Tools6

What Ourairports MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~261 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

8/8 checks healthy over the last 48d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @cyanheads/ourairports-mcp-server@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
Last commit16d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed6Callable tools this server registers over MCP.

How Ourairports MCP Server works

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Ourairports MCP Server

ourairports-mcp-server is an MCP server that connects agents to a bundled public-domain OurAirports dataset. Its main tools search airports and runways, resolve airport records by IATA, ICAO, GPS, local, or ident code, find nearby airports and navaids, and list countries with airport counts and regions.

Install it through the provided Claude Desktop, Cursor, or VS Code links, or configure an MCP client to run `npx -y @cyanheads/ourairports-mcp-server`. A public Streamable HTTP endpoint is also available at `https://ourairports.caseyjhand.com/mcp`.

Yes, it finds airports within a supplied radius of a latitude and longitude, ranked by great-circle distance. Results include distance and bearing, and the query can filter by airport type. It does not convert place names into coordinates.

Yes, it searches runways by surface text, minimum length, minimum width, lighting, country, region, and airport type. Each matching result contains an airport and runway row. Unknown length or width values do not pass a corresponding minimum filter.

Yes, Cursor is one of the clients with a provided installation link. The documented configuration launches the package with `npx -y @cyanheads/ourairports-mcp-server`.

Related MCP servers

All in Aerospace & Astrodynamics All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOurairports MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ourairports-mcp-server?style=directory)](https://allmcps.com/mcp/ourairports-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/ourairports-mcp-server"><img src="https://allmcps.com/api/badge/ourairports-mcp-server?style=directory" alt="Ourairports MCP Server on AllMCPs" /></a>