DaedalMap Disaster and Geospatial Data

Resolve Point(s) in One Scope

resolve_point

Read-onlyIdempotent

Resolve WGS84 coordinates in exactly one selected scope and family. GLOBAL administrative finds Admin0; an ISO3 administrative scope finds its shallow country bank. MARINE requires one specific jurisdiction family (for example exclusive_economic_zone or high_seas), or water_body with water_kind=named or zone. The broad marine_jurisdiction category has no point route. No call crosses scopes or opens another family's bank. Discover families with get_catalog(catalog='geometry'). Current catalog: The same geography tools work worldwide across a cataloged baseline of 252 geographic entities, reaching up to Admin 2. Where additional country releases are available, the same calls automatically return deeper administrative tiers or maintained reference families. Additional detail is currently available for Australia, Brazil, Canada, France, Germany, Mexico, United Kingdom, United States.

Input Schema

Name	Required	Description
`lat`	No	Latitude in WGS84 decimal degrees.
`lon`	No	Longitude in WGS84 decimal degrees.
`family`	No	One exact family within the selected scope.
`points`	No	Bounded WGS84 point array. Use top-level lat/lon instead for one point.
`batch_id`	No	Optional caller-supplied batch id echoed for point arrays.
`scope_id`	No	GLOBAL, MARINE, or one published ISO3 country. No automatic fallback into another scope.
`request_id`	No	Optional caller-supplied request id for tracing.
`water_kind`	No	Required only for MARINE water_body: named seas or water zones.

Output Schema

Name	Required	Description	Default
`ok`	No
`error`	No
`point`	No
`stack`	No
`family`	No
`reason`	No
`matched`	No
`results`	No
`batch_id`	No
`guidance`	No
`warnings`	No
`join_keys`	No
`next_step`	No
`request_id`	No
`point_count`	No
`clarification`	No
`family_result`	No
`meter_receipt`	No
`resolved_count`	No
`shallow_loc_id`	No
`deeper_available`	No
`overlap_families`	No
`unresolved_count`	No
`settlement_receipt`	No
`deepest_resolved_family`	No
`deepest_resolved_loc_id`	No
`deepest_resolved_admin_level`	No
`available_deeper_admin_levels`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 24, 2026

changedInput schema / properties / family / description

Previous value: -"One family within the selected scope."New value: +"One exact family within the selected scope."

changedInput schema / properties / family / enum

Previous value: -[
-  "administrative",
-  "marine_jurisdiction",
-  "water_body"
-]New value: +[
+  "administrative",
+  "exclusive_economic_zone",
+  "territorial_seas",
+  "contiguous_zones",
+  "extended_continental_shelves",
+  "internal_waters",
+  "archipelagic_waters",
+  "high_seas",
+  "water_body"
+]

Changed4 schema fields changedOct 24, 2026

changedInput schema / oneOf

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "points"
-      ]
-    },
-    "required": [
-      "lat",
-      "lon"
-    ]
-  },
-  {
-    "not": {
-      "anyOf": [
-        {
-          "required": [
-            "lat"
-          ]
-        },
-        {
-          "required": [
-            "lon"
-          ]
-        }
-      ]
-    },
-    "required": [
-      "points"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "points"
+      ]
+    },
+    "required": [
+      "scope_id",
+      "family",
+      "lat",
+      "lon"
+    ]
+  },
+  {
+    "not": {
+      "anyOf": [
+        {
+          "required": [
+            "lat"
+          ]
+        },
+        {
+          "required": [
+            "lon"
+          ]
+        }
+      ]
+    },
+    "required": [
+      "scope_id",
+      "family",
+      "points"
+    ]
+  }
+]

addedInput schema / properties / family

Added value: +{
+  "description": "One family within the selected scope.",
+  "enum": [
+    "administrative",
+    "marine_jurisdiction",
+    "water_body"
+  ],
+  "type": "string"
+}

addedInput schema / properties / scope_id

