Ask in plain English, get a rendered, shareable map from live public data. 24 geospatial tools.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Your ShowMeOnMap API key as `Bearer smo_live_…` — mint one at showmeonmap.com → account menu → API keys.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add a user-placed label at a specific coordinate. Annotations are independent of layers and live in their own id namespace. Strict: the id must not already be in use by another CURRENTLY-placed annotation (removed ids can be recycled).
Stable id for this annotation — caller-supplied.
[lng, lat] in WGS84.
Optional CSS color for the marker + label.
Optional text rendered at the point.
Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add a user-placed label at a specific coordinate. Annotations are independent of layers and live in their own id namespace. Strict: the id must not already be in use by another CURRENTLY-placed annotation (removed ids can be recycled).
| Argument | Type | Description |
|---|---|---|
| id* | string | Stable id for this annotation — caller-supplied. |
| color | string | Optional CSS color for the marker + label. |
| label | string | Optional text rendered at the point. |
| coords* | array | [lng, lat] in WGS84. |
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"id",
"coords"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Stable id for this annotation — caller-supplied."
},
"color": {
"type": "string",
"minLength": 1,
"description": "Optional CSS color for the marker + label."
},
"label": {
"type": "string",
"description": "Optional text rendered at the point."
},
"coords": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 2,
"minItems": 2,
"description": "[lng, lat] in WGS84."
},
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Spatially join two existing layers and add a new layer that encodes both values per region as a 3x3 bivariate choropleth. Both layers must already exist in the workspace. Auto-detects the numeric value field from each layer's viz config; pass value_field_a / value_field_b to override. Returns the new layer_id, correlation r, and matched-feature count. Required: map_id, layer_a_id, layer_b_id.
| Argument | Type | Description |
|---|---|---|
| mode | string | |
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| layer_a_id* | string | |
| layer_b_id* | string | |
| new_layer_id | string | |
| value_field_a | string | |
| value_field_b | string |
{
"type": "object",
"required": [
"map_id",
"layer_a_id",
"layer_b_id"
],
"properties": {
"mode": {
"type": "string",
"const": "bivariate",
"default": "bivariate"
},
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"layer_a_id": {
"type": "string",
"minLength": 1
},
"layer_b_id": {
"type": "string",
"minLength": 1
},
"new_layer_id": {
"type": "string"
},
"value_field_a": {
"type": "string"
},
"value_field_b": {
"type": "string"
}
}
}Append a fully-constructed LayerPlan to an existing workspace without going through NL. Pass the same shape the workspace pipeline emits — { id, title, source, viz, geometry, ... }. Takes a structured plan; natural-language edits go through mutate_map. The full LayerPlan and Op spec are documented in the MCP resource showmeonmap://docs/workspace-ops-spec.
| Argument | Type | Description |
|---|---|---|
| intent | string | Optional. Which mental model is this add_layer operating under? "primary-data" = the layer the user actually asked to see; "context-overlay" = supporting data layered on top of a primary; "reference-boundary" = admin/geo boundary used as a backdrop; "annotation" = caller-placed callout / pin layer; "comparison" = a layer added to compare against another; "other" = none of the above. |
| map_id* | string | map_id from a prior build_map call |
| layerPlan* | object | Full LayerPlan object. Must include id, title, source, viz, geometry. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"layerPlan"
],
"properties": {
"intent": {
"enum": [
"primary-data",
"context-overlay",
"reference-boundary",
"annotation",
"comparison",
"other"
],
"type": "string",
"description": "Optional. Which mental model is this add_layer operating under? \"primary-data\" = the layer the user actually asked to see; \"context-overlay\" = supporting data layered on top of a primary; \"reference-boundary\" = admin/geo boundary used as a backdrop; \"annotation\" = caller-placed callout / pin layer; \"comparison\" = a layer added to compare against another; \"other\" = none of the above."
},
"map_id": {
"type": "string",
"minLength": 1,
"description": "map_id from a prior build_map call"
},
"layerPlan": {
"type": "object",
"description": "Full LayerPlan object. Must include id, title, source, viz, geometry.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Make an interactive, data-driven map from a plain-language request, built from live public data with every value cited to its source. Covers natural hazards (earthquakes, wildfires, volcanoes, tropical storms, floods), weather and air quality, statistics by country, state or region (GDP, population, health, emissions — World Bank, Eurostat, US Census), infrastructure and transit (railways, power plants, transit lines, roads), parks and terrain, and points of interest from OpenStreetMap. The query carries the place, time window and any thresholds — "earthquakes above magnitude 5 near Japan this month", "GDP per capita across Europe" — and the server applies them itself. Returns a shareable link and a map_id for follow-ups (mutate_map, filter_layer, get_state); in clients that support MCP Apps the map also renders interactively in the conversation. The Op catalog and predicate grammar that downstream tools (mutate_map, filter_layer, etc.) accept are documented in the MCP resource showmeonmap://docs/workspace-ops-spec.
| Argument | Type | Description |
|---|---|---|
| query* | string | Natural language: "coffee shops in Tokyo", "GDP by country", "volcanoes in Indonesia", etc. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Natural language: \"coffee shops in Tokyo\", \"GDP by country\", \"volcanoes in Indonesia\", etc."
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Wipe every predicate currently applied to a layer's filter chain, making every source feature visible again. Inverse of filter_layer. No-op on layers that have no existing filter. GATED: pass confirmed:true to proceed; otherwise a needs_confirmation envelope is returned.
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| layerId* | string | |
| confirmed | boolean | Set to true to confirm this sensitive action. If omitted or false, the call returns a needs_confirmation envelope. A cleared filter chain can be restored with undo. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"layerId"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"layerId": {
"type": "string",
"minLength": 1
},
"confirmed": {
"type": "boolean",
"description": "Set to true to confirm this sensitive action. If omitted or false, the call returns a needs_confirmation envelope. A cleared filter chain can be restored with undo."
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Spatially join two existing workspace layers and return the Pearson correlation coefficient r, sample size n, two-sided p-value approximation, plus human-readable strength and direction labels. Pure read — no layer is added, no op is committed, no credit charge. Returns numbers only; add_fusion_layer renders the same join as a map layer. Required: map_id, layer_a_id, layer_b_id.
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| layer_a_id* | string | |
| layer_b_id* | string | |
| value_field_a | string | |
| value_field_b | string |
{
"type": "object",
"required": [
"map_id",
"layer_a_id",
"layer_b_id"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"layer_a_id": {
"type": "string",
"minLength": 1
},
"layer_b_id": {
"type": "string",
"minLength": 1
},
"value_field_a": {
"type": "string"
},
"value_field_b": {
"type": "string"
}
}
}Returns a deep-link URL that opens the map in the user's browser and automatically triggers a PNG download. The user clicks the link, the browser renders the map at full resolution with the legend composited (if legend: true), and the file downloads. There is no server-side rendering; the user's browser is the renderer. Required: map_id. Optional: format (png default), legend (true default).
| Argument | Type | Description |
|---|---|---|
| format | string | |
| legend | boolean | |
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id"
],
"properties": {
"format": {
"enum": [
"png",
"jpeg",
"pdf"
],
"type": "string",
"default": "png"
},
"legend": {
"type": "boolean",
"default": true
},
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Export a single layer's features as a downloadable file. Returns a URL with Content-Disposition: attachment so the user's browser downloads it. CSV drops geometry beyond a (lng, lat) centroid — for full polygon/line geometry, use format: "geojson". The URL is an unguessable capability link that does NOT expire: anyone with the link can download the file. Required: map_id, layer_id, format.
| Argument | Type | Description |
|---|---|---|
| format* | string | |
| map_id* | string | |
| layer_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"layer_id",
"format"
],
"properties": {
"format": {
"enum": [
"csv",
"geojson"
],
"type": "string"
},
"map_id": {
"type": "string",
"minLength": 1
},
"layer_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Return the current workspace document (ops log + cursor + meta) plus the materialized mapPlan and layerFilters, in a shape suitable for save-to-file / share-by-URL / inspection. Pure read — no mutation, no credit charge. This is the full raw state for serialization; get_state returns a compact summary for display.
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Narrow a layer to features matching a structured predicate. `append:true` (default) conjoins with any existing filter; `append:false` replaces the chain.
| Argument | Type | Description |
|---|---|---|
| append | boolean | Default true. false replaces the layer's existing filter chain. |
| intent | string | Optional. Which mental model is this filter operating under? "narrow" = generic shrink-the-set; "isolate-outliers" = pull out anomalies for inspection; "compare-subset" = pre-step before a side-by-side compare; "preview-data" = exploratory peek; "other" = none of the above. |
| map_id* | string | |
| layerId* | string | id of the layer to filter |
| predicate* | object | Predicate in the Mongo-shape grammar. Examples: {op:"eq",field:"category",value:"cafe"}, {op:"gt",field:"magnitude",value:5}, {op:"within",geometry:{type:"Polygon",coordinates:[...]}}, {op:"and",children:[...]}. See docs/superpowers/specs/2026-04-17-workspace-ops-log-design.md §6. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"layerId",
"predicate"
],
"properties": {
"append": {
"type": "boolean",
"description": "Default true. false replaces the layer's existing filter chain."
},
"intent": {
"enum": [
"narrow",
"isolate-outliers",
"compare-subset",
"preview-data",
"other"
],
"type": "string",
"description": "Optional. Which mental model is this filter operating under? \"narrow\" = generic shrink-the-set; \"isolate-outliers\" = pull out anomalies for inspection; \"compare-subset\" = pre-step before a side-by-side compare; \"preview-data\" = exploratory peek; \"other\" = none of the above."
},
"map_id": {
"type": "string",
"minLength": 1
},
"layerId": {
"type": "string",
"minLength": 1,
"description": "id of the layer to filter"
},
"predicate": {
"type": "object",
"description": "Predicate in the Mongo-shape grammar. Examples: {op:\"eq\",field:\"category\",value:\"cafe\"}, {op:\"gt\",field:\"magnitude\",value:5}, {op:\"within\",geometry:{type:\"Polygon\",coordinates:[...]}}, {op:\"and\",children:[...]}. See docs/superpowers/specs/2026-04-17-workspace-ops-log-design.md §6.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Refine an existing layer to a NAMED area the server resolves from OpenStreetMap — a street corridor ("Broadway from Arbutus Street to Main Street"), a place ("Mount Pleasant"), or an intersection surroundings. Pass names only, never coordinates; unresolvable names return a clarification with real nearby candidates instead of guessed geometry. Emits ordinary undoable ops (filter / new layer + camera) and a grounded summary like "kept 37 of 150 features". Costs 1 credit when a mutation lands; clarifications are refunded.
| Argument | Type | Description |
|---|---|---|
| mode | string | filter (default): hide features outside, reversible. select: copy matches into a new layer. clip: new layer with geometry trimmed at the boundary. |
| map_id* | string | |
| areaRef* | any | |
| layerId* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"layerId",
"areaRef"
],
"properties": {
"mode": {
"enum": [
"filter",
"select",
"clip"
],
"type": "string",
"description": "filter (default): hide features outside, reversible. select: copy matches into a new layer. clip: new layer with geometry trimmed at the boundary."
},
"map_id": {
"type": "string",
"minLength": 1
},
"areaRef": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"name"
],
"properties": {
"kind": {
"type": "string",
"const": "place"
},
"name": {
"type": "string",
"minLength": 1
}
}
},
{
"type": "object",
"required": [
"kind",
"street"
],
"properties": {
"to": {
"type": "string",
"minLength": 1
},
"from": {
"type": "string",
"minLength": 1
},
"kind": {
"type": "string",
"const": "corridor"
},
"street": {
"type": "string",
"minLength": 1
},
"bufferMeters": {
"type": "number",
"maximum": 1000,
"minimum": 30
}
}
},
{
"type": "object",
"required": [
"kind",
"street",
"cross"
],
"properties": {
"kind": {
"type": "string",
"const": "aroundIntersection"
},
"cross": {
"type": "string",
"minLength": 1
},
"street": {
"type": "string",
"minLength": 1
},
"radiusMeters": {
"type": "number",
"maximum": 5000,
"minimum": 50
}
}
}
]
},
"layerId": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Used by the ShowMeOnMap map card to load a map version. Not for the model.
| Argument | Type | Description |
|---|---|---|
| op_id | string | |
| cursor | integer | |
| map_id* | string | |
| layer_ids | array |
{
"type": "object",
"required": [
"map_id"
],
"properties": {
"op_id": {
"type": "string",
"minLength": 1
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"map_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
},
"layer_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 50
}
}
}Return the current workspace, map plan, and active filters for a given map_id.
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}List the caller's saved workflows with their parameters and per-run credit estimates.
| Argument | Type | Description |
|---|---|---|
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"properties": {
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Apply a natural-language instruction to an existing workspace. Valid mutations: filter a layer, remove a layer, change camera, change basemap. For ambiguous instructions the tool emits a clarification field. For unrelated instructions it emits outOfScope — build a new map in that case. The full Op catalog and predicate grammar are documented in the MCP resource showmeonmap://docs/workspace-ops-spec.
| Argument | Type | Description |
|---|---|---|
| map_id* | string | map_id from a prior build_map call |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| instruction* | string | e.g., "filter to where magnitude is greater than 5", "change basemap to dark" |
{
"type": "object",
"required": [
"map_id",
"instruction"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1,
"description": "map_id from a prior build_map call"
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"instruction": {
"type": "string",
"minLength": 1,
"description": "e.g., \"filter to where magnitude is greater than 5\", \"change basemap to dark\""
}
}
}Evaluate a predicate against a layer's inline features and return the matching subset. No Op is emitted and the workspace is not mutated. Handy for introspection ("how many X match Y?") before deciding whether to filter, subset, or build a new layer.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Default 100, max 1000. Response sets `truncated:true` when clipped. |
| map_id* | string | |
| layerId* | string | |
| predicate* | object | Predicate in the Mongo-shape grammar. Examples: {op:"eq",field:"category",value:"cafe"}, {op:"gt",field:"magnitude",value:5}, {op:"within",geometry:{type:"Polygon",coordinates:[...]}}, {op:"and",children:[...]}. See docs/superpowers/specs/2026-04-17-workspace-ops-log-design.md §6. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"layerId",
"predicate"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Default 100, max 1000. Response sets `truncated:true` when clipped.",
"exclusiveMinimum": 0
},
"map_id": {
"type": "string",
"minLength": 1
},
"layerId": {
"type": "string",
"minLength": 1
},
"predicate": {
"type": "object",
"description": "Predicate in the Mongo-shape grammar. Examples: {op:\"eq\",field:\"category\",value:\"cafe\"}, {op:\"gt\",field:\"magnitude\",value:5}, {op:\"within\",geometry:{type:\"Polygon\",coordinates:[...]}}, {op:\"and\",children:[...]}. See docs/superpowers/specs/2026-04-17-workspace-ops-log-design.md §6.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Advance the workspace cursor by one toward the tail of the ops log, replaying the next op that was previously undone. Calling redo when the cursor is already at the tail (no undone ops to fast-forward) fails rather than silently no-op. Note: any new op applied via apply-op / mutate-map after an undo truncates the redo tail (standard edit-stack semantics).
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Drop a previously-placed annotation by id. Strict: removing an already-removed or never-placed id fails. After removal, the id CAN be re-used by a later add_annotation (unlike layer ids, which are tombstoned for the session).
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| annotationId* | string |
{
"type": "object",
"required": [
"map_id",
"annotationId"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"annotationId": {
"type": "string",
"minLength": 1
}
}
}Drop a layer from the workspace by id. Strict: removing an already-removed or never-added layer fails. Layer ids do NOT recycle — a removed id cannot be re-added later in the same workspace. GATED: this tool is destructive. Pass confirmed:true to proceed; otherwise a needs_confirmation envelope is returned.
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| layerId* | string | |
| confirmed | boolean | Set to true to confirm this destructive action. If omitted or false, the call returns a needs_confirmation envelope. Layer ids are tombstoned — once removed, the same id cannot be re-added later in this workspace. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"layerId"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"layerId": {
"type": "string",
"minLength": 1
},
"confirmed": {
"type": "boolean",
"description": "Set to true to confirm this destructive action. If omitted or false, the call returns a needs_confirmation envelope. Layer ids are tombstoned — once removed, the same id cannot be re-added later in this workspace."
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Change a layer's id from oldLayerId to newLayerId. Re-keys any existing filter chain and preserves insertion order among sibling layers. Strict: newLayerId must not already be in use (current OR tombstoned) in this workspace. Subsequent ops must reference the layer by its new id.
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| newLayerId* | string | New id. Must be unique within the workspace. |
| oldLayerId* | string |
{
"type": "object",
"required": [
"map_id",
"oldLayerId",
"newLayerId"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"newLayerId": {
"type": "string",
"minLength": 1,
"description": "New id. Must be unique within the workspace."
},
"oldLayerId": {
"type": "string",
"minLength": 1
}
}
}Send the ShowMeOnMap team a report about a request this server could not complete — an unsupported intent, a missing tool, an unclear schema, or an op that failed in a confusing way. Records the report to a server-side log for future capability work; it does not change the current map or session. map_id is optional, so a report can be filed before any map exists.
| Argument | Type | Description |
|---|---|---|
| map_id | string | Optional. The map_id you were working on, if any. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| what_i_tried* | string | Which tools / inputs you attempted, in order. Be specific — tool name + key arg shape is ideal. |
| what_i_was_trying* | string | High-level intent in one or two sentences. e.g. "merge two filtered choropleths into a fused bivariate map". |
| where_i_got_stuck* | string | The specific failure: what came back, what was missing, why you could not proceed. |
| suggested_capability | string | Optional. A new tool, op, or schema field that would have unblocked you. |
{
"type": "object",
"required": [
"what_i_was_trying",
"what_i_tried",
"where_i_got_stuck"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1,
"description": "Optional. The map_id you were working on, if any."
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"what_i_tried": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "Which tools / inputs you attempted, in order. Be specific — tool name + key arg shape is ideal."
},
"what_i_was_trying": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "High-level intent in one or two sentences. e.g. \"merge two filtered choropleths into a fused bivariate map\"."
},
"where_i_got_stuck": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The specific failure: what came back, what was missing, why you could not proceed."
},
"suggested_capability": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional. A new tool, op, or schema field that would have unblocked you."
}
}
}Adjust a layer's color and/or opacity. Within-palette changes only — the renderer silently ignores fields the current viz variant doesn't support. Pass at least one of color / opacity; passing neither is an accepted no-op.
| Argument | Type | Description |
|---|---|---|
| color | string | CSS color string: hex (#RRGGBB), rgb/rgba, or named color. |
| map_id* | string | |
| layerId* | string | |
| opacity | number | 0 (transparent) to 1 (opaque). |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"layerId"
],
"properties": {
"color": {
"type": "string",
"minLength": 1,
"description": "CSS color string: hex (#RRGGBB), rgb/rgba, or named color."
},
"map_id": {
"type": "string",
"minLength": 1
},
"layerId": {
"type": "string",
"minLength": 1
},
"opacity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "0 (transparent) to 1 (opaque)."
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Compute a spatial analysis server-side and append the finished, honestly-legended result as a new layer + camera; the result REPLACES its input layer(s) (undoable). hotspot = Getis-Ord Gi*: hot/cold significance classes (99/95/90%, Benjamini-Hochberg FDR-corrected) on a numeric field, or on hex-binned point density when valueField is omitted. zonal = aggregate points into polygon zones (an existing zone layer OR a generated h3 fishnet): count/sum/mean/min/max per zone as a quantile choropleth where zero and no-data are distinct classes. enrich = join a US Census ACS indicator (median income, home value, rent, …) onto each feature by tract/county/state containment — unmatched features stay null, never zero-filled. join = spatial join (attribute transfer): each point in layerId takes properties from the joinLayerId polygon containing it (collisions prefixed, unmatched points carry NO joined fields, zero overlap is a typed rejection). merge = append two same-geometry-class layers into one dataset with a per-row source column (schemas never null-filled; class mismatch is a typed failure). near = nearest-neighbor distance columns (great-circle meters, stated — never presented as road distance). dissolve = true polygon union per attribute group (missing values form their own group; partial sums reported). Returns a grounded memo + stats payload — every number is computed, never generated; findings keep the map. Costs 1 credit when the result lands; typed failures (unknown layer, too few features, >10,000-feature cap) are refunded.
| Argument | Type | Description |
|---|---|---|
| k | integer | hotspot only: nearest neighbors per feature (default 8). |
| stats | array | zonal only: which statistics to attach per zone (default: count, plus sum/mean/min/max when valueField is set). |
| story | boolean | Opt-in: persist the shared map with a 2-step story rail (grounded overview + analysis memo isolating the result layer) — the /m/ link opens with it. |
Execute a saved workflow with parameter values. PAID: bills ~1 credit per step through the normal build/mutate paths (the estimate is in list_workflows). Optional batch mode sweeps ONE param across 2–20 values — each value is a full independent run (steps × values credits); failed/paused values are reported per value and the batch continues. A clarification pauses a single run (status "paused" + the question); failures stop at the failing step. On success the result is a live map with a shareable URL (batch: the last successful value's map).
| Argument | Type | Description |
|---|---|---|
| batch | object | Batch mode: run the workflow once per value ("each of the 12 districts"). Bills steps × values. |
| params | object | Values for the workflow's declared parameters. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| workflow_id* | string | From save_workflow or list_workflows. |
{
"type": "object",
"required": [
"workflow_id"
],
"properties": {
"batch": {
"type": "object",
"required": [
"param",
"values"
],
"properties": {
"param": {
"type": "string",
"minLength": 1,
"description": "The ONE declared param to sweep (must not also be in params)."
},
"values": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 20,
"minItems": 2,
"description": "2–20 values; each is a FULL independent billed run."
}
},
"description": "Batch mode: run the workflow once per value (\"each of the 12 districts\"). Bills steps × values."
},
"params": {
"type": "object",
"description": "Values for the workflow's declared parameters.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"workflow_id": {
"type": "string",
"minLength": 1,
"description": "From save_workflow or list_workflows."
}
}
}Save a re-runnable, parameterized workflow: an ordered list of natural-language instructions (step 1 builds, later steps mutate). Wrap values in {braces} and declare them in params. Running it later re-executes the instructions on FRESH data and bills per step like typing.
| Argument | Type | Description |
|---|---|---|
| name* | string | Workflow name. |
| steps* | array | Ordered NL instructions. Step 1 builds the map; later steps mutate it. Wrap values in {braces} to declare parameters. |
| params | array | Declared parameters — every {slot} used in steps must be declared here. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"name",
"steps"
],
"properties": {
"name": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Workflow name."
},
"steps": {
"type": "array",
"items": {
"type": "object",
"required": [
"instruction"
],
"properties": {
"instruction": {
"type": "string",
"maxLength": 4000,
"minLength": 1
}
}
},
"maxItems": 12,
"minItems": 1,
"description": "Ordered NL instructions. Step 1 builds the map; later steps mutate it. Wrap values in {braces} to declare parameters."
},
"params": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"label",
"kind"
],
"properties": {
"kind": {
"enum": [
"place",
"number",
"text",
"timerange"
],
"type": "string"
},
"name": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"label": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"default": {
"type": "string",
"maxLength": 200
}
}
},
"maxItems": 8,
"description": "Declared parameters — every {slot} used in steps must be declared here."
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Create a new layer containing the source layer's features that lie within the supplied polygon. The source layer is untouched. Useful for "show me only the X inside this country/bbox/hand-drawn shape."
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| selection* | object | GeoJSON Polygon or MultiPolygon in [lng,lat] coordinate order. |
| newLayerId* | string | Id for the new layer. Must not already be in use in this workspace. |
| inheritStyle | boolean | Default true. false emits a new layer with minimal default styling. |
| sourceLayerId* | string |
{
"type": "object",
"required": [
"map_id",
"sourceLayerId",
"newLayerId",
"selection"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"selection": {
"type": "object",
"required": [
"type",
"coordinates"
],
"properties": {
"type": {
"enum": [
"Polygon",
"MultiPolygon"
],
"type": "string"
},
"coordinates": {
"type": "array",
"items": {}
}
},
"description": "GeoJSON Polygon or MultiPolygon in [lng,lat] coordinate order."
},
"newLayerId": {
"type": "string",
"minLength": 1,
"description": "Id for the new layer. Must not already be in use in this workspace."
},
"inheritStyle": {
"type": "boolean",
"description": "Default true. false emits a new layer with minimal default styling."
},
"sourceLayerId": {
"type": "string",
"minLength": 1
}
}
}Override the workspace camera. Latest set_camera op wins during replay. Two modes: `fitBounds` with a [w,s,e,n] bbox (plus optional padding/animateMs), or `flyTo` with [lng,lat] center + zoom (plus optional pitch/bearing/animateMs). Covers requests like "zoom to Japan", "center on Paris at z=10", or framing a filtered layer. Equivalent to the camera move mutate_map would emit, but skips the NL roundtrip.
| Argument | Type | Description |
|---|---|---|
| camera* | any | |
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"camera"
],
"properties": {
"camera": {
"oneOf": [
{
"type": "object",
"required": [
"mode",
"bounds"
],
"properties": {
"mode": {
"type": "string",
"const": "fitBounds"
},
"bounds": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"description": "[west, south, east, north] bbox in WGS84 degrees."
},
"padding": {
"type": "number",
"minimum": 0,
"description": "Pixel padding around the bbox. Default is the renderer default."
},
"animateMs": {
"type": "number",
"minimum": 0,
"description": "Animation duration in ms. 0 = instant jump."
}
}
},
{
"type": "object",
"required": [
"mode",
"center",
"zoom"
],
"properties": {
"mode": {
"type": "string",
"const": "flyTo"
},
"zoom": {
"type": "number"
},
"pitch": {
"type": "number",
"description": "Tilt in degrees, 0-60."
},
"center": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 2,
"minItems": 2,
"description": "[lng, lat] in WGS84."
},
"bearing": {
"type": "number",
"description": "Rotation in degrees, 0-360."
},
"animateMs": {
"type": "number",
"minimum": 0,
"description": "Animation duration in ms. 0 = instant jump."
}
}
}
]
},
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Override the current time-range filter. Latest set_time op wins during replay. Covers requests like "filter to 2020-2024" or "show only the last 7 days". Not yet consumed by the renderer — the UI drives the slider directly — but the value is captured in the ops log and queryable via get_state.
| Argument | Type | Description |
|---|---|---|
| field* | string | Feature property carrying the time value (e.g. "date", "year", "timestamp"). |
| format | string | How rangeStart/rangeEnd encode time. Default: unix_ms at render time. |
| map_id* | string | |
| rangeEnd* | number | Inclusive upper bound of the visible window. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| rangeStart* | number | Inclusive lower bound of the visible window. |
{
"type": "object",
"required": [
"map_id",
"field",
"rangeStart",
"rangeEnd"
],
"properties": {
"field": {
"type": "string",
"minLength": 1,
"description": "Feature property carrying the time value (e.g. \"date\", \"year\", \"timestamp\")."
},
"format": {
"enum": [
"unix_ms",
"iso",
"integer"
],
"type": "string",
"description": "How rangeStart/rangeEnd encode time. Default: unix_ms at render time."
},
"map_id": {
"type": "string",
"minLength": 1
},
"rangeEnd": {
"type": "number",
"description": "Inclusive upper bound of the visible window."
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"rangeStart": {
"type": "number",
"description": "Inclusive lower bound of the visible window."
}
}
}Label the current workspace state with a user-supplied name. The label is mirrored into workspace.meta.tags so UIs can render a named-revision history. Tagging the same label twice is idempotent — no error, no duplicate entry.
| Argument | Type | Description |
|---|---|---|
| name* | string | Checkpoint label, e.g. "before EV layer added" or "v1.0". |
| map_id* | string | |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id",
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Checkpoint label, e.g. \"before EV layer added\" or \"v1.0\"."
},
"map_id": {
"type": "string",
"minLength": 1
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}Rewind the workspace cursor by one, re-materializing the state as it was before the last mutation. Does NOT delete any ops — redo will fast-forward. Calling undo at the workspace genesis (cursor === 0, only the CreateWorkspace op is in scope) is a no-op that surfaces an error rather than silently doing nothing. GATED: pass confirmed:true to proceed; otherwise a needs_confirmation envelope is returned.
| Argument | Type | Description |
|---|---|---|
| map_id* | string | |
| confirmed | boolean | Set to true to confirm this sensitive action. If omitted or false, the call returns a needs_confirmation envelope. Undo rewinds the most recent change; redo restores it. |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
{
"type": "object",
"required": [
"map_id"
],
"properties": {
"map_id": {
"type": "string",
"minLength": 1
},
"confirmed": {
"type": "boolean",
"description": "Set to true to confirm this sensitive action. If omitted or false, the call returns a needs_confirmation envelope. Undo rewinds the most recent change; redo restores it."
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
}
}
}| zones | object | zonal only: generate an h3 hex fishnet over the source extent instead of using a zone layer (resolution 3-10, default auto). Provide EXACTLY ONE of zoneLayerId or zones. |
| fields | array | join only: which join-layer properties to transfer (default: auto-select up to 12 non-internal properties, overflow reported). |
| map_id* | string |
| prefix | string | join only: prefix for a joined field whose name collides with an existing target property (default "join_"). |
| layerId* | string | The workspace layer to analyze (geojson-backed; the point source for zonal; the point TARGET for join; the styling donor for merge). |
| analysis* | string | Which analysis to run. 'hotspot' = Getis-Ord Gi* with FDR-corrected significance classes. 'zonal' = aggregate a point layer into polygon zones (count/sum/mean/min/max choropleth). 'enrich' = join a US Census indicator onto each feature by containment (tract/county/state). 'join' = spatial join (attribute transfer): each POINT in layerId takes the listed properties from the polygon in joinLayerId that contains it — the aggregate direction (points INTO polygons) is 'zonal'. 'merge' = append layerId + mergeLayerId (same geometry class) into ONE dataset, each row stamped with its source layer. 'near' = each POINT in layerId gains the great-circle distance to (and identity of) its nearest feature in nearLayerId. 'dissolve' = union POLYGONS sharing a dissolveField value into single features (omit the field to dissolve all into one). |
| annotate | boolean | Opt-in: place ONE callout annotation at the headline feature (hottest cluster / top zone / highest value). Label text comes only from computed values. |
| geoLevel | string | enrich only: containment geography (default tract). Tract/county fetch only the states the data touches, capped at 3 — filter first or use state for wider layers. |
| hexMeters | number | hotspot density mode only: hex cell spacing in meters (default auto from the data extent). |
| indicator | string | enrich only (required there): a US Census ACS preset id (e.g. 'median_household_income', 'median_home_value', 'median_rent') or a raw ACS variable code (e.g. 'B19013_001E'). |
| nearField | string | near only: property of the nearest feature to copy as its identity (default: first name-like property). |
| rationale | string | Optional short label (≤300 chars) for the map edit history, e.g. "add wildfire layer". Omit it to send nothing beyond the tool arguments. |
| sumFields | array | dissolve only: numeric properties to SUM per group — skipped values reported, a group with none present carries NO sum. |
| valueField | string | Numeric property to analyze. hotspot: omit on point layers for incident-DENSITY mode (hex-binned counts). zonal: omit for count-only aggregation. |
| joinLayerId | string | join only (required there): the POLYGON layer providing the attributes. |
| nearLayerId | string | near only (required there): the POINT layer to search for each target point's nearest neighbor. |
| sourceField | string | merge only: name of the per-row provenance column naming each row's source layer (default "merge_source"; renamed on collision, reported). |
| zoneLayerId | string | zonal only: an existing polygon layer to aggregate into. Provide EXACTLY ONE of zoneLayerId or zones. |
| maxDistanceM | number | near only: search radius in meters — a point whose nearest neighbor is farther carries NO near fields (reported). |
| mergeLayerId | string | merge only (required there): the second layer — same geometry class (point/line/polygon) as layerId. |
| dissolveField | string | dissolve only: group-by property (omit = dissolve ALL into one footprint); missing values form their own "(no value)" group. |
{
"type": "object",
"required": [
"map_id",
"analysis",
"layerId"
],
"properties": {
"k": {
"type": "integer",
"maximum": 24,
"minimum": 3,
"description": "hotspot only: nearest neighbors per feature (default 8)."
},
"stats": {
"type": "array",
"items": {
"enum": [
"count",
"sum",
"mean",
"min",
"max"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"description": "zonal only: which statistics to attach per zone (default: count, plus sum/mean/min/max when valueField is set)."
},
"story": {
"type": "boolean",
"description": "Opt-in: persist the shared map with a 2-step story rail (grounded overview + analysis memo isolating the result layer) — the /m/ link opens with it."
},
"zones": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "h3"
},
"resolution": {
"type": "integer",
"maximum": 10,
"minimum": 3
}
},
"description": "zonal only: generate an h3 hex fishnet over the source extent instead of using a zone layer (resolution 3-10, default auto). Provide EXACTLY ONE of zoneLayerId or zones.",
"additionalProperties": false
},
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 12,
"minItems": 1,
"description": "join only: which join-layer properties to transfer (default: auto-select up to 12 non-internal properties, overflow reported)."
},
"map_id": {
"type": "string",
"minLength": 1
},
"prefix": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "join only: prefix for a joined field whose name collides with an existing target property (default \"join_\")."
},
"layerId": {
"type": "string",
"minLength": 1,
"description": "The workspace layer to analyze (geojson-backed; the point source for zonal; the point TARGET for join; the styling donor for merge)."
},
"analysis": {
"enum": [
"hotspot",
"zonal",
"enrich",
"join",
"merge",
"near",
"dissolve"
],
"type": "string",
"description": "Which analysis to run. 'hotspot' = Getis-Ord Gi* with FDR-corrected significance classes. 'zonal' = aggregate a point layer into polygon zones (count/sum/mean/min/max choropleth). 'enrich' = join a US Census indicator onto each feature by containment (tract/county/state). 'join' = spatial join (attribute transfer): each POINT in layerId takes the listed properties from the polygon in joinLayerId that contains it — the aggregate direction (points INTO polygons) is 'zonal'. 'merge' = append layerId + mergeLayerId (same geometry class) into ONE dataset, each row stamped with its source layer. 'near' = each POINT in layerId gains the great-circle distance to (and identity of) its nearest feature in nearLayerId. 'dissolve' = union POLYGONS sharing a dissolveField value into single features (omit the field to dissolve all into one)."
},
"annotate": {
"type": "boolean",
"description": "Opt-in: place ONE callout annotation at the headline feature (hottest cluster / top zone / highest value). Label text comes only from computed values."
},
"geoLevel": {
"enum": [
"state",
"county",
"tract"
],
"type": "string",
"description": "enrich only: containment geography (default tract). Tract/county fetch only the states the data touches, capped at 3 — filter first or use state for wider layers."
},
"hexMeters": {
"type": "number",
"maximum": 50000,
"minimum": 100,
"description": "hotspot density mode only: hex cell spacing in meters (default auto from the data extent)."
},
"indicator": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "enrich only (required there): a US Census ACS preset id (e.g. 'median_household_income', 'median_home_value', 'median_rent') or a raw ACS variable code (e.g. 'B19013_001E')."
},
"nearField": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "near only: property of the nearest feature to copy as its identity (default: first name-like property)."
},
"rationale": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Optional short label (≤300 chars) for the map edit history, e.g. \"add wildfire layer\". Omit it to send nothing beyond the tool arguments."
},
"sumFields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 5,
"minItems": 1,
"description": "dissolve only: numeric properties to SUM per group — skipped values reported, a group with none present carries NO sum."
},
"valueField": {
"type": "string",
"minLength": 1,
"description": "Numeric property to analyze. hotspot: omit on point layers for incident-DENSITY mode (hex-binned counts). zonal: omit for count-only aggregation."
},
"joinLayerId": {
"type": "string",
"minLength": 1,
"description": "join only (required there): the POLYGON layer providing the attributes."
},
"nearLayerId": {
"type": "string",
"minLength": 1,
"description": "near only (required there): the POINT layer to search for each target point's nearest neighbor."
},
"sourceField": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "merge only: name of the per-row provenance column naming each row's source layer (default \"merge_source\"; renamed on collision, reported)."
},
"zoneLayerId": {
"type": "string",
"minLength": 1,
"description": "zonal only: an existing polygon layer to aggregate into. Provide EXACTLY ONE of zoneLayerId or zones."
},
"maxDistanceM": {
"type": "number",
"maximum": 20000000,
"minimum": 1,
"description": "near only: search radius in meters — a point whose nearest neighbor is farther carries NO near fields (reported)."
},
"mergeLayerId": {
"type": "string",
"minLength": 1,
"description": "merge only (required there): the second layer — same geometry class (point/line/polygon) as layerId."
},
"dissolveField": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "dissolve only: group-by property (omit = dissolve ALL into one footprint); missing values form their own \"(no value)\" group."
}
}
}