DaedalMap Geography Tools (loc_id)
Resolve coordinates and geographic identifiers to loc_id, crosswalks, and bounded shapes.
Should I use this
Quality & Safety
A
Findings (1)
- LOWTool 'get_tool_help' description lacks action verbin get_tool_help
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~9,237Tokens (tool definitions)
~8.3 KBTypical response size
Significant attention impact (7.22% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"geocoding": {
"url": "https://app.daedalmap.com/mcp/geography"
}
}
}Remote endpoints
https://app.daedalmap.com/mcp/geographystreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢get_tool_help(tool_name, topic, question)
Describe one tool visible on this facade, including its exact contract, or return a bounded workflow overview for one supported topic.
Input Schema
{
"type": "object",
"properties": {
"tool_name": {
"type": "string",
"description": "Exact tool name from tools/list. Do not combine with topic."
},
"topic": {
"type": "string",
"enum": [
"overview",
"data",
"disasters",
"custom_data",
"geometry"
],
"description": "Workflow overview. Do not combine with tool_name."
},
"question": {
"type": "string",
"description": "Optional question used only with a topic overview."
}
},
"oneOf": [
{
"required": [
"tool_name"
],
"not": {
"required": [
"topic"
]
}
},
{
"required": [
"topic"
],
"not": {
"required": [
"tool_name"
]
}
}
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"provenance": {
"type": "object"
},
"ok": {
"type": "boolean"
},
"tool_name": {
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
},
"purpose": {
"type": "string"
},
"input_schema": {
"type": "object"
},
"access": {
"type": "object"
},
"examples": {
"type": "array"
},
"important_output_fields": {
"type": "array"
},
"recommended_next_calls": {
"type": "array"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"ok",
"tool_name"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢get_catalog(catalog)
Choose data or geometry to list published pack IDs or family and scope IDs. The response includes a complete catalog download URL. Use get_pack for data or get_geography for 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
{
"type": "object",
"properties": {
"catalog": {
"type": "string",
"enum": [
"data",
"geometry"
],
"description": "Required directory selector."
}
},
"required": [
"catalog"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"provenance": {
"type": "object"
},
"catalog": {
"type": "string",
"enum": [
"data",
"geometry"
]
},
"detail": {
"type": "string",
"enum": [
"lite",
"full",
"download"
]
},
"catalog_version": {
"type": "string"
},
"generated_at": {
"type": [
"string",
"null"
]
},
"pack_count": {
"type": "integer",
"minimum": 0
},
"packs": {
"type": "array",
"items": {
"type": "object"
}
},
"families": {
"type": "array",
"items": {
"type": "object"
}
},
"scopes": {
"type": "array",
"items": {
"type": "object"
}
},
"uncertain_packs": {
"type": "array",
"items": {
"type": "object"
}
},
"uncertain_count": {
"type": "integer",
"minimum": 0
},
"excluded_count": {
"type": "integer",
"minimum": 0
},
"result_status": {
"type": "string"
},
"resolved_query": {
"type": "object"
},
"tool_families": {
"type": "array",
"items": {
"type": "object"
}
},
"download_url": {
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"catalog"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢get_pack(pack_id)
Inspect one exact data pack ID for its metrics, time coverage, and query metadata before get_data.
Input Schema
{
"type": "object",
"properties": {
"pack_id": {
"type": "string",
"description": "Pack identifier from get_catalog. Newly catalog-admitted packs require no MCP schema change."
}
},
"required": [
"pack_id"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"provenance": {
"type": "object"
},
"catalog": {
"type": "string",
"enum": [
"data"
]
},
"pack_id": {
"type": "string"
},
"detail": {
"type": "string",
"enum": [
"lite",
"full",
"download"
]
},
"sources": {
"type": "array",
"items": {
"type": "object"
}
},
"material_policy": {
"type": "object"
},
"download_url": {
"type": "string"
},
"full_call": {
"type": "object"
},
"download_call": {
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"catalog",
"pack_id",
"detail"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢get_geography(family_id, scope_id, year)
Inspect one published geometry family across scopes or one scope across families. Returns coverage and known editions from catalog metadata only. Optional year selects the latest admitted edition no later than that year when the selected catalog has an edition index; an unavailable index is reported explicitly.
Input Schema
{
"type": "object",
"properties": {
"family_id": {
"type": "string",
"minLength": 1
},
"scope_id": {
"type": "string",
"minLength": 3
},
"year": {
"type": "integer",
"minimum": 1,
"maximum": 9999
}
},
"oneOf": [
{
"required": [
"family_id"
]
},
{
"required": [
"scope_id"
]
}
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"provenance": {
"type": "object"
},
"catalog": {
"type": "string",
"enum": [
"geometry"
]
},
"family_id": {
"type": [
"string",
"null"
]
},
"scope_id": {
"type": [
"string",
"null"
]
},
"requested_year": {
"type": [
"integer",
"null"
]
},
"coverage": {
"type": "array",
"items": {
"type": "object"
}
},
"admin_spine": {
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"catalog",
"coverage"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢resolve_point(scope_id, family, water_kind, lat, lon, ...)
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
{
"type": "object",
"properties": {
"scope_id": {
"type": "string",
"minLength": 3,
"description": "GLOBAL, MARINE, or one published ISO3 country. No automatic fallback into another scope."
},
"family": {
"type": "string",
"enum": [
"administrative",
"exclusive_economic_zone",
"territorial_seas",
"contiguous_zones",
"extended_continental_shelves",
"internal_waters",
"archipelagic_waters",
"high_seas",
"water_body"
],
"description": "One exact family within the selected scope."
},
"water_kind": {
"type": "string",
"enum": [
"named",
"zone"
],
"description": "Required only for MARINE water_body: named seas or water zones."
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude in WGS84 decimal degrees."
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude in WGS84 decimal degrees."
},
"points": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"row_index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
}
},
"required": [
"lat",
"lon"
],
"additionalProperties": false
},
"description": "Bounded WGS84 point array. Use top-level lat/lon instead for one point."
},
"batch_id": {
"type": "string",
"description": "Optional caller-supplied batch id echoed for point arrays."
},
"request_id": {
"type": "string",
"description": "Optional caller-supplied request id for tracing."
}
},
"oneOf": [
{
"required": [
"scope_id",
"family",
"lat",
"lon"
],
"not": {
"required": [
"points"
]
}
},
{
"required": [
"scope_id",
"family",
"points"
],
"not": {
"anyOf": [
{
"required": [
"lat"
]
},
{
"required": [
"lon"
]
}
]
}
}
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"batch_id": {
"type": [
"string",
"null"
]
},
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"meter_receipt": {
"type": "object"
},
"settlement_receipt": {
"type": "object"
},
"point": {
"anyOf": [
{
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lon": {
"type": "number"
}
},
"required": [
"lat",
"lon"
],
"additionalProperties": true
},
{
"type": "null"
}
]
},
"point_count": {
"type": "integer",
"minimum": 0
},
"resolved_count": {
"type": "integer",
"minimum": 0
},
"unresolved_count": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"row_index": {
"type": [
"string",
"integer",
"null"
]
},
"id": {
"type": [
"string",
"integer",
"null"
]
}
},
"additionalProperties": true
}
},
"matched": {
"type": [
"object",
"null"
]
},
"stack": {
"type": "array",
"items": {
"type": "object"
}
},
"overlap_families": {
"type": "array",
"items": {
"type": "object"
}
},
"deepest_resolved_loc_id": {
"type": [
"string",
"null"
]
},
"deepest_resolved_admin_level": {
"type": [
"string",
"integer",
"null"
]
},
"deepest_resolved_family": {
"type": [
"string",
"null"
]
},
"shallow_loc_id": {
"type": "string"
},
"family": {
"type": "string"
},
"family_result": {
"type": "object"
},
"deeper_available": {
"type": "boolean"
},
"available_deeper_admin_levels": {
"type": "array"
},
"join_keys": {
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"point",
"stack"
]
},
{
"required": [
"point",
"family",
"family_result"
]
},
{
"required": [
"point_count",
"results"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢resolve_deep_point(lat, lon, points, shallow_loc_id, target_admin_level, ...)
Second-pass containment only after resolve_point. Supply the original WGS84 coordinate or a bounded point array, one shared shallow_loc_id returned by resolve_point, and one canonical family from get_catalog(catalog='geometry'). family defaults to administrative; shape-backed families use direct bbox-to-exact-shape lookup without crosswalks. Single and bulk requests share this scoped contract. 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
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude in WGS84 decimal degrees."
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude in WGS84 decimal degrees."
},
"points": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"row_index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
}
},
"required": [
"lat",
"lon"
],
"additionalProperties": false
},
"description": "Points already known to fall within the supplied shallow_loc_id scope."
},
"shallow_loc_id": {
"type": "string",
"minLength": 5,
"description": "The deepest canonical Admin 1-3 loc_id returned by resolve_point, such as USA-NY-061-009903."
},
"target_admin_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Optional exact Admin 4-6 level. Omit for the deepest available match."
},
"family": {
"type": "string",
"pattern": "^[a-z0-9_]+$",
"default": "administrative",
"description": "One family selector. Defaults to administrative; use marine for the direct Marine resolver, or a canonical country family such as postal_area, watershed, or land_management_region."
},
"batch_id": {
"type": "string",
"description": "Optional caller-supplied batch id echoed for point arrays."
},
"request_id": {
"type": "string",
"description": "Optional caller-supplied request id for tracing."
}
},
"required": [
"shallow_loc_id"
],
"oneOf": [
{
"required": [
"lat",
"lon"
],
"not": {
"required": [
"points"
]
}
},
{
"required": [
"points"
],
"not": {
"anyOf": [
{
"required": [
"lat"
]
},
{
"required": [
"lon"
]
}
]
}
}
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"batch_id": {
"type": [
"string",
"null"
]
},
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"meter_receipt": {
"type": "object"
},
"settlement_receipt": {
"type": "object"
},
"point": {
"anyOf": [
{
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lon": {
"type": "number"
}
},
"required": [
"lat",
"lon"
],
"additionalProperties": true
},
{
"type": "null"
}
]
},
"point_count": {
"type": "integer",
"minimum": 0
},
"resolved_count": {
"type": "integer",
"minimum": 0
},
"unresolved_count": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"row_index": {
"type": [
"string",
"integer",
"null"
]
},
"id": {
"type": [
"string",
"integer",
"null"
]
}
},
"additionalProperties": true
}
},
"matched": {
"type": [
"object",
"null"
]
},
"stack": {
"type": "array",
"items": {
"type": "object"
}
},
"overlap_families": {
"type": "array",
"items": {
"type": "object"
}
},
"deepest_resolved_loc_id": {
"type": [
"string",
"null"
]
},
"deepest_resolved_admin_level": {
"type": [
"string",
"integer",
"null"
]
},
"deepest_resolved_family": {
"type": [
"string",
"null"
]
},
"shallow_loc_id": {
"type": "string"
},
"family": {
"type": "string"
},
"family_result": {
"type": "object"
},
"deeper_available": {
"type": "boolean"
},
"available_deeper_admin_levels": {
"type": "array"
},
"join_keys": {
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"point",
"stack"
]
},
{
"required": [
"point",
"family",
"family_result"
]
},
{
"required": [
"point_count",
"results"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢get_loc_id_info(loc_id, loc_ids, batch_id, request_id)
Look up one known loc_id or a small batch in the selected reference graph. Return its identity and directly recorded loc_id connections, with family, direction, and relationship evidence. Each ID returns at most 50 connections and an explicit has_more flag. This tool does not expand descendants, infer containment, read shapes, search catalogs, or consult external adapters. No payment required.
Input Schema
{
"type": "object",
"properties": {
"loc_id": {
"type": "string",
"description": "DaedalMap loc_id, e.g. 'USA-CA'."
},
"loc_ids": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "string"
},
"description": "Up to 10 known loc_ids, including a resolve_point stack."
},
"batch_id": {
"type": "string",
"description": "Optional caller-supplied batch id for tracing."
},
"request_id": {
"type": "string",
"description": "Optional caller-supplied request id for tracing."
}
},
"oneOf": [
{
"required": [
"loc_id"
]
},
{
"required": [
"loc_ids"
]
}
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"batch_id": {
"type": [
"string",
"null"
]
},
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"meter_receipt": {
"type": "object"
},
"settlement_receipt": {
"type": "object"
},
"loc_id": {
"type": "string"
},
"requested_loc_id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"iso3": {
"type": [
"string",
"null"
]
},
"family": {
"type": [
"string",
"null"
]
},
"admin_level": {
"type": [
"string",
"integer",
"null"
]
},
"loc_id_count": {
"type": "integer",
"minimum": 0
},
"found_count": {
"type": "integer",
"minimum": 0
},
"missing_count": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"row_index": {
"type": [
"string",
"integer",
"null"
]
},
"id": {
"type": [
"string",
"integer",
"null"
]
}
},
"additionalProperties": true
}
},
"connections": {
"type": "array",
"items": {
"type": "object"
}
},
"connection_count": {
"type": "integer",
"minimum": 0
},
"connection_limit": {
"type": "integer",
"minimum": 1
},
"has_more": {
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"loc_id"
]
},
{
"required": [
"loc_id_count",
"results"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢identify_dataset_geography(columns, dataset_context, country_scope, request_id)
Fast structural column selector: pass bounded named columns to find recognized geography headers or latitude/longitude pairs. It does not infer a country, level, or identifier system, open country indexes, or validate values. If more than one column is plausible, select one; then call identify_reference_system with the selected identifier column and one country_scope. No payment required.
Input Schema
{
"type": "object",
"properties": {
"columns": {
"type": "array",
"minItems": 1,
"maxItems": 64,
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"values": {
"type": "array",
"maxItems": 32,
"items": {
"type": "string"
}
},
"nonempty_count": {
"type": "integer",
"minimum": 0
}
},
"required": [
"name",
"values"
],
"additionalProperties": false
},
"description": "Structurally filtered columns with deterministic representative scalar values. Do not pre-label their geographic system."
},
"dataset_context": {
"type": "object",
"properties": {
"file_name": {
"type": "string"
},
"sheet_name": {
"type": "string"
},
"row_count": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"country_scope": {
"type": "string",
"description": "Optional caller-declared ISO3 country, passed through to the selected column."
},
"request_id": {
"type": "string"
}
},
"required": [
"columns"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"batch_id": {
"type": [
"string",
"null"
]
},
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"meter_receipt": {
"type": "object"
},
"settlement_receipt": {
"type": "object"
},
"status": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 0
},
"identifier_count": {
"type": "integer",
"minimum": 0
},
"column_count": {
"type": "integer",
"minimum": 0
},
"candidates": {
"type": "array",
"items": {
"type": "object"
}
},
"recommended_binding": {
"type": [
"object",
"null"
]
},
"coordinate_binding": {
"type": [
"object",
"null"
]
},
"review_required": {
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"ok",
"status",
"candidates"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢identify_reference_system(identifier, identifiers, expected, country_scope, dataset_context, ...)
Identify one selected identifier column within one required ISO3 country, GLOBAL, or MARINE scope. Pass bounded strings preserving leading zeros. It checks maintained identifier evidence, not dataset columns or polygons. Ambiguous systems stay unselected until expected.system is supplied. Use identify_dataset_geography first when the column is unknown. No payment required.
Input Schema
{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"description": "One geography identifier to inspect."
},
"identifiers": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
},
"description": "A bounded representative identifier sample. Duplicate values are checked once. Values must be strings so leading zeros are preserved."
},
"expected": {
"type": "object",
"properties": {
"system": {
"type": "string",
"description": "Caller-declared reference system, such as us_census_geoid, loc_id, zcta, or a catalog reference system. Supply it immediately when known, or after choosing an identification result."
},
"geo_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Expected geography level, such as tract or admin_3."
},
"vintage": {
"type": "string",
"description": "Expected source/reference vintage, such as 2020."
},
"country_scope": {
"type": "string",
"description": "Expected ISO3 country scope."
}
},
"additionalProperties": false
},
"country_scope": {
"type": "string",
"description": "Required single ISO3 country, GLOBAL, or MARINE scope. Missing scope fails before identifier reads."
},
"dataset_context": {
"type": "object",
"description": "Bounded, non-row dataset clues used to rank plausible interpretations without replacing exact identifier verification.",
"properties": {
"file_name": {
"type": "string"
},
"sheet_name": {
"type": "string"
},
"column_name": {
"type": "string"
},
"column_names": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1000
},
"row_geography": {
"type": "string",
"description": "Optional plain-language clue such as county, tract, or ZIP area."
},
"local_format_match_rate": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"additionalProperties": false
},
"validation_scope": {
"type": "string",
"enum": [
"sample",
"all_distinct_identifiers"
],
"description": "Describes whether the bounded input is a sample or, only when it fits the identification cap, the complete distinct-key set. This tool validates every supplied identifier; create_conversion_job validates every row in the full dataset."
},
"request_id": {
"type": "string",
"description": "Optional caller-supplied request id for tracing."
}
},
"required": [
"country_scope"
],
"anyOf": [
{
"required": [
"identifier"
]
},
{
"required": [
"identifiers"
]
}
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"batch_id": {
"type": [
"string",
"null"
]
},
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"meter_receipt": {
"type": "object"
},
"settlement_receipt": {
"type": "object"
},
"status": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 0
},
"identifier_count": {
"type": "integer",
"minimum": 0
},
"column_count": {
"type": "integer",
"minimum": 0
},
"candidates": {
"type": "array",
"items": {
"type": "object"
}
},
"recommended_binding": {
"type": [
"object",
"null"
]
},
"coordinate_binding": {
"type": [
"object",
"null"
]
},
"review_required": {
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"ok",
"status",
"candidates"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢convert_reference(from_system, value, to_system, items, iso3, ...)
Convert within one declared scope per call: iso3 is required and names one ISO3 country, GLOBAL, or MARINE. A batch uses one from_system, to_system, and crosswalk_id, with at most 25000 requested result rows. Convert X -> loc_id -> Y; omit to_system to enter the loc_id universe. For admin or city names use from_system admin_boundary with a country_hint inside the declared country. A published direct crosswalk uses one selected artifact; if the system pair has multiple artifacts, supply crosswalk_id from the typed ambiguity error. An exact miss ends on that artifact. Use get_geography when family or scope coverage is unknown. The tools/list access metadata states authored free, account, and paid item allowances; active operator policy may waive payment.
Input Schema
{
"type": "object",
"properties": {
"from_system": {
"type": "string",
"description": "Input reference system, such as admin_boundary (admin and city names; admin_text and place_name are accepted aliases), zip, overlay_zcta, nws_fire, tribal, or loc_id."
},
"value": {
"type": "string",
"description": "Identifier or name in the input system, for example 'Springfield, Illinois' with admin_boundary."
},
"to_system": {
"type": "string",
"default": "daedalmap.loc_id",
"description": "Optional output reference system. Defaults to DaedalMap loc_id; provide zcta, nws_fire, overlay_nws_public_zone, overlay_tribal, admin_local, or another catalog system for any-to-any conversion."
},
"items": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"from_system": {
"type": "string",
"description": "Input reference system for this row. Defaults to top-level from_system when omitted."
},
"value": {
"type": "string",
"description": "Identifier or name in the input system."
},
"to_system": {
"type": "string",
"description": "Output reference system for this row. Defaults to top-level to_system when omitted."
},
"iso3": {
"type": "string",
"description": "Optional repeat of the top-level scope; must match it. Split mixed countries or packs into separate calls."
},
"target_admin_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Optional intermediate admin target level for this row."
},
"relationship_vintage": {
"type": "string",
"description": "Optional relationship vintage for this row."
},
"crosswalk_id": {
"type": "string",
"description": "Exact published crosswalk ID when the source/target system pair has multiple artifacts."
},
"min_share": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Optional minimum overlap share threshold for this row."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum ranked output references for this row."
},
"country_hint": {
"type": "string",
"description": "Optional country hint for admin/name resolution (USA), or a subdivision to search within (USA-OR). Names may also carry their parent: 'Washington County, Oregon'. Ambiguous names return candidates instead of a match."
},
"admin_level_hint": {
"type": "integer",
"minimum": 0,
"maximum": 6,
"description": "Optional admin-level hint for admin/name resolution."
},
"as_of": {
"type": "string",
"description": "ISO date or year used for time-bounded identities."
},
"row_index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Optional caller row identifier echoed in the result."
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Optional caller identifier echoed in the result."
}
},
"required": [
"value"
],
"additionalProperties": false
},
"description": "Reference conversions within one scope and one source/target/crosswalk route. Split mixed routes. Maximum requested item count times per-item limit is 25000."
},
"iso3": {
"type": "string",
"minLength": 3,
"description": "Required scope pack for the entire call: one ISO3 country, GLOBAL, or MARINE. Every item must stay within this scope."
},
"target_admin_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Admin level used as the intermediate crosswalk target. Default admin_2."
},
"relationship_vintage": {
"type": "string",
"description": "Optional source relationship vintage to require."
},
"crosswalk_id": {
"type": "string",
"description": "Exact published crosswalk ID when the source/target system pair has multiple artifacts. A route ambiguity error lists valid IDs."
},
"min_share": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Optional minimum overlap share threshold."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum ranked output references to return. Default 10."
},
"country_hint": {
"type": "string",
"description": "Optional country hint for admin/name resolution (USA), or a subdivision to search within (USA-OR). Names may also carry their parent: 'Washington County, Oregon'. Ambiguous names return candidates instead of a match."
},
"admin_level_hint": {
"type": "integer",
"minimum": 0,
"maximum": 6,
"description": "Optional admin-level hint for admin/name resolution."
},
"as_of": {
"type": "string",
"description": "ISO date or year used for time-bounded identities."
},
"batch_id": {
"type": "string",
"description": "Optional caller-supplied batch id for tracing."
},
"request_id": {
"type": "string",
"description": "Optional caller-supplied request id for tracing."
}
},
"anyOf": [
{
"required": [
"iso3",
"from_system",
"value"
]
},
{
"required": [
"iso3",
"items"
]
}
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"batch_id": {
"type": [
"string",
"null"
]
},
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"meter_receipt": {
"type": "object"
},
"settlement_receipt": {
"type": "object"
},
"from_system": {
"type": "string"
},
"to_system": {
"type": "string"
},
"loc_id": {
"type": [
"string",
"null"
]
},
"from": {
"type": "object"
},
"item_count": {
"type": "integer",
"minimum": 0
},
"converted_count": {
"type": "integer",
"minimum": 0
},
"unconverted_count": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"row_index": {
"type": [
"string",
"integer",
"null"
]
},
"id": {
"type": [
"string",
"integer",
"null"
]
}
},
"additionalProperties": true
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"ok",
"results"
]
},
{
"required": [
"item_count",
"results"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢compare_geographies(left_loc_id, right_loc_id, as_of, left_as_of, right_as_of, ...)
Compare two known loc_ids using selected reference-graph identity and direct relationship evidence. Verified Admin ancestry can prove containment; a typed graph edge can prove only the relation it declares. An explicit negative edge returns no_overlap; a missing edge returns unknown. This tool never reads polygons or computes shape intersections. Use an external identifier bridge before this call when the input is not a loc_id. No payment required.
Input Schema
{
"type": "object",
"properties": {
"left_loc_id": {
"type": "string",
"minLength": 1,
"description": "First DaedalMap loc_id."
},
"right_loc_id": {
"type": "string",
"minLength": 1,
"description": "Second DaedalMap loc_id."
},
"as_of": {
"type": "string",
"description": "ISO date or year applied to both identities."
},
"left_as_of": {
"type": "string",
"description": "Optional ISO date or year for the left identity; overrides as_of."
},
"right_as_of": {
"type": "string",
"description": "Optional ISO date or year for the right identity; overrides as_of."
},
"include_successors": {
"type": "boolean",
"description": "Include direct successors and present-day descendants for maintained historical identities. Default true."
},
"items": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"left_loc_id": {
"type": "string",
"minLength": 1
},
"right_loc_id": {
"type": "string",
"minLength": 1
},
"as_of": {
"type": "string"
},
"left_as_of": {
"type": "string"
},
"right_as_of": {
"type": "string"
},
"include_successors": {
"type": "boolean"
},
"row_index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
}
},
"required": [
"left_loc_id",
"right_loc_id"
],
"additionalProperties": false
},
"description": "Bounded geography pairs to compare in one call."
},
"batch_id": {
"type": "string",
"description": "Optional caller-supplied batch id for tracing."
},
"request_id": {
"type": "string",
"description": "Optional caller-supplied request id for tracing."
}
},
"oneOf": [
{
"required": [
"left_loc_id",
"right_loc_id"
]
},
{
"required": [
"items"
]
}
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"batch_id": {
"type": [
"string",
"null"
]
},
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"meter_receipt": {
"type": "object"
},
"settlement_receipt": {
"type": "object"
},
"spatial_relation": {
"type": [
"string",
"object",
"null"
]
},
"temporal_relation": {
"type": [
"string",
"object",
"null"
]
},
"relationship_basis": {
"type": "string"
},
"graph_evidence": {
"type": "array",
"items": {
"type": "object"
}
},
"geometry_loaded": {
"type": "boolean"
},
"item_count": {
"type": "integer",
"minimum": 0
},
"compared_count": {
"type": "integer",
"minimum": 0
},
"failed_count": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"row_index": {
"type": [
"string",
"integer",
"null"
]
},
"id": {
"type": [
"string",
"integer",
"null"
]
}
},
"additionalProperties": true
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"ok",
"spatial_relation"
]
},
{
"required": [
"item_count",
"results"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢get_shape(loc_id, loc_ids, include_polygon, batch_id, request_id)
Shape lookup for exact existing loc_ids only. The default returns shape availability, centroid, and bounding box; include_polygon=true adds GeoJSON coordinates. Obtain any descendant IDs before this call. Historical geometry is returned first and successors are never substituted automatically. Year selection is not yet supported.
Input Schema
{
"type": "object",
"properties": {
"loc_id": {
"type": "string",
"description": "DaedalMap loc_id, such as USA-CA-037, USA-Z-00601, USA-NWSFZ-AKZ317, EEZ-USA, or IHO1953-240001002."
},
"loc_ids": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "string"
},
"description": "Exact DaedalMap loc_ids to fetch in one call. Default public cap is deployment-configurable and lower when include_polygon is true."
},
"include_polygon": {
"type": "boolean",
"description": "When true, include the full GeoJSON geometry. Default false."
},
"batch_id": {
"type": "string",
"description": "Optional caller-supplied batch id for tracing."
},
"request_id": {
"type": "string",
"description": "Optional caller-supplied request id for tracing."
}
},
"oneOf": [
{
"required": [
"loc_id"
]
},
{
"required": [
"loc_ids"
]
}
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"request_id": {
"type": [
"string",
"null"
]
},
"batch_id": {
"type": [
"string",
"null"
]
},
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"reason": {
"type": "string"
},
"next_step": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"url": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"anyOf": [
{
"required": [
"action"
]
},
{
"required": [
"tool"
]
}
],
"additionalProperties": true
},
"warnings": {
"type": "array",
"items": {
"type": "object"
}
},
"guidance": {
"type": "object"
},
"clarification": {
"type": "object"
},
"meter_receipt": {
"type": "object"
},
"settlement_receipt": {
"type": "object"
},
"selection": {
"type": "string",
"enum": [
"exact_loc_ids"
]
},
"include_polygon": {
"type": "boolean"
},
"requested": {
"type": "integer",
"minimum": 0
},
"available": {
"type": "integer",
"minimum": 0
},
"missing": {
"type": "integer",
"minimum": 0
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object"
},
"retry_hint": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": true
},
"row_index": {
"type": [
"string",
"integer",
"null"
]
},
"id": {
"type": [
"string",
"integer",
"null"
]
}
},
"additionalProperties": true
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"ok",
"selection",
"items"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}Community
Evidence
Recent observations
verifiedversion not recorded12 tools
verifiedversion not recorded12 tools
verifiedversion not recorded11 tools
verifiedversion not recorded11 tools
verifiedversion not recorded11 tools