Added value: +{
+  "description": "GLOBAL, MARINE, or one published ISO3 country. No automatic fallback into another scope.",
+  "minLength": 3,
+  "type": "string"
+}

addedInput schema / properties / water_kind

Added value: +{
+  "description": "Required only for MARINE water_body: named seas or water zones.",
+  "enum": [
+    "named",
+    "zone"
+  ],
+  "type": "string"
+}

Changed2 schema fields changedOct 16, 2026

removedInput schema / properties / include_marine_context

Removed value: -{
-  "default": false,
-  "description": "Opt in to parallel Marine overlaps for land matches. Defaults to false so ordinary administrative resolution stays lightweight. Offshore Marine fallback still applies.",
-  "type": "boolean"
-}

removedInput schema / properties / target_admin_level

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "integer"
-    }
-  ],
-  "description": "Optional exact requested level from Admin 0-3. Omit it to return the deepest available shallow level."
-}

Changed2 schema fields changedSep 29, 2026

addedInput schema / properties / include_marine_context / default
```
Added value: +false
```

changedInput schema / properties / include_marine_context / description

Previous value: -"Include parallel Marine overlaps for land matches. Defaults to true; set false for fast administrative loc_id previews. Offshore Marine fallback still applies."New value: +"Opt in to parallel Marine overlaps for land matches. Defaults to false so ordinary administrative resolution stays lightweight. Offshore Marine fallback still applies."

Changed1 schema field changedSep 24, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": true,
+  "anyOf": [
+    {
+      "required": [
+        "point",
+        "stack"
+      ]
+    },
+    {
+      "required": [
+        "point",
+        "family",
+        "family_result"
+      ]
+    },
+    {
+      "required": [
+        "point_count",
+        "results"
+      ]
+    },
+    {
+      "required": [
+        "error"
+      ]
+    }
+  ],
+  "properties": {
+    "available_deeper_admin_levels": {
+      "type": "array"
+    },
+    "batch_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "clarification": {
+      "type": "object"
+    },
+    "deeper_available": {
+      "type": "boolean"
+    },
+    "deepest_resolved_admin_level": {
+      "type": [
+        "string",
+        "integer",
+        "null"
+      ]
+    },
+    "deepest_resolved_family": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "deepest_resolved_loc_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "error": {
+      "additionalProperties": true,
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "details": {
+          "type": "object"
+        },
+        "message": {
+          "type": "string"
+        },
+        "retry_hint": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ],
+      "type": "object"
+    },
+    "family": {
+      "type": "string"
+    },
+    "family_result": {
+      "type": "object"
+    },
+    "guidance": {
+      "type": "object"
+    },
+    "join_keys": {
+      "type": "object"
+    },
+    "matched": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "meter_receipt": {
+      "type": "object"
+    },
+    "next_step": {
+      "additionalProperties": true,
+      "anyOf": [
+        {
+          "required": [
+            "action"
+          ]
+        },
+        {
+          "required": [
+            "tool"
+          ]
+        }
+      ],
+      "properties": {
+        "action": {
+          "type": "string"
+        },
+        "arguments": {
+          "type": "object"
+        },
+        "tool": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "overlap_families": {
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "point": {
+      "anyOf": [
+        {
+          "additionalProperties": true,
+          "properties": {
+            "lat": {
+              "type": "number"
+            },
+            "lon": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "lat",
+            "lon"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "point_count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "request_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "resolved_count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "results": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "error": {
+            "additionalProperties": true,
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "details": {
+                "type": "object"
+              },
+              "message": {
+                "type": "string"
+              },
+              "retry_hint": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "code",
+              "message"
+            ],
+            "type": "object"
+          },
+          "id": {
+            "type": [
+              "string",
+              "integer",
+              "null"
+            ]
+          },
+          "ok": {
+            "type": "boolean"
+          },
+          "row_index": {
+            "type": [
+              "string",
+              "integer",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "settlement_receipt": {
+      "type": "object"
+    },
+    "shallow_loc_id": {
+      "type": "string"
+    },
+    "stack": {
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "unresolved_count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "warnings": {
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

Changed4 schema fields changedSep 21, 2026

addedInput schema / oneOf

Added value: +[
+  {
+    "not": {
+      "required": [
+        "points"
+      ]
+    },
+    "required": [
+      "lat",
+      "lon"
+    ]
+  },
+  {
+    "not": {
+      "anyOf": [
+        {
+          "required": [
+            "lat"
+          ]
+        },
+        {
+          "required": [
+            "lon"
+          ]
+        }
+      ]
+    },
+    "required": [
+      "points"
+    ]
+  }
+]

addedInput schema / properties / batch_id

Added value: +{
+  "description": "Optional caller-supplied batch id echoed for point arrays.",
+  "type": "string"
+}

addedInput schema / properties / points

Added value: +{
+  "description": "Bounded WGS84 point array. Use top-level lat/lon instead for one point.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "string"
+          }
+        ]
+      },
+      "lat": {
+        "maximum": 90,
+        "minimum": -90,
+        "type": "number"
+      },
+      "lon": {
+        "maximum": 180,
+        "minimum": -180,
+        "type": "number"
+      },
+      "row_index": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "string"
+          }
+        ]
+      }
+    },
+    "required": [
+      "lat",
+      "lon"
+    ],
+    "type": "object"
+  },
+  "minItems": 1,
+  "type": "array"
+}

