DaedalMap Disaster and Geospatial Data

{'type': 'object', 'anyOf': [{'required': ['left_loc_id', 'right_loc_id']}, {'required': ['items']}], 'properties': {'as_of': {'type': 'string', 'description': 'ISO date or year applied to both identities.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['left_loc_id', 'right_loc_id'], 'properties': {'id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}, 'as_of': {'type': 'string'}, 'row_index': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}, 'left_as_of': {'type': 'string'}, 'left_loc_id': {'type': 'string'}, 'right_as_of': {'type': 'string'}, 'right_loc_id': {'type': 'string'}, 'include_successors': {'type': 'boolean'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Bounded geography pairs to compare in one call.'}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id for tracing.'}, 'left_as_of': {'type': 'string', 'description': 'Optional ISO date or year for the left identity; overrides as_of.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'left_loc_id': {'type': 'string', 'description': 'First DaedalMap loc_id.'}, 'right_as_of': {'type': 'string', 'description': 'Optional ISO date or year for the right identity; overrides as_of.'}, 'right_loc_id': {'type': 'string', 'description': 'Second DaedalMap loc_id.'}, 'include_successors': {'type': 'boolean', 'description': 'Include direct successors and present-day descendants for maintained historical identities. Default true.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'spatial_relation']}, {'required': ['item_count', 'results']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'reason': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': ['string', 'integer', 'null']}, 'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'row_index': {'type': ['string', 'integer', 'null']}}, 'additionalProperties': True}}, 'batch_id': {'type': ['string', 'null']}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'item_count': {'type': 'integer', 'minimum': 0}, 'request_id': {'type': ['string', 'null']}, 'failed_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'compared_count': {'type': 'integer', 'minimum': 0}, 'spatial_relation': {'type': ['string', 'object', 'null']}, 'temporal_relation': {'type': ['string', 'object', 'null']}, 'settlement_receipt': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'anyOf': [{'required': ['from_system', 'value']}, {'required': ['items']}], 'properties': {'iso3': {'type': 'string', 'description': 'Country hint for crosswalk artifacts. Default USA.'}, 'as_of': {'type': 'string', 'description': 'ISO date or year used for time-bounded identities.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['value'], 'properties': {'id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}], 'description': 'Optional caller identifier echoed in the result.'}, 'iso3': {'type': 'string', 'description': 'Optional country hint for this row.'}, 'as_of': {'type': 'string', 'description': 'ISO date or year used for time-bounded identities.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum ranked output references for this row.'}, 'value': {'type': 'string', 'description': 'Identifier or name in the input system.'}, 'min_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional minimum overlap share threshold for this row.'}, 'row_index': {'anyOf': [{'type': 'integer'}, {'type': 'string'}], 'description': 'Optional caller row identifier echoed in the result.'}, 'to_system': {'type': 'string', 'description': 'Output reference system for this row. Defaults to top-level to_system when omitted.'}, 'from_system': {'type': 'string', 'description': 'Input reference system for this row. Defaults to top-level from_system when omitted.'}, 'country_hint': {'type': 'string', 'description': 'Optional country hint for admin/name resolution.'}, 'admin_level_hint': {'type': 'integer', 'maximum': 6, 'minimum': 0, 'description': 'Optional admin-level hint for admin/name resolution.'}, '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.'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Reference conversions to run in one call. Default public cap is deployment-configurable.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum ranked output references to return. Default 10.'}, 'value': {'type': 'string', 'description': 'Identifier or name in the input system.'}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id for tracing.'}, 'min_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional minimum overlap share threshold.'}, '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.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'from_system': {'type': 'string', 'description': 'Input reference system, such as zip, overlay_zcta, nws_fire, tribal, admin_boundary, or loc_id.'}, 'country_hint': {'type': 'string', 'description': 'Optional country hint for admin/name resolution.'}, 'admin_level_hint': {'type': 'integer', 'maximum': 6, 'minimum': 0, 'description': 'Optional admin-level hint for admin/name resolution.'}, '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.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'results']}, {'required': ['item_count', 'results']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'from': {'type': 'object'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'loc_id': {'type': ['string', 'null']}, 'reason': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': ['string', 'integer', 'null']}, 'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'row_index': {'type': ['string', 'integer', 'null']}}, 'additionalProperties': True}}, 'batch_id': {'type': ['string', 'null']}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'to_system': {'type': 'string'}, 'item_count': {'type': 'integer', 'minimum': 0}, 'request_id': {'type': ['string', 'null']}, 'from_system': {'type': 'string'}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'converted_count': {'type': 'integer', 'minimum': 0}, 'unconverted_count': {'type': 'integer', 'minimum': 0}, 'settlement_receipt': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'detail': {'enum': ['lite', 'full', 'download'], 'type': 'string', 'default': 'lite', 'description': 'Use lite to select a pack, full for expanded metric/query inventories, or download for the complete raw catalog URL.'}, '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."}, 'catalog': {'enum': ['data', 'geometry'], 'type': 'string', 'default': 'data', 'description': 'Catalog family. The geography facade defaults to geometry; other facades default to data.'}, 'time_range': {'type': 'object', 'properties': {'end': {'anyOf': [{'type': 'string'}, {'type': 'integer'}]}, 'start': {'anyOf': [{'type': 'string'}, {'type': 'integer'}]}}, 'description': "Optional inclusive discovery window for catalog='data'. At least one bound is required.", 'additionalProperties': False}, 'country_scope': {'type': 'string', 'description': "Optional ISO3 focus for catalog='geometry' with detail='lite'."}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['catalog', 'detail']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'packs': {'type': 'array', 'items': {'type': 'object'}}, 'detail': {'enum': ['lite', 'full', 'download'], 'type': 'string'}, 'reason': {'type': 'string'}, 'catalog': {'enum': ['data', 'geometry'], 'type': 'string'}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'pack_count': {'type': 'integer', 'minimum': 0}, 'provenance': {'type': 'object'}, 'request_id': {'type': ['string', 'null']}, 'download_url': {'type': 'string'}, 'generated_at': {'type': ['string', 'null']}, 'clarification': {'type': 'object'}, 'tool_families': {'type': 'array', 'items': {'type': 'object'}}, 'catalog_version': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['pack_id', 'metrics', 'filters'], 'properties': {'sort': {'anyOf': [{'type': 'object', 'required': ['field'], 'properties': {'field': {'type': 'string', 'minLength': 1}, 'direction': {'enum': ['asc', 'desc'], 'type': 'string'}}, 'additionalProperties': False}, {'type': 'array', 'items': {'type': 'object', 'required': ['field'], 'properties': {'field': {'type': 'string', 'minLength': 1}, 'direction': {'enum': ['asc', 'desc'], 'type': 'string'}}, 'additionalProperties': False}}], 'description': 'Sort by a sortable field from get_pack; direction defaults to asc.'}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Maximum number of rows to return for the requested source or pack.'}, 'output': {'type': 'object', 'properties': {'format': {'enum': ['rows'], 'type': 'string', 'default': 'rows'}, 'include_provenance': {'type': 'boolean', 'default': False}}, 'description': 'Optional response controls. v1 supports rows only.', 'additionalProperties': False}, 'filters': {'type': 'object', 'properties': {'time': {'type': 'object', 'anyOf': [{'required': ['value']}, {'required': ['start']}, {'required': ['end']}], 'properties': {'end': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'string', 'format': 'date'}, {'type': 'integer'}]}, 'start': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'string', 'format': 'date'}, {'type': 'integer'}]}, 'value': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'string', 'format': 'date'}, {'type': 'integer'}]}, 'granularity': {'enum': ['daily', 'weekly', 'monthly', 'yearly', 'timestamp'], 'type': 'string'}}, 'description': 'Inclusive ISO-8601 date/datetime or integer-year selection. Use YYYY-MM-DD, not partial YYYY-MM strings.', 'additionalProperties': False}, 'equals': {'type': 'object', 'description': 'Exact field/value filters using filterable fields published by get_pack.', 'additionalProperties': {'anyOf': [{'type': ['string', 'number', 'integer', 'boolean', 'null']}, {'type': 'array', 'items': {'type': ['string', 'number', 'integer', 'boolean']}}]}}, 'compare': {'type': 'array', 'items': {'type': 'object', 'required': ['field', 'op', 'value'], 'properties': {'op': {'enum': ['=', '!=', '>', '>=', '<', '<='], 'type': 'string'}, 'field': {'type': 'string', 'minLength': 1}, 'value': {}}, 'additionalProperties': False}, 'description': 'Threshold filters using filterable fields or selected metric ids published by get_pack.'}, 'region_ids': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1, 'description': 'Canonical country or hierarchical loc_ids from get_pack, such as JPN or USA-TX.', 'uniqueItems': True}}, 'additionalProperties': {'anyOf': [{'type': ['string', 'number', 'integer', 'boolean', 'null']}, {'type': 'array', 'items': {'type': ['string', 'number', 'integer', 'boolean']}}]}}, 'metrics': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1, 'description': 'Exact metric ids from get_pack. Use event_count for aggregate counts only when get_pack publishes it.', 'uniqueItems': True}, 'pack_id': {'type': 'string', 'minLength': 1, 'description': 'Pack identifier from get_catalog. Newly catalog-admitted packs require no MCP schema change.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing and idempotency.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['source_id', 'row_count', 'rows']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'rows': {'type': 'array', 'items': {'type': 'object'}}, 'sort': {'type': 'array'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'limit': {'type': 'integer'}, 'reason': {'type': 'string'}, 'pack_id': {'type': 'string'}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'row_count': {'type': 'integer', 'minimum': 0}, 'source_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'provenance': {'type': 'object'}, 'query_mode': {'type': 'string'}, 'request_id': {'type': ['string', 'null']}, 'capability_id': {'type': 'string'}, 'clarification': {'type': 'object'}, 'filters_applied': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['event_id'], 'properties': {'limit': {'type': 'integer', 'default': 100, 'maximum': 500, 'minimum': 1, 'description': 'Per-section ceiling for relationships, affected places, observations, or geometry frames.'}, 'include': {'type': 'array', 'items': {'enum': ['relationships', 'affected_places', 'observations', 'geometry'], 'type': 'string'}, 'description': 'Optional companion layers. Omit for the lightweight event summary. Geometry is never returned implicitly.', 'uniqueItems': True}, 'pack_id': {'type': 'string', 'description': 'Optional disaster pack hint. Recommended when known to avoid probing unrelated event sources.'}, 'event_id': {'type': 'string', 'minLength': 1, 'description': 'Exact stable event_id returned by a disaster-pack get_data row.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'geometry_mode': {'enum': ['current', 'timeline'], 'type': 'string', 'default': 'current', 'description': 'current returns the representative/current shape; timeline returns bounded progression frames where supported.'}, 'relationship_depth': {'type': 'integer', 'default': 1, 'maximum': 2, 'minimum': 1, 'description': 'Bounded cross-hazard traversal depth when relationships is included.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['event_id', 'pack_id', 'event']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'event': {'type': 'object'}, 'reason': {'type': 'string'}, 'pack_id': {'type': 'string'}, 'event_id': {'type': 'string'}, 'geometry': {'type': 'object'}, 'guidance': {'type': 'object'}, 'included': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'available': {'type': 'object'}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'source_id': {'type': 'string'}, 'event_type': {'type': 'string'}, 'next_steps': {'type': 'object'}, 'provenance': {'type': 'object'}, 'request_id': {'type': ['string', 'null']}, 'observations': {'type': 'object'}, 'schema_class': {'type': 'string'}, 'clarification': {'type': 'object'}, 'relationships': {'type': 'object'}, 'affected_places': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'oneOf': [{'required': ['loc_id']}, {'required': ['loc_ids']}, {'required': ['scope']}], 'properties': {'scope': {'type': 'object', 'required': ['parent_loc_id', 'admin_level'], 'properties': {'bbox': {'anyOf': [{'type': 'array', 'items': {'type': 'number'}, 'maxItems': 4, 'minItems': 4}, {'type': 'string'}], 'description': 'Optional minLon,minLat,maxLon,maxLat intersection filter.'}, 'admin_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Descendant level to retrieve, such as admin_2, 2, or county.'}, 'parent_loc_id': {'type': 'string', 'description': 'Administrative parent loc_id, such as USA-TX or CAN-BC.'}}, 'additionalProperties': False}, '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', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'Exact DaedalMap loc_ids to fetch in one call. Default public cap is deployment-configurable and lower when include_polygon is true.', 'uniqueItems': True}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id for tracing.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'include_polygon': {'type': 'boolean', 'description': 'When true, include the full GeoJSON geometry. Default false.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'selection', 'items']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': ['string', 'integer', 'null']}, 'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'row_index': {'type': ['string', 'integer', 'null']}}, 'additionalProperties': True}}, 'scope': {'type': ['object', 'null']}, 'reason': {'type': 'string'}, 'missing': {'type': 'integer', 'minimum': 0}, 'batch_id': {'type': ['string', 'null']}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'available': {'type': 'integer', 'minimum': 0}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'requested': {'type': 'integer', 'minimum': 0}, 'selection': {'enum': ['exact_loc_ids', 'admin_scope'], 'type': 'string'}, 'request_id': {'type': ['string', 'null']}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'include_polygon': {'type': 'boolean'}, 'settlement_receipt': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'anyOf': [{'required': ['loc_id']}, {'required': ['loc_ids']}], 'properties': {'iso3': {'type': 'string', 'description': 'Optional country hint for crosswalk artifacts. Defaults to the loc_id country when possible.'}, '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.'}, '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.'}, 'batch_id': {'type': 'string', 'description': 'Optional caller-supplied batch id for tracing.'}, 'min_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional minimum target-area share for reverse overlap references.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'limit_per_system': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum overlap references to return per bridge/system. Default 10.'}, '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.'}, 'target_admin_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Admin level for crosswalk-backed reverse reference lookup. Inferred when omitted.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['loc_id']}, {'required': ['loc_id_count', 'results']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'iso3': {'type': ['string', 'null']}, 'name': {'type': ['string', 'null']}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'family': {'type': ['string', 'null']}, 'loc_id': {'type': 'string'}, 'reason': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': ['string', 'integer', 'null']}, 'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'row_index': {'type': ['string', 'integer', 'null']}}, 'additionalProperties': True}}, 'batch_id': {'type': ['string', 'null']}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'hierarchy': {'type': 'object'}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'data_packs': {'type': 'array'}, 'next_calls': {'type': 'array'}, 'references': {'type': 'object'}, 'request_id': {'type': ['string', 'null']}, 'admin_level': {'type': ['string', 'integer', 'null']}, 'found_count': {'type': 'integer', 'minimum': 0}, 'loc_id_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'missing_count': {'type': 'integer', 'minimum': 0}, 'requested_loc_id': {'type': 'string'}, 'geometry_families': {'type': 'array'}, 'settlement_receipt': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['pack_id'], 'properties': {'detail': {'enum': ['lite', 'full', 'download'], 'type': 'string', 'default': 'lite', 'description': 'Use lite to decide and start, full for detailed MCP query metadata, or download for the complete raw metadata file.'}, 'catalog': {'enum': ['data', 'geometry'], 'type': 'string', '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.'}, '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.'}, '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.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['catalog', 'pack_id', 'detail']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'detail': {'enum': ['lite', 'full', 'download'], 'type': 'string'}, 'reason': {'type': 'string'}, 'catalog': {'enum': ['data', 'geometry'], 'type': 'string'}, 'pack_id': {'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'object'}}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'full_call': {'type': 'object'}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'provenance': {'type': 'object'}, 'request_id': {'type': ['string', 'null']}, 'download_url': {'type': 'string'}, 'clarification': {'type': 'object'}, 'download_call': {'type': 'object'}, 'material_policy': {'type': 'object'}}, 'additionalProperties': True}

