Skip to main content
Glama
Sign In

ourairports-mcp-server

by io.github.cyanheads
OverviewDiscussionsAdmin

Search Runways

ourairports_search_runways
Read-onlyIdempotent

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). Lengths are the full runway surface, including displaced thresholds and overruns — not usable takeoff or landing distance; each runway also reports its displaced threshold per end. 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 Schema

NameRequiredDescriptionDefault
typeNoRestrict to runways at airports of one type: large_airport, medium_airport, small_airport, heliport, seaplane_base, balloonport, or closed.
limitNoMaximum runway rows to return (1–100). Defaults to OURAIRPORTS_DEFAULT_SEARCH_LIMIT (20).
regionNoRegion code from ourairports_list_countries with include_regions (e.g. US-WA or KS-U-A). Case-insensitive; surrounding whitespace is ignored. Literal empty string is unset; whitespace-only is invalid.
countryNoCountry code from ourairports_list_countries (e.g. US). Case-insensitive; surrounding whitespace is ignored. Literal empty string is unset; whitespace-only is invalid.
lightedNoFilter by runway lighting: true for lighted runways only, false for unlighted only. Omit to include both.
surfaceNoSurface 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.
min_width_ftNoMinimum runway width in feet (inclusive). Runways with an unknown width are excluded when this is set, never assumed to pass.
min_length_ftNoMinimum length of the full runway surface in feet (inclusive), matched against lengthFt — which includes displaced thresholds and overruns, so this is not a usable-distance filter. Runways with an unknown length are excluded when this is set, never assumed to pass.
include_closed_runwaysNoInclude runways flagged closed. Off by default.
include_closed_airportsNoInclude runways at airports of type "closed". Off by default.

Output Schema

NameRequiredDescriptionDefault
capNoThe limit that was applied. Present only when results were truncated.
errorNoPresent when the call failed. Absent on success.
shownNoNumber of runway rows returned. Present only when results were truncated.
noticeNoGuidance when nothing matched or results were capped — how to broaden or narrow.
runwaysNoMatching runways, each paired with its airport. One row per runway — an airport with N matching runways contributes N rows.
truncatedNoPresent and true only when more runways matched than were returned.
totalCountNoTotal matching runways before the limit was applied.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • addedInput schema / properties / country / anyOf
      Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "Two-letter country code.",
+    "pattern": "^[A-Za-z]{2}$",
+    "type": "string"
+  }
+]
    • changedInput schema / properties / country / description
      Previous value: -"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."New value: +"Country code from ourairports_list_countries (e.g. US). Case-insensitive; surrounding whitespace is ignored. Literal empty string is unset; whitespace-only is invalid."
    • removedInput schema / properties / country / minLength
      Removed value: -1
    • removedInput schema / properties / country / type
      Removed value: -"string"
    • addedInput schema / properties / region / anyOf
      Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "Region code with one or two segments.",