removedInput schema / required
```
Removed value: -[
-  "lat",
-  "lon"
-]
```

Changed10 schema fields changedSep 14, 2026

removedInput schema / anyOf

Removed value: -[
-  {
-    "required": [
-      "lat",
-      "lon"
-    ]
-  },
-  {
-    "required": [
-      "points"
-    ]
-  }
-]

removedInput schema / properties / admin_1_scope

Removed value: -{
-  "description": "Required in deep mode. One Admin 1 loc_id returned by the standard pass, such as USA-CA. Every point must belong to this owner partition.",
-  "type": "string"
-}

removedInput schema / properties / batch_id

Removed value: -{
-  "description": "Optional caller-supplied batch id echoed in the result.",
-  "type": "string"
-}

removedInput schema / properties / bulk_preset

Removed value: -{
-  "description": "Cross-country standard-mode path that fixes the exact result level. Use instead of country_scope; target_admin_level may be omitted.",
-  "enum": [
-    "global_admin_0",
-    "global_admin_1"
-  ],
-  "type": "string"
-}

removedInput schema / properties / country_hint

Removed value: -{
-  "description": "Alias for country_scope for clients that already use hint terminology.",
-  "type": "string"
-}

removedInput schema / properties / country_scope

Removed value: -{
-  "description": "ISO3/Admin 0 loc_id scope such as USA or CAN. Optional in standard mode and required in deep mode; every deep-mode point must belong to this one country.",
-  "type": "string"
-}

removedInput schema / properties / lookup_mode

Removed value: -{
-  "description": "Standard (default) caps I/O at Admin 3. Deep requires exactly one country_scope and one admin_1_scope, and opens at most one deep partition.",
-  "enum": [
-    "standard",
-    "deep"
-  ],
-  "type": "string"
-}

removedInput schema / properties / points

Removed value: -{
-  "description": "Points to resolve. Standard mode accepts cross-country batches and caps geometry I/O at Admin 3. Deep batches require one country_scope and one admin_1_scope; larger deep batches also require target_admin_level. Anonymous callers may receive a payment challenge; verified accounts have included throughput through 10,000 points.",
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "id": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "string"
-          }
-        ],
-        "description": "Optional caller point identifier echoed in the result."
-      },
-      "lat": {
-        "description": "Latitude in WGS84 decimal degrees.",
-        "maximum": 90,
-        "minimum": -90,
-        "type": "number"
-      },
-      "lon": {
-        "description": "Longitude in WGS84 decimal degrees.",
-        "maximum": 180,
-        "minimum": -180,
-        "type": "number"
-      },
-      "row_index": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "string"
-          }
-        ],
-        "description": "Optional caller row identifier echoed in the result."
-      }
-    },
-    "required": [
-      "lat",
-      "lon"
-    ],
-    "type": "object"
-  },
-  "minItems": 1,
-  "type": "array"
-}

