Skip to main content
Glama
Sign In
FreightUtils MCP Server

FreightUtils MCP Server

by SoapyRED
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

airport_lookup

Read-onlyIdempotent

Look up airports worldwide by IATA or ICAO code, or search by name or city, to retrieve location, type, and elevation details.

Instructions

Look up an airport by IATA code (3 letters, e.g. "LHR"), ICAO code (4 chars, e.g. "EGLL"), or free-text name/city search (e.g. "heathrow"). Covers 86,248 airports worldwide (OurAirports, public domain, cross-checked vs OpenFlights + Wikidata).

Provide ONE of iata, icao, or query; the optional type filter narrows results. Behavior: read-only; exact code hits return one record; ambiguous name searches return ranked candidates (exact codes first, then larger airports) with match quality reported via the envelope's confidence (basis match_quality); an unknown code errors with a not-found message. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets.

Returns: count and results[] — per airport: IATA + ICAO/ident, name, type (large/medium/small/heliport/closed/seaplane), municipality, region, country, latitude/longitude and elevation_ft — under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).

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

Related: nearest_airport (find airports FROM a coordinate), airline_lookup (searches CARRIERS / AWB prefixes, not airports), unlocode_lookup (general transport locations, of which airports are one function).

Input Schema

NameRequiredDescriptionDefault
iataNoExact 3-letter IATA code. Example: "LHR".
icaoNoExact 4-character ICAO / ident. Example: "EGLL".
typeNoOptional filter by airport type.
codesNoBatch: up to 50 airport codes — 3 letters IATA, 4 characters ICAO. Send alone; answered as results[] in input order, each with its own status. One call against the daily limit, N against the Pro monthly allowance.
queryNoName / city / municipality search (min 2 chars). Example: "heathrow".

Output Schema

NameRequiredDescriptionDefault
okYes
_metaNo
as_ofNo
resultYes
statusNo
_sourceYes
editionNo
citationYes
validityNo
warningsNo
confidenceYes
missing_inputsNo
blocking_errorsNo
envelope_versionYes
normalized_inputNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changedv2.27.0
    • addedInput schema / properties / codes
      Added value: +{
+  "description": "Batch: up to 50 airport codes — 3 letters IATA, 4 characters ICAO. Send alone; answered as results[] in input order, each with its own status. One call against the daily limit, N against the Pro monthly allowance.",
+  "items": {
+    "maxLength": 14,
+    "type": "string"
+  },
+  "maxItems": 50,
+  "minItems": 1,
+  "type": "array"
+}
    • addedOutput schema / properties / _meta / properties / check_id
      Added value: +{
+  "type": "string"
+}
    • addedOutput schema / properties / _meta / properties / edition_basis
      Added value: +{
+  "type": "string"
+}
    • addedOutput schema / properties / _meta / properties / receipt
      Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "created_at": {
+      "type": "string"
+    },
+    "dataset_version": {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "engine_version": {
+      "type": "string"
+    },
+    "inputs": {},
+    "reason": {
+      "const": "key_required",
+      "type": "string"
+    },
+    "receipt_hash": {
+      "type": "string"
+    },
+    "result": {
+      "additionalProperties": {},
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "schema_version": {
+      "type": "string"
+    },
+    "stored": {
+      "const": false,
+      "type": "boolean"
+    },
+    "tool": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "stored",
+    "reason",
+    "schema_version",
+    "receipt_hash",
+    "created_at",
+    "tool",
+    "inputs",
+    "dataset_version",
+    "engine_version",
+    "result"
+  ],
+  "type": "object"
+}
    • addedOutput schema / properties / _meta / properties / receipt_url
      Added value: +{
+  "type": "string"
+}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "count": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "disclaimer": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "meta": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "results": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "country": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "country_name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "elevation_ft": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "iata_code": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "ident": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "latitude": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "longitude": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "municipality": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "region": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "type": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "additionalProperties": {},
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "count": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "disclaimer": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "meta": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "results": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "country": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "country_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "elevation_ft": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "gps_code": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "iata_code": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "icao_code": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "ident": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "iso_region": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "keywords": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "latitude": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "longitude": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "municipality": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "region": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "scheduled_service": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "type": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "additionalProperties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  }
+]
  2. Changed10 schema fields changedv2.24.0
    • addedOutput schema / properties / _meta
      Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "identify": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}
    • addedOutput schema / properties / as_of
      Added value: +{
+  "type": "string"
+}
    • addedOutput schema / properties / blocking_errors / items / properties / recovery / properties / params / propertyNames
      Added value: +{
+  "type": "string"
+}
    • addedOutput schema / properties / edition
      Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "applies_from": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "may_apply_until": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name",
