ourairports-mcp-server

v0.2.1 pre-1.0

Resolve airport codes (IATA/ICAO/GPS/local), search airports, find the nearest by coordinate, and look up runways, navaids, and radio frequencies from the bundled public-domain OurAirports dataset via MCP. STDIO or Streamable HTTP.

ourairports.caseyjhand.com/mcp
claude mcp add --transport http ourairports-mcp-server https://ourairports.caseyjhand.com/mcp
codex mcp add ourairports-mcp-server --url https://ourairports.caseyjhand.com/mcp
{
  "mcpServers": {
    "ourairports-mcp-server": {
      "url": "https://ourairports.caseyjhand.com/mcp"
    }
  }
}
gemini mcp add --transport http ourairports-mcp-server https://ourairports.caseyjhand.com/mcp
{
  "mcpServers": {
    "ourairports-mcp-server": {
      "command": "bunx",
      "args": [
        "mcp-remote",
        "https://ourairports.caseyjhand.com/mcp"
      ]
    }
  }
}
{
  "mcpServers": {
    "ourairports-mcp-server": {
      "type": "http",
      "url": "https://ourairports.caseyjhand.com/mcp"
    }
  }
}
curl -X POST https://ourairports.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

Tools

6

ourairports_search_airports

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ourairports_search_airports",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search over airport name, municipality, and keywords. Tokens are AND-matched. Omit to browse purely by facets.",
      "type": "string"
    },
    "country": {
      "description": "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.",
      "type": "string",
      "minLength": 1
    },
    "region": {
      "description": "ISO 3166-2 region code filter (e.g. US-WA). Exact match, case-insensitive; surrounding whitespace is ignored.",
      "type": "string",
      "minLength": 1
    },
    "type": {
      "description": "Restrict to one airport type: large_airport, medium_airport, small_airport, heliport, seaplane_base, balloonport, or closed.",
      "type": "string",
      "enum": [
        "large_airport",
        "medium_airport",
        "small_airport",
        "heliport",
        "seaplane_base",
        "balloonport",
        "closed"
      ]
    },
    "include_closed": {
      "default": false,
      "description": "Include airports of type \"closed\". Off by default — closed airports pollute the live-flight grounding use case.",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum airports to return (1–100). Defaults to OURAIRPORTS_DEFAULT_SEARCH_LIMIT (20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "include_closed"
  ],
  "additionalProperties": false
}
view source ↗

ourairports_search_runways

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ourairports_search_runways",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "country": {
      "description": "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.",
      "type": "string",
      "minLength": 1
    },
    "region": {
      "description": "ISO 3166-2 region code filter (e.g. US-WA). Exact match, case-insensitive; surrounding whitespace is ignored.",
      "type": "string",
      "minLength": 1
    },
    "type": {
      "description": "Restrict to runways at airports of one type: large_airport, medium_airport, small_airport, heliport, seaplane_base, balloonport, or closed.",
      "type": "string",
      "enum": [
        "large_airport",
        "medium_airport",
        "small_airport",
        "heliport",
        "seaplane_base",
        "balloonport",
        "closed"
      ]
    },
    "min_length_ft": {
      "description": "Minimum runway length in feet (inclusive). Runways with an unknown length are excluded when this is set, never assumed to pass.",
      "type": "number",
      "minimum": 0
    },
    "min_width_ft": {
      "description": "Minimum runway width in feet (inclusive). Runways with an unknown width are excluded when this is set, never assumed to pass.",
      "type": "number",
      "minimum": 0
    },
    "surface": {
      "description": "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\" matches ASP/ASPH/Asphalt/ASPH-G, \"con\" matches CON/Concrete, \"turf\" or \"grs\" for grass strips. A shorter fragment matches more variants; there is no enum or reference tool for surfaces.",
      "type": "string",
      "minLength": 1
    },
    "lighted": {
      "description": "Filter by runway lighting: true for lighted runways only, false for unlighted only. Omit to include both.",
      "type": "boolean"
    },
    "include_closed_airports": {
      "default": false,
      "description": "Include runways at airports of type \"closed\". Off by default.",
      "type": "boolean"
    },
    "include_closed_runways": {
      "default": false,
      "description": "Include runways flagged closed. Off by default.",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum runway rows to return (1–100). Defaults to OURAIRPORTS_DEFAULT_SEARCH_LIMIT (20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "include_closed_airports",
    "include_closed_runways"
  ],
  "additionalProperties": false
}
view source ↗

