ourairports-mcp-server

v0.1.2 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

5

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. Discover codes with ourairports_list_countries.",
      "type": "string"
    },
    "region": {
      "description": "ISO 3166-2 region code filter (e.g. US-WA). Exact match.",
      "type": "string"
    },
    "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_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."
    },
    "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": {
      "default": 10,
      "description": "Maximum airports to return (1–50). Defaults to 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "latitude",
    "longitude",
    "radius_km",
    "include_closed",
    "limit"
  ],
  "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. Mutually exclusive with latitude/longitude.",
      "type": "string"
    },
    "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