+        "applies_from",
+        "may_apply_until"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • changedOutput schema / properties / envelope_version / enum
      Previous value: -[
-  "1",
-  "1.1"
-]New value: +[
+  "1",
+  "1.1",
+  "1.2"
+]
    • addedOutput schema / properties / missing_inputs
      Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedOutput schema / properties / normalized_input / propertyNames
      Added value: +{
+  "type": "string"
+}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {
-      "count": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "disclaimer": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "meta": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "results": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": true,
-              "properties": {
-                "country": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "country_name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "elevation_ft": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "iata_code": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "ident": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "latitude": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "longitude": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "municipality": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "region": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "type": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "additionalProperties": {},
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "count": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "disclaimer": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "meta": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "results": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "country": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "country_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "elevation_ft": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "iata_code": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "ident": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "latitude": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "longitude": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "municipality": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "region": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "type": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "additionalProperties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  }
+]
    • addedOutput schema / properties / status
      Added value: +{
+  "enum": [
+    "ok",
+    "partial",
+    "not_found",
+    "unsupported",
+    "ambiguous"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / warnings / items / properties / details / propertyNames
      Added value: +{
+  "type": "string"
+}
  3. Changed5 schema fields changedv2.17.2
    • 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"
+]
  4. Changed28 schema fields changedv2.11.0
    • changedInput schema / properties / iata / description
      Previous value: -"Exact 3-letter IATA code"New value: +"Exact 3-letter IATA code. Example: \"LHR\"."
    • changedInput schema / properties / icao / description
      Previous value: -"Exact 4-character ICAO / ident"New value: +"Exact 4-character ICAO / ident. Example: \"EGLL\"."
    • changedInput schema / properties / query / description
      Previous value: -"Name / city / municipality search (min 2 chars)"New value: +"Name / city / municipality search (min 2 chars). Example: \"heathrow\"."
    • changedInput schema / properties / type / description
      Previous value: -"Optional filter by airport type"New value: +"Optional filter by airport type."
    • removedOutput schema / properties / _source / properties / authority
      Removed value: -{
-  "type": "string"
-}
    • addedOutput schema / properties / _source / properties / checked
      Added value: +{
+  "type": "string"
+}
    • removedOutput schema / properties / _source / properties / data_vintage
      Removed value: -{
-  "type": "string"
-}
    • removedOutput schema / properties / _source / properties / dataset
      Removed value: -{
-  "type": "string"
-}
    • removedOutput schema / properties / _source / properties / licence
      Removed value: -{
-  "type": "string"
-}
    • addedOutput schema / properties / _source / properties / name
      Added value: +{
+  "type": "string"
+}
    • addedOutput schema / properties / _source / properties / provenance_status
      Added value: +{
+  "enum": [
+    "verified",
+    "pending-verification",
+    "computed",
+    "live"
+  ],
+  "type": "string"
+}
    • removedOutput schema / properties / _source / properties / retrieved_via
      Removed value: -{
-  "type": "string"
-}
    • removedOutput schema / properties / _source / properties / type
      Removed value: -{
-  "type": "string"
-}
    • changedOutput schema / properties / _source / required
      Previous value: -[
-  "type",
-  "authority"
-]New 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": {},
+            "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"
+}
    • removedOutput schema / properties / meta
      Removed value: -{
-  "additionalProperties": {},
-  "type": "object"
-}
    • addedOutput schema / properties / normalized_input
      Added value: +{
+  "additionalProperties": {},
+  "type": "object"
+}
    • addedOutput schema / properties / ok
      Added value: +{
+  "type": "boolean"
+}
    • addedOutput schema / properties / result
      Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "properties": {
+        "count": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "disclaimer": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "meta": {
+          "anyOf": [
+            {
+              "additionalProperties": {},
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "results": {
+          "anyOf": [
+            {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "country": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "country_name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "elevation_ft": {
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "iata_code": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "ident": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "latitude": {
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "longitude": {
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "municipality": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "region": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "type": "object"
+    },
+    {
+      "additionalProperties": {},
+      "type": "object"
+    }
+  ]
+}
    • removedOutput schema / properties / results
      Removed value: -{
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "country": {
-        "type": "string"
-      },
-      "country_name": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "elevation_ft": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "iata_code": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ident": {
-        "type": "string"
-      },
-      "latitude": {
-        "type": "number"
-      },
-      "longitude": {
-        "type": "number"
-      },
-      "municipality": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "name": {
-        "type": "string"
-      },
-      "region": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "type": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "ident",
-      "iata_code",
-      "name",
-      "type",
-      "municipality",
-      "region",
-      "country",
-      "country_name",
-      "latitude",
-      "longitude",
-      "elevation_ft"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}
    • addedOutput schema / properties / validity
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "as_of": {
+      "type": "string"
+    },
+    "effective_from": {
+      "type": "string"
+    },
+    "effective_to": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "as_of"
+  ],
+  "type": "object"
+}
    • addedOutput schema / properties / warnings
      Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "details": {
+        "additionalProperties": {},
+        "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"
+]
  5. Addedv2.10.0

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already declare read-only, idempotent, non-destructive, closed-world, but the description adds genuinely new traits: exact code hits return one record, ambiguous searches return ranked candidates with confidence/match_quality, unknown codes raise not-found, and rate-limit errors carry reset_at. The only gap is that batch mode (`codes`) is never described behaviorally, and the 'not for navigation' limitation is a useful safety note.

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 with purpose and input forms, then a compact Behavior/Returns/Limitations/Related structure. It runs long, and the 'Returns:' paragraph partially duplicates the existing output schema, though the field enumeration is still skimmable rather than wasted.

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

Completeness4/5

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

Output schema exists, so return detail is bonus rather than required, and error/rate-limit behavior is covered. The one substantive omission is the `codes` batch mode with its 50-code limit and allowance accounting, which an agent could easily miss when deciding how to call this tool efficiently.

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 baseline is 3; the description adds real semantics beyond it by stating the iata/icao/query parameters are mutually exclusive (the schema itself permits all simultaneously) and that `type` narrows results. It omits any mention of the `codes` batch parameter, which is a substantive capability left entirely to the schema.

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 (look up) and resource (airport) and enumerates the three accepted key types with concrete examples, so the agent knows exactly what inputs resolve what. It also names the dataset's scope (86,248 airports, OurAirports cross-checked) which no sibling shares.

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?

'Provide ONE of iata, icao, or query' gives an explicit selection constraint, and the Related section routes away to nearest_airport (coordinate-based), airline_lookup (carriers/AWB), and unlocode_lookup (general locations). The agent has both the use condition and the alternatives named.

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

Deploy Server

Other Tools