changedInput schema / properties / target_admin_level / description

Previous value: -"Optional exact requested level. Standard mode accepts Admin 0-3; deep mode accepts Admin 4-6. Omit it to return the deepest available level permitted by the selected mode."New value: +"Optional exact requested level from Admin 0-3. Omit it to return the deepest available shallow level."

addedInput schema / required
```
Added value: +[
+  "lat",
+  "lon"
+]
```

Changed7 schema fields changedSep 13, 2026

addedInput schema / properties / admin_1_scope

Added value: +{
+  "description": "Required in deep mode. One Admin 1 loc_id returned by the standard pass, such as USA-CA. Every point must belong to this owner partition.",
+  "type": "string"
+}

changedInput schema / properties / bulk_preset / description

Previous value: -"Cross-country fast path that fixes the result level to admin_0 or admin_1. Use instead of country_scope; target_admin_level may be omitted."New value: +"Cross-country standard-mode path that fixes the exact result level. Use instead of country_scope; target_admin_level may be omitted."

changedInput schema / properties / country_scope / description

Previous value: -"ISO3/admin_0 loc_id scope such as USA or CAN. Optional for up to 100 exploratory points and required for larger batches; every point must belong to this one country."New value: +"ISO3/Admin 0 loc_id scope such as USA or CAN. Optional in standard mode and required in deep mode; every deep-mode point must belong to this one country."

addedInput schema / properties / include_marine_context

Added value: +{
+  "description": "Include parallel Marine overlaps for land matches. Defaults to true; set false for fast administrative loc_id previews. Offshore Marine fallback still applies.",
+  "type": "boolean"
+}

addedInput schema / properties / lookup_mode

Added value: +{
+  "description": "Standard (default) caps I/O at Admin 3. Deep requires exactly one country_scope and one admin_1_scope, and opens at most one deep partition.",
+  "enum": [
+    "standard",
+    "deep"
+  ],
+  "type": "string"
+}

changedInput schema / properties / points / description

Previous value: -"Points to resolve. Up to 25 may be exploratory. Above 25, country_scope and target_admin_level are required. Anonymous callers receive a payment challenge; verified accounts have included throughput through 10,000 points."New value: +"Points to resolve. Standard mode accepts cross-country batches and caps geometry I/O at Admin 3. Deep batches require one country_scope and one admin_1_scope; larger deep batches also require target_admin_level. Anonymous callers may receive a payment challenge; verified accounts have included throughput through 10,000 points."

changedInput schema / properties / target_admin_level / description

Previous value: -"Stopping level such as admin_0 through admin_5. Optional for up to 100 exploratory points and required for larger batches."New value: +"Optional exact requested level. Standard mode accepts Admin 0-3; deep mode accepts Admin 4-6. Omit it to return the deepest available level permitted by the selected mode."

Changed2 schema fields changedAug 26, 2026

changedInput schema / properties / country_scope / description

Previous value: -"ISO3/admin_0 loc_id scope such as USA or CAN. Optional for up to 25 exploratory points and required for larger batches; every point must belong to this one country."New value: +"ISO3/admin_0 loc_id scope such as USA or CAN. Optional for up to 100 exploratory points and required for larger batches; every point must belong to this one country."

changedInput schema / properties / target_admin_level / description

Previous value: -"Stopping level such as admin_0 through admin_5. Optional for up to 25 exploratory points and required for larger batches."New value: +"Stopping level such as admin_0 through admin_5. Optional for up to 100 exploratory points and required for larger batches."

Changed4 schema fields changedAug 13, 2026

addedInput schema / properties / bulk_preset

Added value: +{
+  "description": "Cross-country fast path that fixes the result level to admin_0 or admin_1. Use instead of country_scope; target_admin_level may be omitted.",
+  "enum": [
+    "global_admin_0",
+    "global_admin_1"
+  ],
+  "type": "string"
+}