{'type': 'object', 'oneOf': [{'not': {'required': ['topic']}, 'required': ['tool_name']}, {'not': {'required': ['tool_name']}, 'required': ['topic']}], 'properties': {'topic': {'enum': ['overview', 'data', 'disasters', 'custom_data', 'geometry'], 'type': 'string', 'description': 'Workflow overview. Do not combine with tool_name.'}, 'question': {'type': 'string', 'description': 'Optional question used only with a topic overview.'}, 'tool_name': {'type': 'string', 'description': 'Exact tool name from tools/list. Do not combine with topic.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'tool_name']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'title': {'type': ['string', 'null']}, 'access': {'type': 'object'}, 'reason': {'type': 'string'}, 'purpose': {'type': 'string'}, 'examples': {'type': 'array'}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'tool_name': {'type': 'string'}, 'provenance': {'type': 'object'}, 'request_id': {'type': ['string', 'null']}, 'input_schema': {'type': 'object'}, 'clarification': {'type': 'object'}, 'recommended_next_calls': {'type': 'array'}, 'important_output_fields': {'type': 'array'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['columns'], 'properties': {'columns': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'values'], 'properties': {'name': {'type': 'string'}, 'values': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 32}, 'nonempty_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 64, 'minItems': 1, 'description': 'Structurally filtered columns with deterministic representative scalar values. Do not pre-label their geographic system.'}, 'request_id': {'type': 'string'}, 'country_scope': {'type': 'string', 'description': 'Optional caller-declared ISO3 hint. Omit when unknown.'}, 'dataset_context': {'type': 'object', 'properties': {'file_name': {'type': 'string'}, 'row_count': {'type': 'integer', 'minimum': 0}, 'sheet_name': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'status', 'candidates']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'limit': {'type': 'integer', 'minimum': 0}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'batch_id': {'type': ['string', 'null']}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'candidates': {'type': 'array', 'items': {'type': 'object'}}, 'request_id': {'type': ['string', 'null']}, 'column_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'review_required': {'type': 'boolean'}, 'identifier_count': {'type': 'integer', 'minimum': 0}, 'coordinate_binding': {'type': ['object', 'null']}, 'settlement_receipt': {'type': 'object'}, 'recommended_binding': {'type': ['object', 'null']}}, 'additionalProperties': True}

{'type': 'object', 'anyOf': [{'required': ['identifier']}, {'required': ['identifiers']}], 'properties': {'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.'}, 'vintage': {'type': 'string', 'description': 'Expected source/reference vintage, such as 2020.'}, 'geo_level': {'anyOf': [{'type': 'string'}, {'type': 'integer'}], 'description': 'Expected geography level, such as tract or admin_3.'}, 'country_scope': {'type': 'string', 'description': 'Expected ISO3 country scope.'}}, 'additionalProperties': False}, 'identifier': {'type': 'string', 'description': 'One geography identifier to inspect.'}, 'request_id': {'type': 'string', 'description': 'Optional caller-supplied request id for tracing.'}, 'identifiers': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'A bounded representative identifier sample. Duplicate values are checked once. Values must be strings so leading zeros are preserved.'}, 'country_scope': {'type': 'string', 'description': 'Optional ISO3 country hint used to narrow candidate banks.'}, 'dataset_context': {'type': 'object', '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', 'maximum': 1, 'minimum': 0}}, 'description': 'Bounded, non-row dataset clues used to rank plausible interpretations without replacing exact identifier verification.', 'additionalProperties': False}, 'validation_scope': {'enum': ['sample', 'all_distinct_identifiers'], 'type': 'string', '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.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['ok', 'status', 'candidates']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object'}, 'message': {'type': 'string'}, 'retry_hint': {'type': 'string'}}, 'additionalProperties': True}, 'limit': {'type': 'integer', 'minimum': 0}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'batch_id': {'type': ['string', 'null']}, 'guidance': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}}, 'next_step': {'type': 'object', 'anyOf': [{'required': ['action']}, {'required': ['tool']}], 'properties': {'url': {'type': 'string'}, 'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'arguments': {'type': 'object'}}, 'additionalProperties': True}, 'candidates': {'type': 'array', 'items': {'type': 'object'}}, 'request_id': {'type': ['string', 'null']}, 'column_count': {'type': 'integer', 'minimum': 0}, 'clarification': {'type': 'object'}, 'meter_receipt': {'type': 'object'}, 'review_required': {'type': 'boolean'}, 'identifier_count': {'type': 'integer', 'minimum': 0}, 'coordinate_binding': {'type': ['object', 'null']}, 'settlement_receipt': {'type': 'object'}, 'recommended_binding': {'type': ['object', 'null']}}, 'additionalProperties': True}

{'type': 'object', 'oneOf': [{'not': {'required': ['points']}, 'required': ['lat', 'lon']}, {'not': {'anyOf': [{'required': ['lat']}, {'required': ['lon']}]}, 'required': ['points']}], 'required': ['shallow_loc_id'], 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in WGS84 decimal degrees.'}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in WGS84 decimal degrees.'}, 'family': {'type': 'string', 'default': 'administrative', 'pattern': '^[a-z0-9_]+$', '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.'}, 'points': {'type': 'array', 'items': {'type': 'object', 'required': ['lat', 'lon'], 'properties': {'id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'row_index': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Points already known to fall within the supplied shallow_loc_id scope.'}, '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.'}, '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.'}}, 'additionalProperties': False}

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

{'type': 'object', 'oneOf': [{'not': {'required': ['points']}, 'required': ['lat', 'lon']}, {'not': {'anyOf': [{'required': ['lat']}, {'required': ['lon']}]}, 'required': ['points']}], 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in WGS84 decimal degrees.'}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in WGS84 decimal degrees.'}, 'points': {'type': 'array', 'items': {'type': 'object', 'required': ['lat', 'lon'], 'properties': {'id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'row_index': {'anyOf': [{'type': 'integer'}, {'type': 'string'}]}}, 'additionalProperties': False}, 'minItems': 1, '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.'}, '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', 'default': False, 'description': 'Opt in to parallel Marine overlaps for land matches. Defaults to false so ordinary administrative resolution stays lightweight. Offshore Marine fallback still applies.'}}, 'additionalProperties': False}

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