Show geo map MCP response
MCP tool response returned by the Show geo map MCP tool.
- Returned by: Show geo map MCP tool
- Response type: Structured app payload
Response Shape
The response contains the validated display-only map definition. It includes a generated presentation identifier when the call omits id. New maps do not return an interaction ID or collect selections. Provider credentials and tile URLs are not part of the tool response.
| Field | Type | Notes |
|---|---|---|
id | string | Caller-provided or generated map presentation identifier. |
title, description | string or null | Optional explanatory text. Omit when unnecessary. |
series | object array | Named marker groups with stable IDs, coordinates and marker labels. A series label defaults from its ID. |
routes | object array or null | Optional line routes with ordered coordinates. |
clustering | object or null | Optional clustering for dense marker groups. |
viewport | object or null | Optional framing override. Bounds otherwise fit the markers and routes. |
legend | object or null | Optional legend heading. Multi-series maps show a legend automatically. |
Follow-up Behavior
Clicking a marker opens a small popup; panning and zooming do not submit data. The assistant must not infer a choice or approval from map navigation. Historical map interactions may still have an interactionId and submitted marker arrays; Interaction state MCP response remains available to read those saved receipts.
Example
{
"id": "geo_map_example",
"series": [
{
"id": "offices",
"label": "Offices",
"markers": [
{"id": "office-1", "lat": 38.9, "lng": -77, "label": "Office"}
]
}
]
}