changedInput schema / properties / country_scope / description

Previous value: -"Optional ISO3/admin_0 loc_id scope such as USA or CAN. Use only when every point in the request should be resolved inside that one country; this lets the runtime skip global country detection and use one country geometry bank."New value: +"ISO3/admin_0 loc_id scope such as USA or CAN. Optional for up to 25 exploratory points and required for larger batches; every point must belong to this one country."

changedInput schema / properties / points / description

Previous value: -"Points to resolve. Hosted default free preview is 25 points; larger valid batches return a payment-required quote instead of executing for free."New value: +"Points to resolve. Up to 25 may be exploratory. Above 25, country_scope and target_admin_level are required. Anonymous callers receive a payment challenge; verified accounts have included throughput through 10,000 points."

changedInput schema / properties / target_admin_level / description

Previous value: -"Optional stopping level such as admin_0 through admin_5. Omit for the normal complete chain through the deepest currently served tier."New value: +"Stopping level such as admin_0 through admin_5. Optional for up to 25 exploratory points and required for larger batches."

Changed2 schema fields changedAug 10, 2026

removedInput schema / properties / include_geometry

Removed value: -{
-  "description": "When true, include geometry in resolver internals where available. Default false to keep responses small.",
-  "type": "boolean"
-}

changedInput schema / properties / target_admin_level / description

Previous value: -"Requested administrative level such as admin_0, admin_1, admin_2, admin_3, admin_4, or admin_5. Default admin_2. Use deepest/all only when the caller explicitly needs the deepest supported local geometry."New value: +"Optional stopping level such as admin_0 through admin_5. Omit for the normal complete chain through the deepest currently served tier."

Changed5 schema fields changedAug 8, 2026

removedInput schema / properties / country

Removed value: -{
-  "description": "Alias for parent_loc_id/country_scope when the scope is an ISO3 country code.",
-  "type": "string"
-}

changedInput schema / properties / country_hint / description

Previous value: -"Alias for parent_loc_id/iso3. Use one country per paid/trusted bulk batch."New value: +"Alias for country_scope for clients that already use hint terminology."

changedInput schema / properties / country_scope / description

Previous value: -"Alias for parent_loc_id when the scope is an admin_0/country loc_id."New value: +"Optional ISO3/admin_0 loc_id scope such as USA or CAN. Use only when every point in the request should be resolved inside that one country; this lets the runtime skip global country detection and use one country geometry bank."

removedInput schema / properties / iso3

Removed value: -{
-  "description": "Alias for parent_loc_id/country_scope when the scope is an ISO3 country code.",
-  "type": "string"
-}

removedInput schema / properties / parent_loc_id

Removed value: -{
-  "description": "Optional country scope such as USA, CAN, or IND. Required for paid/trusted bulk point batches over the free preview limit. Bulk should use one country and one target_admin_level per call.",
-  "type": "string"
-}

Changed5 schema fields changedAug 8, 2026

addedInput schema / properties / country

Added value: +{
+  "description": "Alias for parent_loc_id/country_scope when the scope is an ISO3 country code.",
+  "type": "string"
+}

addedInput schema / properties / country_hint

Added value: +{
+  "description": "Alias for parent_loc_id/iso3. Use one country per paid/trusted bulk batch.",
+  "type": "string"
+}

addedInput schema / properties / country_scope

Added value: +{
+  "description": "Alias for parent_loc_id when the scope is an admin_0/country loc_id.",
+  "type": "string"
+}

addedInput schema / properties / iso3

Added value: +{
+  "description": "Alias for parent_loc_id/country_scope when the scope is an ISO3 country code.",
+  "type": "string"
+}

addedInput schema / properties / parent_loc_id

Added value: +{
+  "description": "Optional country scope such as USA, CAN, or IND. Required for paid/trusted bulk point batches over the free preview limit. Bulk should use one country and one target_admin_level per call.",
+  "type": "string"
+}

Changed2 schema fields changedAug 8, 2026

changedInput schema / properties / points / description