ourairports_get_airport

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ourairports_get_airport",
    "arguments": {
      "code": "<code>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "minLength": 1,
      "description": "Any airport code: IATA (SEA), ICAO (KSEA), GPS code, national/local code, or the OurAirports ident. Case-insensitive; surrounding whitespace is ignored."
    },
    "include": {
      "default": [
        "runways",
        "frequencies"
      ],
      "description": "Which related records to include inline. Defaults to both. Pass a subset to trim the response.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "runways",
          "frequencies"
        ]
      }
    }
  },
  "required": [
    "code",
    "include"
  ],
  "additionalProperties": false
}
view source ↗

ourairports_find_airports

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ourairports_find_airports",
    "arguments": {
      "latitude": "<latitude>",
      "longitude": "<longitude>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Query point latitude in decimal degrees (WGS84), −90 to 90."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Query point longitude in decimal degrees (WGS84), −180 to 180."
    },
    "radius_km": {
      "default": 100,
      "description": "Search radius in kilometers (1–500). Defaults to 100.",
      "type": "number",
      "minimum": 1,
      "maximum": 500
    },
    "type": {
      "description": "Restrict to one airport type (e.g. large_airport for major fields only).",
      "type": "string",
      "enum": [
        "large_airport",
        "medium_airport",
        "small_airport",
        "heliport",
        "seaplane_base",
        "balloonport",
        "closed"
      ]
    },
    "include_closed": {
      "default": false,
      "description": "Include airports of type \"closed\". Off by default.",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum airports to return (1–50). Defaults to OURAIRPORTS_DEFAULT_SEARCH_LIMIT (20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "latitude",
    "longitude",
    "radius_km",
    "include_closed"
  ],
  "additionalProperties": false
}
view source ↗

ourairports_find_navaids

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ourairports_find_navaids",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "latitude": {
      "description": "Coordinate mode: query point latitude (−90 to 90). Provide with longitude; mutually exclusive with airport_code.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "description": "Coordinate mode: query point longitude (−180 to 180). Provide with latitude.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "radius_km": {
      "default": 100,
      "description": "Coordinate mode: search radius in kilometers (1–500). Defaults to 100. Ignored in airport mode.",
      "type": "number",
      "minimum": 1,
      "maximum": 500
    },
    "airport_code": {
      "description": "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.",
      "type": "string",
      "minLength": 1
    },
    "type": {
      "description": "Restrict to one navaid type: NDB, VOR-DME, VORTAC, TACAN, VOR, DME, or NDB-DME.",
      "type": "string",
      "enum": [
        "NDB",
        "VOR-DME",
        "VORTAC",
        "TACAN",
        "VOR",
        "DME",
        "NDB-DME"
      ]
    },
    "limit": {
      "description": "Maximum navaids to return (1–50). Defaults to OURAIRPORTS_DEFAULT_SEARCH_LIMIT (20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "radius_km"
  ],
  "additionalProperties": false
}
view source ↗

ourairports_list_countries

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ourairports_list_countries",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "continent": {
      "description": "Restrict to one continent: AF (Africa), AN (Antarctica), AS (Asia), EU (Europe), NA (North America), OC (Oceania), SA (South America).",
      "type": "string",
      "enum": [
        "AF",
        "AN",
        "AS",
        "EU",
        "NA",
        "OC",
        "SA"
      ]
    },
    "include_regions": {
      "default": false,
      "description": "When true, nest each country's ISO 3166-2 regions (with airport counts) under it. Off by default to keep the response compact.",
      "type": "boolean"
    }
  },
  "required": [
    "include_regions"
  ],
  "additionalProperties": false
}
view source ↗

Resources

1

A single airport record by any code (IATA / ICAO / GPS / local / OurAirports ident), with runways and radio frequencies inline. Stable-URI twin of ourairports_get_airport.

uri airport://{code} mime application/json