Skip to content
API Reference
Mapbox logo

Mapbox

Developer Tools

Maps, styles, documentation, and geospatial developer tools

Mapbox is a developer platform for maps, navigation, and location services. Look up documentation, manage Mapbox Styles (create, update, preview, compare, optimize), manage access tokens, validate GeoJSON, query tilesets, and run WCAG contrast checks.

Add Mapbox to your zone and connect it to your MCP client.

  1. In your zone’s Keycard Console, go to Applications -> Add Application -> Explore MCP Servers.

  2. Search for Mapbox and click Install.

  3. A browser tab opens to Mapbox’s OAuth consent screen. Sign in and approve the requested permissions.

  4. You’re redirected back. Mapbox appears on the Applications page with a Keycard MCP Gateway URL.

On the Applications page, click Add to Coding Agent next to Mapbox and pick how you want to install:

  • Cursor - opens a deeplink that hands the MCP config straight to Cursor. Click Install inside Cursor to finish.
  • Claude Code - opens a dialog with a claude mcp add command. Pick a scope (User, Project, or Local), then copy and run the command in your terminal.
  • Install manually - reveals the Server Name and Server URL to paste into any other MCP-compatible client.

Once connected, Mapbox’s tools are available to the agent, scoped to whoever signs in to your zone.

What Mapbox can do once installed.

Mapbox provides 25 tools:

get_latest_mapbox_docs_tool
Fetch current official Mapbox documentation and developer resources (prefer over web search)
get_reference_tool
Reference data: Streets v8 fields, token scopes, layer type mappings, and style specification
validate_style_tool
Validate Mapbox style JSON against the Style Specification (errors, warnings, suggestions)
validate_geojson_tool
Validate GeoJSON structure, coordinates, and geometry types
validate_expression_tool
Validate Mapbox style expression syntax, operators, and arguments
coordinate_conversion_tool
Convert coordinates between WGS84 and Web Mercator (EPSG:3857)
country_bounding_box_tool
Bounding box for a country by ISO 3166-1 code as [minX, minY, maxX, maxY]
bounding_box_tool
Bounding box of GeoJSON content as [minX, minY, maxX, maxY]
tilequery_tool
Query vector and raster data from Mapbox tilesets at coordinates
list_tokens_tool
List Mapbox access tokens with filtering and pagination (secret values omitted)
create_token_tool
Create a public access token with scopes and optional URL restrictions
list_styles_tool
List styles for the account (use a small limit to avoid huge responses)
create_style_tool
Create a new Mapbox style
retrieve_style_tool
Retrieve a Mapbox style by ID
update_style_tool
Update an existing Mapbox style
delete_style_tool
Delete a Mapbox style by ID
preview_style_tool
Generate a preview URL for a style using an existing public token
style_comparison_tool
Generate a URL to compare two Mapbox styles side by side
compare_styles_tool
Compare two styles and report differences in layers, sources, and properties
optimize_style_tool
Optimize styles by removing unused sources, duplicate layers, and simplifying expressions
style_builder_tool
Generate or update Mapbox style JSON from natural language (basemap layers, Standard vs Classic)
check_color_contrast_tool
Check foreground/background color contrast for WCAG 2.1 compliance
geojson_preview_tool
Return a geojson.io/next URL to visualize GeoJSON (URL only)
list_feedback_tool
List Feedback API items with filters and pagination (requires user-feedback:read)
get_feedback_tool
Get one Feedback API item by ID (requires user-feedback:read)

What to do once Mapbox is installed.

Now do this

  • Confirm the gateway works by asking your AI client to call one of the Mapbox tools above.

Recommended

  • Decide who can use it - write access policies scoped to the Mapbox resource so only the right users and agents reach the tools.
  • Watch the calls - every tool call lands in your audit log with user identity, resource, and policy decision.