Skip to content
API Reference
Mapbox logo

Mapbox

Developer Tools

Maps, styles, documentation, and geospatial developer tools

Use the Mapbox MCP server for official documentation lookup, Mapbox Styles API workflows (create, list, update, preview, compare, and optimize styles), access token management, GeoJSON and style validation, tileset queries, coordinate and bounding-box helpers, WCAG contrast checks, and Mapbox Feedback API access.

Adding Mapbox provisions three things in your zone: an upstream resource pointing at https://mcp-devkit.mapbox.com/mcp (kept inside Keycard), a Keycard MCP Gateway URL - the downstream resource - that you install in Cursor, Claude Code, or any MCP client, and a provider for token exchange with Mapbox’s OAuth issuer.

When your AI client makes a tool call, it sends a Keycard-issued access token to the gateway URL. Keycard’s STS exchanges that token for an upstream Mapbox token, the gateway calls the upstream MCP, and the response is proxied back. Your zone’s identity provider, access policies, and audit log apply to every call - the upstream credential never leaves Keycard. Each call is recorded in the audit log with the user identity, the resource accessed, and the policy decision.

Tools the upstream server exposes through the Keycard MCP Gateway.

Mapbox exposes 25 tools through the gateway:

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)

Add Mapbox to your zone and install the gateway URL into Cursor, Claude Code, or any MCP client.

  1. Open the catalog

    In your zone’s Keycard Console, go to ApplicationsAdd ApplicationExplore MCP Servers.

  2. Find and install Mapbox

    Search for Mapbox in the catalog and click Install.

  3. Connect your development tool

    Once installed, Mapbox appears on the Applications page with a Keycard MCP Gateway URL. Use the Install dropdown to add it to Cursor, Claude Code, or any MCP-compatible client.