+    "pattern": "^[A-Za-z]{2}(-[A-Za-z0-9]{1,3}){1,2}$",
+    "type": "string"
+  }
+]
    • changedInput schema / properties / region / description
      Previous value: -"ISO 3166-2 region code filter (e.g. US-WA). Exact match, case-insensitive; surrounding whitespace is ignored."New value: +"Region code from ourairports_list_countries with include_regions (e.g. US-WA or KS-U-A). Case-insensitive; surrounding whitespace is ignored. Literal empty string is unset; whitespace-only is invalid."
    • removedInput schema / properties / region / minLength
      Removed value: -1
    • removedInput schema / properties / region / type
      Removed value: -"string"
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode."New value: +"Machine-readable failure mode. Declared by this tool: `unknown_country`: The country code is absent from the bundled country table. `unknown_region`: The region code is absent from the bundled region table. Other values are possible when a failure originates below the handler."
    • addedOutput schema / properties / error / properties / data / properties / reason / examples
      Added value: +[
+  "unknown_country",
+  "unknown_region"
+]
  2. Changed7 schema fields changed
    • changedInput schema / properties / min_length_ft / description
      Previous value: -"Minimum runway length in feet (inclusive). Runways with an unknown length are excluded when this is set, never assumed to pass."New value: +"Minimum length of the full runway surface in feet (inclusive), matched against lengthFt — which includes displaced thresholds and overruns, so this is not a usable-distance filter. Runways with an unknown length are excluded when this is set, never assumed to pass."
    • changedOutput schema / properties / runways / items / properties / airport / properties / icaoCode / description
      Previous value: -"4-letter ICAO code, or null when the airport has none (~85% of fields)."New value: +"4-letter ICAO code, or null when the airport has none (~88% of fields)."
    • changedOutput schema / properties / runways / items / properties / runway / description
      Previous value: -"The matching runway — dimensions, surface, lighting, end designators, and headings."New value: +"The matching runway — full-surface dimensions, surface, lighting, and per-end designators, headings, and displaced thresholds."
    • addedOutput schema / properties / runways / items / properties / runway / properties / heDisplacedThresholdFt
      Added value: +{
+  "description": "Length of the displaced threshold at the high end (heIdent) in feet — part of lengthFt. Null when none is recorded.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedOutput schema / properties / runways / items / properties / runway / properties / leDisplacedThresholdFt
      Added value: +{
+  "description": "Length of the displaced threshold at the low end (leIdent) in feet — part of lengthFt. Null when none is recorded.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • changedOutput schema / properties / runways / items / properties / runway / properties / lengthFt / description
      Previous value: -"Runway length in feet, or null when unknown."New value: +"Length of the full runway surface in feet, including displaced thresholds and overrun areas — not the usable takeoff or landing distance. Null when unknown."
    • changedOutput schema / properties / runways / items / properties / runway / required
      Previous value: -[
-  "id",
-  "lengthFt",
-  "widthFt",
-  "surface",
-  "lighted",
-  "closed",
-  "leIdent",
-  "leHeadingDegT",
-  "heIdent",
-  "heHeadingDegT"
-]New value: +[
+  "id",
+  "lengthFt",
+  "widthFt",
+  "surface",
+  "lighted",
+  "closed",
+  "leIdent",
+  "leHeadingDegT",
+  "leDisplacedThresholdFt",
+  "heIdent",
+  "heHeadingDegT",
+  "heDisplacedThresholdFt"
+]
  3. Changed36 schema fields changed
    • removedOutput schema / properties / runways / items / properties / airport / properties / continent / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / continent / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / countryName / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / countryName / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / elevationFt / anyOf
      Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / elevationFt / type
      Added value: +[
+  "number",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / gpsCode / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / gpsCode / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / iataCode / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / iataCode / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / icaoCode / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / icaoCode / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / isoCountry / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / isoCountry / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / isoRegion / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / isoRegion / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / localCode / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / localCode / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / municipality / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / municipality / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / airport / properties / regionName / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / airport / properties / regionName / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / runway / properties / heHeadingDegT / anyOf
      Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / runway / properties / heHeadingDegT / type
      Added value: +[
+  "number",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / runway / properties / heIdent / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / runway / properties / heIdent / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / runway / properties / leHeadingDegT / anyOf
      Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / runway / properties / leHeadingDegT / type
      Added value: +[
+  "number",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / runway / properties / leIdent / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / runway / properties / leIdent / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / runway / properties / lengthFt / anyOf
      Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / runway / properties / lengthFt / type
      Added value: +[
+  "number",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / runway / properties / surface / anyOf
      Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / runway / properties / surface / type
      Added value: +[
+  "string",
+  "null"
+]
    • removedOutput schema / properties / runways / items / properties / runway / properties / widthFt / anyOf
      Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
    • addedOutput schema / properties / runways / items / properties / runway / properties / widthFt / type
      Added value: +[
+  "number",
+  "null"
+]
  4. Changed6 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedInput schema / additionalProperties
      Added value: +false
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedOutput schema / anyOf
      Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "runways",
+      "totalCount"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]
    • addedOutput schema / properties / error
      Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode.",
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}
    • removedOutput schema / required
      Removed value: -[
-  "runways",
-  "totalCount"
-]
  5. Added

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations cover the safe-read profile (readOnly, idempotent, closed-world), so the description's value is in the extra semantics it supplies: one flat {airport, runway} row per matching runway, substring-match surface behavior, full-surface length definition including displaced thresholds/overruns, and 'unknown excludes when min_*_ft is set' rules. It does not discuss pagination/truncation beyond the limit parameter, which is the only notable gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded correctly — identity and sibling relationship precede all filter semantics — and every sentence carries substantive information. It is one very dense paragraph, so the caveats (length semantics, unknown-value exclusion, closed-entity defaults) are harder to scan than if they were broken out, but there is little waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 10 optional parameters, an output schema, and full annotation coverage, this description supplies exactly what structured fields cannot: result row cardinality, filter-combination behavior, exclusion semantics for unknown values, and a data-authority caveat. Nothing needed to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3 and the schema already carries the per-parameter text. The description adds cross-cutting meaning the schema can't: that surface is a CONTAIN a fragment match with no controlled vocabulary (with 'asp' matching ASP/ASPH/Asphalt), that length is not usable distance, and how the include_closed_* flags interact with default exclusion.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (search runways across the bundled corpus) plus the exact scope of the join (back to their airports). It explicitly contrasts itself with the sibling ourairports_get_airport, so an agent can pick between them without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Names the alternative (ourairports_get_airport) and the condition that selects it — single already-known airport vs. cross-airport attribute search. It also routes the agent to ourairports_list_countries for valid country/region codes, giving a concrete prerequisite.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All ourairports-mcp-server toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources