# io.github.cyanheads/ourairports-mcp-server (remote · ourairports.caseyjhand.com)

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

- Trust score: 67/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `ourairports.caseyjhand.com`: 67/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-ourairports-mcp-server/ourairports.md), [page](https://verifymcp.io/servers/cyanheads-ourairports-mcp-server/ourairports)
- npm · `@cyanheads/ourairports-mcp-server`: 35/100, [markdown](https://verifymcp.io/servers/cyanheads-ourairports-mcp-server/cyanheads-ourairports-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-ourairports-mcp-server/cyanheads-ourairports-mcp-server)

## Channel facts

- Endpoint: `https://ourairports.caseyjhand.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.2.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 6 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2229 tokens (~371/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http cyanheads-ourairports-mcp-server https://ourairports.caseyjhand.com/mcp
```

### Codex

```toml
[mcp_servers.cyanheads-ourairports-mcp-server]
url = "https://ourairports.caseyjhand.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-ourairports-mcp-server": {
      "type": "remote",
      "url": "https://ourairports.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-ourairports-mcp-server --url https://ourairports.caseyjhand.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  cyanheads-ourairports-mcp-server:
    url: "https://ourairports.caseyjhand.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "cyanheads-ourairports-mcp-server": {
      "type": "http",
      "url": "https://ourairports.caseyjhand.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 66, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 64, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 63, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 62, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 62)

First indexed and scored.

## MCP tools (6)

### `ourairports_search_airports` (~348 tokens)

ourairports-mcp-server

Search the bundled OurAirports corpus by free-text (name / municipality / keywords) and/or facets (country, region, type). Every query token must match (word order and partial words are handled). Returns ranked airport summaries — operational and larger airports first — each with its full code set and coordinates, ready to chain into ourairports_get_airport. Closed airports are excluded unless include_closed is set. Use ourairports_list_countries for valid country/region codes. For "nearest airport to a coordinate" use ourairports_find_airports instead. OurAirports is community-edited — not authoritative for flight operations.

Input parameters:

- `country` (string): ISO 3166-1 alpha-2 country code filter (e.g. US). Exact match, case-insensitive; surrounding whitespace is ignored. Discover codes with ourairports_list_countries.
- `include_closed` (boolean): Include airports of type "closed". Off by default — closed airports pollute the live-flight grounding use case.
- `limit` (integer): Maximum airports to return (1–100). Defaults to OURAIRPORTS_DEFAULT_SEARCH_LIMIT (20).
- `query` (string): Free-text search over airport name, municipality, and keywords. Tokens are AND-matched. Omit to browse purely by facets.
- `region` (string): ISO 3166-2 region code filter (e.g. US-WA). Exact match, case-insensitive; surrounding whitespace is ignored.
- `type` (string): Restrict to one airport type: large_airport, medium_airport, small_airport, heliport, seaplane_base, balloonport, or closed.

Output parameters:

- `airports` (array): Matching airports, ranked best-first. Codes the airport lacks are null.
- `cap` (number): The limit that was applied. Present only when results were truncated.
- `notice` (string): Guidance when nothing matched or results were capped — how to broaden or narrow.
- `shown` (number): Number of airports returned. Present only when results were truncated.
- `totalCount` (number): Total airports matched before the limit was applied.
- `truncated` (boolean): Present and true only when more airports matched than were returned.

### `ourairports_search_runways` (~629 tokens)

ourairports-mcp-server

Search runways across the whole bundled OurAirports corpus by attribute, joined back to their airports — the cross-airport counterpart to ourairports_get_airport (which returns runways for one already-known airport). Filter by airport facets (country, region, type) and runway facets (surface, min_length_ft, min_width_ft, lighted). Returns one flat {airport, runway} row per matching runway, so an airport with three matching runways contributes three rows. `surface` is a case-insensitive substring match against the raw upstream surface string, not an exact code — the runway surface must CONTAIN your text, so a shorter fragment matches more variants (no controlled vocabulary: "asp" matches ASP, ASPH, and Asphalt). A runway whose length or width is unknown is excluded when the matching min_*_ft filter is set — the data can never confirm it meets the threshold. Closed airports and closed runways are both excluded unless their include_* flag is set. Use ourairports_list_countries for valid country/region codes. OurAirports is community-edited — not authoritative for flight operations.

Input parameters:

- `country` (string): ISO 3166-1 alpha-2 country code filter (e.g. US). Exact match, case-insensitive; surrounding whitespace is ignored. Discover codes with ourairports_list_countries.
- `include_closed_airports` (boolean): Include runways at airports of type "closed". Off by default.
- `include_closed_runways` (boolean): Include runways flagged closed. Off by default.
- `lighted` (boolean): Filter by runway lighting: true for lighted runways only, false for unlighted only. Omit to include both.
- `limit` (integer): Maximum runway rows to return (1–100). Defaults to OURAIRPORTS_DEFAULT_SEARCH_LIMIT (20).
- `min_length_ft` (number): Minimum runway length in feet (inclusive). Runways with an unknown length are excluded when this is set, never assumed to pass.
- `min_width_ft` (number): Minimum runway width in feet (inclusive). Runways with an unknown width are excluded when this is set, never assumed to pass.
- `region` (string): ISO 3166-2 region code filter (e.g. US-WA). Exact match, case-insensitive; surrounding whitespace is ignored.
- `surface` (string): Surface filter — case-insensitive substring match against the raw upstream surface string (free text, no controlled vocabulary; ~654 distinct values). Match the literal text as recorded: "asp" matche…
- `type` (string): Restrict to runways at airports of one type: large_airport, medium_airport, small_airport, heliport, seaplane_base, balloonport, or closed.

Output parameters:

- `cap` (number): The limit that was applied. Present only when results were truncated.
- `notice` (string): Guidance when nothing matched or results were capped — how to broaden or narrow.
- `runways` (array): Matching runways, each paired with its airport. One row per runway — an airport with N matching runways contributes N rows.
- `shown` (number): Number of runway rows returned. Present only when results were truncated.
- `totalCount` (number): Total matching runways before the limit was applied.
- `truncated` (boolean): Present and true only when more runways matched than were returned.

### `ourairports_get_airport` (~239 tokens)

ourairports-mcp-server

Fetch the full record for one airport resolved by ANY code — IATA (SEA), ICAO (KSEA), GPS, national/local, or the OurAirports ident — with its runways and radio frequencies inline. The single `code` param is resolved case-insensitively across all five identifier spaces (priority: ident, then ICAO, IATA, GPS, local). The response always echoes the airport's complete code set and a resolution_note naming which space matched, so a wrong resolution from an ambiguous national code is self-correcting (re-query with the IATA or ICAO code, or the ident). Absent codes are reported as null, never an error. Closed airports always resolve. OurAirports is community-edited — not authoritative for flight operations.

Input parameters:

- `code` (string, required): Any airport code: IATA (SEA), ICAO (KSEA), GPS code, national/local code, or the OurAirports ident. Case-insensitive; surrounding whitespace is ignored.
- `include` (array): Which related records to include inline. Defaults to both. Pass a subset to trim the response.

Output parameters:

- `airport` (object): The resolved airport record. Codes the airport lacks are null.
- `frequencies` (array): Radio frequencies in MHz. Empty when the airport has none OR when `frequencies` was not in `include` — check `included` to tell which.
- `included` (array): Which related-record sets this response carries, echoing the effective `include` selection. A relation NOT listed here was omitted by `include` (its array is empty for that reason); a listed relation…
- `resolutionNote` (string): Human-readable note on how the code resolved, including an ambiguity warning for shared national codes.
- `resolvedVia` (string): Which identifier space the code matched: ident, icao_code, iata_code, gps_code, or local_code.
- `runways` (array): Runways for the airport. Empty when the airport has none OR when `runways` was not in `include` — check `included` to tell which.

### `ourairports_find_airports` (~275 tokens)

ourairports-mcp-server

Find airports within a radius of a latitude/longitude, ranked nearest-first by great-circle distance, each with its distance (km) and bearing (degrees true) from the query point. The grounding tool for "nearest airport to here" — pair it with a live aviation server to fetch weather or positions for the result. Takes a coordinate only: no geocoding, so resolve place names to lat/lon upstream first (e.g. an OpenStreetMap or Open-Meteo geocode tool). Closed airports are excluded unless include_closed is set. OurAirports is community-edited — not authoritative for flight operations.

Input parameters:

- `include_closed` (boolean): Include airports of type "closed". Off by default.
- `latitude` (number, required): Query point latitude in decimal degrees (WGS84), −90 to 90.
- `limit` (integer): Maximum airports to return (1–50). Defaults to OURAIRPORTS_DEFAULT_SEARCH_LIMIT (20).
- `longitude` (number, required): Query point longitude in decimal degrees (WGS84), −180 to 180.
- `radius_km` (number): Search radius in kilometers (1–500). Defaults to 100.
- `type` (string): Restrict to one airport type (e.g. large_airport for major fields only).

Output parameters:

- `airports` (array): Airports within the radius, nearest-first.
- `notice` (string): Guidance when no airport fell within the radius — e.g. widen radius_km.
- `totalCount` (number): Number of airports returned within the radius.

### `ourairports_find_navaids` (~397 tokens)

ourairports-mcp-server

Find navigation aids (VOR, VOR-DME, DME, NDB, NDB-DME, TACAN, VORTAC) two ways: spatially, by passing latitude+longitude (with an optional radius_km); or relationally, by passing airport_code to get the navaids that serve that airport. Supply exactly one mode — both or neither is a validation error. Coordinate mode ranks nearest-first with distance (km) and bearing (degrees true). Frequencies are stored in kHz for every navaid type (a VOR on 114.5 MHz reads frequencyKhz 114500) and are also surfaced in MHz. Airport mode returns an empty list (not an error) when the airport exists but has no associated navaids; an unknown airport_code is an error. OurAirports is community-edited — not authoritative for flight operations.

Input parameters:

- `airport_code` (string): Airport mode: any airport code (IATA/ICAO/GPS/local/ident); returns the navaids serving that airport. Case-insensitive; surrounding whitespace is ignored. Mutually exclusive with latitude/longitude.
- `latitude` (number): Coordinate mode: query point latitude (−90 to 90). Provide with longitude; mutually exclusive with airport_code.
- `limit` (integer): Maximum navaids to return (1–50). Defaults to OURAIRPORTS_DEFAULT_SEARCH_LIMIT (20).
- `longitude` (number): Coordinate mode: query point longitude (−180 to 180). Provide with latitude.
- `radius_km` (number): Coordinate mode: search radius in kilometers (1–500). Defaults to 100. Ignored in airport mode.
- `type` (string): Restrict to one navaid type: NDB, VOR-DME, VORTAC, TACAN, VOR, DME, or NDB-DME.

Output parameters:

- `airportIdent`: In airport mode, the resolved airport ident the navaids were matched against; null in coordinate mode.
- `mode` (string): Which query mode was used.
- `navaids` (array): Matching navaids. Nearest-first in coordinate mode; in airport-association order in airport mode.
- `notice` (string): Guidance when no navaids matched (empty radius, or airport found but unserved).
- `totalCount` (number): Number of navaids returned.

### `ourairports_list_countries` (~170 tokens)

ourairports-mcp-server

List the countries present in the bundled OurAirports dataset with their ISO 3166-1 alpha-2 codes and airport counts. This is the lookup table for valid `country` (and, with include_regions, `region`) filter values used by ourairports_search_airports. Optionally restrict to a continent or nest each country's regions. Counts exclude closed airports.

Input parameters:

- `continent` (string): Restrict to one continent: AF (Africa), AN (Antarctica), AS (Asia), EU (Europe), NA (North America), OC (Oceania), SA (South America).
- `include_regions` (boolean): When true, nest each country's ISO 3166-2 regions (with airport counts) under it. Off by default to keep the response compact.

Output parameters:

- `countries` (array): Countries present in the dataset, sorted by name.
- `notice` (string): Guidance when the continent filter matched no countries.
- `totalCount` (number): Number of countries returned.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/cyanheads-ourairports-mcp-server/ourairports#diagnostics

## Score history

- 2026-08-03: 67
- 2026-08-02: 67
- 2026-08-01: 66
- 2026-07-31: 66
- 2026-07-30: 64
- 2026-07-29: 64
- 2026-07-28: 63
- 2026-07-27: 62
- 2026-07-26: 62

## Links

- Remote endpoint: https://ourairports.caseyjhand.com/mcp
- Repository: https://github.com/cyanheads/ourairports-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-ourairports-mcp-server/ourairports/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-ourairports-mcp-server/ourairports/changelog.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-ourairports-mcp-server/ourairports