Map

Create maps with location markers (pins) for plotting SPECIFIC INDIVIDUAL PLACES on a real-world map.

Updated 18 Sep 20261 min read

Send "type": "map".

Create maps with location markers (pins) for plotting SPECIFIC INDIVIDUAL PLACES on a real-world map.

Also available as the MCP tool render_map. The same payload works through either surface.

Fields

data

titlestring

Short descriptive title for the map (e.g., "Top Tech Hubs", "Most Populated Countries")

markersobject[]required

Array of location markers

Child attributes

locationstring

FULLY DISAMBIGUATED geocoder-ready name matching the prompt's geographic level: bare country name for country-level; "City, State/Region, Country" for cities ("London, England, United Kingdom", never just "London"); "Place, City, State/Region, Country" for specific places

descriptionstring

emojistring

Single emoji for marker - use same emoji for all markers

geoobject

Example

{
  "type": "map",
  "data": {
    "title": "Q4 Launch Planning",
    "markers": [
      {
        "location": "string",
        "description": "string",
        "emoji": "string",
        "geo": {
          "coordinates": [
            0
          ],
          "name": "Q4 Launch Planning"
        }
      }
    ]
  }
}

Was this page helpful?