Previous value: -"Points to resolve. Hosted default maximum is 25 points per call."New value: +"Points to resolve. Hosted default free preview is 25 points; larger valid batches return a payment-required quote instead of executing for free."

addedInput schema / properties / target_admin_level

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "integer"
+    }
+  ],
+  "description": "Requested administrative level such as admin_0, admin_1, admin_2, admin_3, admin_4, or admin_5. Default admin_2. Use deepest/all only when the caller explicitly needs the deepest supported local geometry."
+}

Changed5 schema fields changedAug 7, 2026

addedInput schema / anyOf

Added value: +[
+  {
+    "required": [
+      "lat",
+      "lon"
+    ]
+  },
+  {
+    "required": [
+      "points"
+    ]
+  }
+]

addedInput schema / properties / batch_id

Added value: +{
+  "description": "Optional caller-supplied batch id echoed in the result.",
+  "type": "string"
+}

addedInput schema / properties / include_geometry

Added value: +{
+  "description": "When true, include geometry in resolver internals where available. Default false to keep responses small.",
+  "type": "boolean"
+}

addedInput schema / properties / points

Added value: +{
+  "description": "Points to resolve. Hosted default maximum is 25 points per call.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "string"
+          }
+        ],
+        "description": "Optional caller point identifier echoed in the result."
+      },
+      "lat": {
+        "description": "Latitude in WGS84 decimal degrees.",
+        "maximum": 90,
+        "minimum": -90,
+        "type": "number"
+      },
+      "lon": {
+        "description": "Longitude in WGS84 decimal degrees.",
+        "maximum": 180,
+        "minimum": -180,
+        "type": "number"
+      },
+      "row_index": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "string"
+          }
+        ],
+        "description": "Optional caller row identifier echoed in the result."
+      }
+    },
+    "required": [
+      "lat",
+      "lon"
+    ],
+    "type": "object"
+  },
+  "minItems": 1,
+  "type": "array"
+}

removedInput schema / required
```
Removed value: -[
-  "lat",
-  "lon"
-]
```

AddedJun 18, 2026

TDQS

A3.9/5.0

Behavior4/5

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

Annotations already declare readOnly/idempotent/non-destructive, so the description is free to add routing behavior, which it does well: 'No call crosses scopes or opens another family's bank' and the marine_jurisdiction exclusion are non-obvious constraints an agent could not infer from schema. It does not describe batching behavior or result shape, but the output schema covers returns.

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

Conciseness3/5

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

The routing rules are front-loaded and dense with value, but the trailing catalog paragraph ('252 geographic entities... Australia, Brazil, Canada...') is long, reads as release-note copy, and could be condensed to one sentence about deeper tiers being available in select countries.

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?

With a full schema, rich annotations, and an output schema, the only missing piece is coverage depth, and the description addresses it via the catalog paragraph. An agent has enough to route a point correctly across GLOBAL/ISO3/MARINE; the only gap is not naming resolve_deep_point for deeper queries.

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 goes further by explaining the conditional relationship between scope_id, family, and water_kind (e.g., water_body requires named or zone), which is semantics the enum alone does not convey. The lat/lon vs points alternation is left to the schema's oneOf.

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

Purpose4/5

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

States a specific verb and resource: 'Resolve WGS84 coordinates in exactly one selected scope and family,' and enumerates the scope families it handles. An agent can tell it apart from get_geography and compare_geographies, though the sibling resolve_deep_point (the obvious alternative for deeper tiers) is only implicitly gestured at via 'reaching up to Admin 2.'

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

Usage Guidelines4/5

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

Gives explicit per-scope conditions: GLOBAL finds Admin0, ISO3 finds the shallow country bank, MARINE requires one jurisdiction family or water_body with water_kind, and marine_jurisdiction has no point route. It also points to get_catalog for family discovery. It stops short of naming resolve_deep_point as the tool to use when the shallow bank is insufficient.

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

All DaedalMap Disaster and Geospatial Data 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.

Resolve Point(s) in One Scope

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources