Mapbox Map
render_map_toolRender a live, interactive Mapbox GL JS map to view locations, routes, or datasets, and merge multiple data sources onto one map with optional traffic, satellite imagery, and styling.
Instructions
Display a live, interactive Mapbox GL JS map. Use this when someone wants to see a location, route, or dataset on a map. In ChatGPT Desktop the map stays open next to the chat and provides its own tools (redraw_map, which takes the same arguments as this tool, search_map, add_places, move_map, read_map): use them to change that map, because another call to this tool opens a second map. Preferred usage: any other Mapbox tool returns a mapboxRender.ref URI in its structuredContent — pass that ref via payload_refs: ["..."]. You can pass multiple refs to merge several datasets (e.g. a search result + a route) onto one map. Inline layers/markers/legend fields are also supported for hand-composed payloads from raw GeoJSON. For a hand-composed POI marker (e.g. built from category_search_tool/search_and_geocode_tool/place_details_tool output), set markers[].id to the place's mapbox_id — this gets it the same auto-enriching results carousel (popularity score and photo) that a payload_refs-based search result gets automatically, with no extra tool calls. To restyle the base map itself (e.g. "make the water red", switch to night lighting, hide POI labels) pass baseMapConfig. To switch to satellite imagery, pass baseStyle: "standard-satellite" (defaults to "standard"). To show live traffic congestion on the roads in view, pass showTraffic: true. The map also has Satellite and Traffic buttons users can toggle themselves. Every call redraws the map from scratch: only the traffic and satellite settings carry over from the previous call. So to restyle an already-drawn map or toggle traffic without losing its content, re-pass the same payload_refs/layers alongside baseMapConfig/baseStyle/showTraffic rather than sending them alone. After rendering places, don't list them again in your reply: the map's cards already show each name, category, price level, distance and hours. Answer the question or add what the cards leave out (like the phone number or address) instead.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "render_map_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| camera | No | Initial camera position. If omitted, the map auto-fits to the union of all data. | |
| layers | No | Inline layers to add to the map. Use this only when composing a payload from raw GeoJSON; for tool results, pass payload_refs instead. | |
| legend | No | Inline legend rows. Use only for hand-composed payloads. | |
| markers | No | Inline point markers (start/end, numbered visits, POI pins, etc.). Use only for hand-composed payloads. For POI markers, set `id` to the place's mapbox_id to get an auto-enriching results carousel card (see markerSchema's `id` field) instead of just a pin. | |
| summary | No | Short header chip shown in the top-left of the map (e.g. "Route: 12.4 mi, 23 min"). Overrides any summary in payload_refs. | |
| baseStyle | No | Which Mapbox-owned base style to load; defaults to "standard". "standard-satellite" is the same Standard style family rendered over global satellite imagery instead of a vector basemap — same config-property system and bottom/middle/top slots apply, but it has no theme and no flat-color overrides like colorWater/colorBuildings (there's no vector surface to recolor). See https://docs.mapbox.com/map-styles/reference/standard-satellite/ for its supported baseMapConfig properties. | |
| showTraffic | No | Show live traffic congestion (light/moderate/heavy/severe) on every road in view, from Mapbox Traffic. Use when the user asks to see traffic or congestion in an area. Works on both base styles. Left out, the map keeps whatever the user picked with its Traffic button. | |
| payload_refs | No | Array of map-payload URIs returned by other Mapbox tools in their structuredContent.mapboxRender.ref field. Pass one ref to render a single tool result; pass multiple to merge several datasets onto one map (e.g. an isochrone + a route). | |
| baseMapConfig | No | Restyles the Standard base map itself via Mapbox's config-property system (map.setConfigProperty) — e.g. { "colorWater": "#ff0000" } to turn the water red, or { "lightPreset": "night" } for night lighting. Only the currently-documented Standard properties are typed above; unrecognized keys still pass through in case Mapbox ships new ones. Has no effect if the base style isn't Standard. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| summary | No | ||
| rendered | Yes | Always true when the call succeeded. | |
| layer_count | Yes | ||
| mapboxRender | No | ||
| marker_count | Yes |