FreightUtils MCP Server

Nearest Airport

nearest_airport

Read-onlyIdempotent

Find the airports nearest to a caller-provided latitude/longitude, sorted by great-circle (haversine) distance with distance_km on each result. Searches 85,555 airports (OurAirports, public domain).

Provide latitude and longitude (decimal degrees); optional radius_km, max_results (1-50, default 10) and type filter (e.g. large_airport only). Coordinates are INPUT only — nothing is stored or logged.

Behavior: deterministic distance sort; confidence reflects proximity and airport size (a large airport within 25 km scores high; closed/heliport/seaplane results cap lower). This tool does NOT geocode place names and does NOT compute routes — pass coordinates you already hold. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.

Returns: count and results[] (the airport record plus distance_km) under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).

Limitations: reference data only — not for navigation; verify codes with IATA / ICAO.

Related: airport_lookup (exact code or name lookup, no distance), unlocode_lookup (named transport-location search).

Input Schema

TableJSON Schema

Name	Required	Description
`type`	No	Optional filter by airport type
`latitude`	Yes	Latitude in decimal degrees (-90 to 90)
`longitude`	Yes	Longitude in decimal degrees (-180 to 180)
`radius_km`	No	Optional maximum distance in kilometres
`max_results`	No	Max results to return (1–50, default 10)

Output Schema

TableJSON Schema

Name	Required	Description	Default
`ok`	Yes
`result`	Yes
`_source`	Yes
`citation`	Yes
`validity`	No
`warnings`	No
`confidence`	Yes
`blocking_errors`	No
`envelope_version`	Yes
`normalized_input`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 8, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```
Changed5 schema fields changedAug 11, 2026
- addedOutput schema / properties / _source / properties / authority_current_edition
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / _source / properties / checked_at
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / _source / properties / dataset_edition
```
Added value: +{
+  "type": "string"
+}
```
- removedOutput schema / properties / envelope_version / const
```
Removed value: -"1"
```
- addedOutput schema / properties / envelope_version / enum
```
Added value: +[
+  "1",
+  "1.1"
+]
```

Changed18 schema fields changedJul 9, 2026

changedOutput schema / properties / _source / additionalProperties
```
Previous value: -{
-  "type": "string"
-}New value: +false
```

removedOutput schema / properties / _source / description

Removed value: -"Provenance envelope (OurAirports, cross-checked)"

addedOutput schema / properties / _source / properties

Added value: +{
+  "checked": {
+    "type": "string"
+  },
+  "name": {
+    "type": "string"
+  },
+  "provenance_status": {
+    "enum": [
+      "verified",
+      "pending-verification",
+      "computed",
+      "live"
+    ],
+    "type": "string"
+  },
+  "source_url": {
+    "type": "string"
+  }
+}

removedOutput schema / properties / _source / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```

addedOutput schema / properties / _source / required

Added value: +[
+  "name",
+  "checked",
+  "provenance_status"
+]

addedOutput schema / properties / blocking_errors

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "recovery": {
+        "additionalProperties": false,
+        "properties": {
+          "action": {
+            "type": "string"
+          },
+          "params": {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "tool": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "code",
+      "message",
+      "recovery"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / citation

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "qualifier": {
+      "type": "string"
+    },
+    "text": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "text"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / confidence

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "basis": {
+      "enum": [
+        "deterministic",
+        "provenance",
+        "match_quality",
+        "freshness"
+      ],
+      "type": "string"
+    },
+    "level": {
+      "enum": [
+        "high",
+        "medium",
+        "low"
+      ],
+      "type": "string"
+    },
+    "score": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    }
+  },
+  "required": [
+    "level",
+    "basis"
+  ],
+  "type": "object"
+}

removedOutput schema / properties / count

Removed value: -{
-  "type": "number"
-}

removedOutput schema / properties / disclaimer
```
Removed value: -{
-  "type": "string"
-}
```

addedOutput schema / properties / envelope_version

Added value: +{
+  "const": "1",
+  "type": "string"
+}

addedOutput schema / properties / normalized_input

Added value: +{
+  "additionalProperties": {},
+  "propertyNames": {
+    "type": "string"
+  },
+  "type": "object"
+}

addedOutput schema / properties / ok
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / properties / result

Added value: +{
+  "additionalProperties": {},
+  "propertyNames": {
+    "type": "string"
+  },
+  "type": "object"
+}

removedOutput schema / properties / results

Removed value: -{
-  "description": "Nearest airports, ascending by distance_km",
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "country": {
-        "description": "ISO 3166-1 alpha-2 country code",
-        "type": "string"
-      },
-      "country_name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "distance_km": {
-        "description": "Great-circle distance from the query point, km",
-        "type": "number"
-      },
-      "elevation_ft": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "iata_code": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "IATA 3-letter code (null if none)"
-      },
-      "ident": {
-        "description": "ICAO / OurAirports ident",
-        "type": "string"
-      },
-      "latitude": {
-        "type": "number"
-      },
-      "longitude": {
-        "type": "number"
-      },
-      "municipality": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "name": {
-        "type": "string"
-      },
-      "region": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Region / subdivision (readable)"
-      },
-      "type": {
-        "description": "large_airport | medium_airport | small_airport | heliport | closed | seaplane_base",
-        "type": "string"
-      }
-    },
-    "required": [
-      "ident",
-      "iata_code",
-      "name",
-      "type",
-      "municipality",
-      "region",
-      "country",
-      "country_name",
-      "latitude",
-      "longitude",
-      "elevation_ft",
-      "distance_km"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

addedOutput schema / properties / validity

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "as_of": {
+      "type": "string"
+    },
+    "effective_from": {
+      "type": "string"
+    },
+    "effective_to": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "as_of"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / warnings

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "details": {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "code",
+      "message"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "count",
-  "results",
-  "disclaimer",
-  "_source"
-]New value: +[
+  "envelope_version",
+  "ok",
+  "result",
+  "confidence",
+  "_source",
+  "citation"
+]

AddedJun 24, 2026

TDQS

Score is being calculated.

All FreightUtils MCP Server tools Inspect

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.