DaedalMap Geography Tools (loc_id)
Resolve coordinates and geographic identifiers to loc_id, crosswalks, and bounded shapes.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Befunde (1)
- LOWTool 'get_tool_help' description lacks action verbin get_tool_help
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~9,250Tokens (Tool-Definitionen)
~9.2 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (7.23% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"geocoding": {
"url": "https://app.daedalmap.com/mcp/geography"
}
}
}Remote-Endpunkte
https://app.daedalmap.com/mcp/geographystreamable-httpWas es kann
Tool-Inventar
Tools (11)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.
Eingabe-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
}Ausgabe-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, detail, country_scope, loc_id, time_range)
Discover data packs or geometry families progressively: lite selection, full metric/query inventory, or a raw catalog download URL. Choose one result and call get_pack next. 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.
Eingabe-Schema
{
"type": "object",
"properties": {
"catalog": {
"type": "string",
"enum": [
"data",
"geometry"
],
"default": "data",
"description": "Catalog family. The geography facade defaults to geometry; other facades default to data."
},
"detail": {
"type": "string",
"enum": [
"lite",
"full",
"download"
],
"default": "lite",
"description": "Use lite to select a pack, full for expanded metric/query inventories, or download for the complete raw catalog URL."
},
"country_scope": {
"type": "string",
"description": "Optional ISO3 focus for catalog='geometry' with detail='lite'."
},
"loc_id": {
"type": "string",
"description": "Optional DaedalMap loc_id for catalog='data'. Combine with time_range to discover packs confirmed for both place and time. For place details without pack filtering, use get_loc_id_info."
},
"time_range": {
"type": "object",
"properties": {
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
}
},
"additionalProperties": false,
"description": "Optional inclusive discovery window for catalog='data'. At least one bound is required."
}
},
"additionalProperties": false
}Ausgabe-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"
}
},
"tool_families": {
"type": "array",
"items": {
"type": "object"
}
},
"download_url": {
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"required": [
"catalog",
"detail"
]
},
{
"required": [
"error"
]
}
],
"additionalProperties": true
}🟢get_pack(catalog, pack_id, detail, country_scope, release_unit)
Inspect one selected data pack or geometry family progressively: lite starter contract, full MCP query metadata, or a raw metadata download URL. Use its next_step to retrieve data or call the preferred geometry tool.
Eingabe-Schema
{
"type": "object",
"properties": {
"catalog": {
"type": "string",
"enum": [
"data",
"geometry"
],
"description": "Metadata family. When omitted, geometry facades default to geometry and known geometry-family ids are inferred; all other calls default to data."
},
"pack_id": {
"type": "string",
"description": "Pack identifier from get_catalog. Newly catalog-admitted packs require no MCP schema change."
},
"detail": {
"type": "string",
"enum": [
"lite",
"full",
"download"
],
"default": "lite",
"description": "Use lite to decide and start, full for detailed MCP query metadata, or download for the complete raw metadata file."
},
"country_scope": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Optional ISO3 country for a geometry family. Omit it to learn which countries publish the family; provide it for country-specific versions, vintages, levels, and artifacts."
},
"release_unit": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Optional non-country geometry release unit such as GLOBAL or MARINE. Do not combine with country_scope."
}
},
"required": [
"pack_id"
],
"additionalProperties": false
}Ausgabe-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"
]
},
"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
}🟢resolve_point(lat, lon, points, target_admin_level, include_marine_context, ...)
Compact first-pass reverse geocoding for one WGS84 coordinate or a bounded point array. Returns administrative loc_id chains through Admin 3 without opening deep partitions or side-family shape banks. Use a returned shallow loc_id with resolve_deep_point for Admin 4-6 or one explicit family. Single and bulk requests share this contract; access limits are based on point count. 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.
Eingabe-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": "Bounded WGS84 point array. Use top-level lat/lon instead for one point."
},
"target_admin_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Optional exact requested level from Admin 0-3. Omit it to return the deepest available shallow level."
},
"include_marine_context": {
"type": "boolean",
"description": "Include parallel Marine overlaps for land matches. Defaults to true; set false for fast administrative loc_id previews. Offshore Marine fallback still applies."
},
"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": [
"lat",
"lon"
],
"not": {
"required": [
"points"
]
}
},
{
"required": [
"points"
],
"not": {
"anyOf": [
{
"required": [
"lat"
]
},
{
"required": [
"lon"
]
}
]
}
}
],
"additionalProperties": false
}Ausgabe-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 resolution for one WGS84 coordinate or a bounded point array. Supply 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.
Eingabe-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
}Ausgabe-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, include_hierarchy, include_references, systems, ...)
Known-place navigation and enrichment tool: use only when you already have one canonical loc_id or a bounded loc_ids array. It returns identity, strict stored parentage, lifecycle, shape status, and place-specific data-pack and geometry-family availability with executable next calls. It does not list the global catalog and does not return polygon coordinates; use get_catalog to browse everything or get_geometry for shapes. Set include_hierarchy for same-release ancestors and include_references for maintained external or cross-family connections. Historical records are never replaced automatically. No payment required.
Eingabe-Schema
{
"type": "object",
"properties": {
"loc_id": {
"type": "string",
"description": "DaedalMap loc_id, e.g. 'USA-CA'."
},
"loc_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "DaedalMap loc_ids to inspect together, including every loc_id from a resolve_point stack. Default public cap is deployment-configurable."
},
"include_hierarchy": {
"type": "boolean",
"description": "When true, include strict stored parent and ancestor data. This never invents a parent edge across mixed releases. Default false."
},
"include_references": {
"type": "boolean",
"description": "When true, include known external or side-chain references attached to each loc_id. Default false."
},
"systems": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional reference systems to include when include_references is true, such as zcta, nws_fire, overlay_tribal, or overlay_nws_public_zone."
},
"iso3": {
"type": "string",
"description": "Optional country hint for crosswalk artifacts. Defaults to the loc_id country when possible."
},
"target_admin_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Admin level for crosswalk-backed reverse reference lookup. Inferred when omitted."
},
"min_share": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Optional minimum target-area share for reverse overlap references."
},
"limit_per_system": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum overlap references to return per bridge/system. Default 10."
},
"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": [
"loc_id"
]
},
{
"required": [
"loc_ids"
]
}
],
"additionalProperties": false
}Ausgabe-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
}
},
"hierarchy": {
"type": "object"
},
"references": {
"type": "object"
},
"data_packs": {
"type": "array"
},
"geometry_families": {
"type": "array"
},
"next_calls": {
"type": "array"
}
},
"$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)
Multi-column dataset classifier: use when you do not yet know which column or latitude/longitude pair represents geography. Pass bounded samples from several named scalar columns; it selects the plausible geography column(s), then proposes a country, level, and maintained reference-system binding. It does not validate a preselected identifier column value-by-value; after selecting a code column, use identify_reference_system when explicit verification is needed. Returns up to three reviewable bindings and recommends only an unambiguous high-confidence result. No geometry is loaded and no full dataset is retained. No payment required.
Eingabe-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 hint. Omit when unknown."
},
"request_id": {
"type": "string"
}
},
"required": [
"columns"
],
"additionalProperties": false
}Ausgabe-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, ...)
Single-column code-system classifier: use after an identifier column has already been selected, or to inspect one bounded set of like geography codes. Pass only identifier strings from that one field so leading zeros are preserved. It determines or verifies the system, country, level, vintage, and compatible geometry bank; it does not choose among dataset columns, convert the full dataset, or return polygons. Use identify_dataset_geography instead when column selection is still unknown. Ambiguous results remain unselected until the caller retries with expected.system; a known system can be verified by supplying expected on the first call. No payment required.
Eingabe-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": "Optional ISO3 country hint used to narrow candidate banks."
},
"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."
}
},
"anyOf": [
{
"required": [
"identifier"
]
},
{
"required": [
"identifiers"
]
}
],
"additionalProperties": false
}Ausgabe-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, ...)
The single geographic reference converter. Converts one reference, or a bounded list, through DaedalMap loc_id: X -> loc_id -> Y. Omit to_system to enter the loc_id universe; provide it for any-to-any conversion. Use get_pack first when the family or country-specific system is unknown. No payment required.
Eingabe-Schema
{
"type": "object",
"properties": {
"from_system": {
"type": "string",
"description": "Input reference system, such as zip, overlay_zcta, nws_fire, tribal, admin_boundary, or loc_id."
},
"value": {
"type": "string",
"description": "Identifier or name in the input system."
},
"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 country hint for this row."
},
"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."
},
"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."
},
"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 to run in one call. Default public cap is deployment-configurable."
},
"iso3": {
"type": "string",
"description": "Country hint for crosswalk artifacts. Default USA."
},
"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."
},
"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."
},
"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": [
"from_system",
"value"
]
},
{
"required": [
"items"
]
}
],
"additionalProperties": false
}Ausgabe-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 geographic identities for the public guarantees implemented today: containment/common ancestry and temporal validity for the requested vintages. The response may include additional maintained evidence, but callers must not rely on deeper topology or relationship semantics as a stable contract until that review is complete. Use convert_reference first for names or outside identifiers. No payment required.
Eingabe-Schema
{
"type": "object",
"properties": {
"left_loc_id": {
"type": "string",
"description": "First DaedalMap loc_id."
},
"right_loc_id": {
"type": "string",
"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"
},
"right_loc_id": {
"type": "string"
},
"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."
}
},
"anyOf": [
{
"required": [
"left_loc_id",
"right_loc_id"
]
},
{
"required": [
"items"
]
}
],
"additionalProperties": false
}Ausgabe-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"
]
},
"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_geometry(loc_id, loc_ids, scope, include_polygon, batch_id, ...)
Shape availability and bounded coordinate retrieval only: use when you already have exact loc_ids, or one administrative parent_loc_id plus target admin_level. The default fast preflight returns has_shape, shape metadata, centroid, and bounding box; set include_polygon=true only for GeoJSON coordinates. Use get_loc_id_info for hierarchy, identity, catalog coverage, or crosswalk facts; get_geometry does not return those place details. Administrative scope queries stay within the optimized Admin Spine layout, while independent geometry families require exact loc_ids. Historical geometry is returned first and successors are never substituted automatically. No payment required.
Eingabe-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."
},
"scope": {
"type": "object",
"properties": {
"parent_loc_id": {
"type": "string",
"description": "Administrative parent loc_id, such as USA-TX or CAN-BC."
},
"admin_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Descendant level to retrieve, such as admin_2, 2, or county."
},
"bbox": {
"anyOf": [
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 4,
"maxItems": 4
},
{
"type": "string"
}
],
"description": "Optional minLon,minLat,maxLon,maxLat intersection filter."
}
},
"required": [
"parent_loc_id",
"admin_level"
],
"additionalProperties": false
},
"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"
]
},
{
"required": [
"scope"
]
}
],
"additionalProperties": false
}Ausgabe-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",
"admin_scope"
]
},
"scope": {
"type": [
"object",
"null"
]
},
"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
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet11 Tools