Mapbox
Mapbox is a platform that provides mapping, navigation, and location data services for developers to integrate into their applications.
Verdict
Common use cases
- Geocode customer addresses in bulk from spreadsheets
- Generate turn-by-turn directions for field teams
- Embed interactive maps in internal dashboards
- Validate location data before database import
- Convert coordinates to human-readable addresses
Integration
- Vendor
- Mapbox
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 13
- Composio slug
mapbox
Tools
- Batch Geocoding
Tool to perform batch forward or reverse geocoding for multiple locations. use when you need consistent geocoding of up to 50 queries in one call.
- Forward Geocoding
Tool to convert free-form or structured address into geographic coordinates and place features. use when you need forward geocoding from text or address components.
- Get Access Token
Tool to extract and validate mapbox access token from connection metadata. use when you need a valid token for downstream actions.
- Permanent Forward Geocoding
Tool to perform permanent forward geocoding. use when you need enterprise-grade permanent geocoding after confirming account privileges.
- Permanent Reverse Geocoding
Tool to perform permanent reverse geocoding. use after obtaining coordinates to get cacheable place data. example: lon=-73.989, lat=40.733
- Request Style Embed HTML
Tool to retrieve embeddable html for a mapbox style. use when you want to embed a style in an iframe after verifying access.
- Retrieve Directions
Tool to retrieve directions between waypoints. use when you need navigation routes with optional turn-by-turn instructions after confirming origin and destination.
- Retrieve Font Glyph Ranges
Tool to retrieve font glyph ranges as pbf tiles. use when you have confirmed the font name, codepoint range, and valid token.
- Retrieve Matrix
Tool to retrieve a travel time and distance matrix. use when you need to compute travel durations and distances between multiple locations.
- Retrieve Style
Tool to retrieve a mapbox style json. use when you need the full style definition by its id.
- Retrieve Style WMTS
Tool to retrieve a wmts document for a mapbox style. use when you need the wmts capabilities xml for a specific style id.
- Retrieve Tileset Metadata
Tool to retrieve metadata for a mapbox tileset. use when you need tilejson details including bounds, zooms, and layer info.
- Reverse Geocoding
Tool to reverse geocode coordinates into place names. use after obtaining coordinates.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the MCP Integrations tab. 2. Click 'Add Integration' and select Mapbox from the developer tools category. 3. Open your Mapbox account dashboard at mapbox.com, navigate to the Access Tokens page, and copy your default public token (or create a new one with appropriate scopes). 4. Paste the token into Switchy's API key field and click 'Connect'. 5. Return to any Space, type '@Mapbox get access token' in the chat, and send — if the MCP replies with token details, the connection is live. 6. Try a real task: type '@Mapbox forward geocode 1600 Pennsylvania Avenue NW, Washington, DC' to confirm geocoding works. 7. For production use or permanent geocoding, replace the public token with a secret token that has the required scopes.
What teammates see: by default, memories from Mapbox are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Geocode Address List
@Mapbox batch geocode these addresses: 350 Fifth Avenue New York NY, 1 Infinite Loop Cupertino CA, 1600 Amphitheatre Parkway Mountain View CA. Return a table with address, latitude, longitude.Open in a Space →
Get Driving Directions
@Mapbox retrieve directions from San Francisco City Hall to Golden Gate Bridge. Include turn-by-turn instructions and total travel time.Open in a Space →
Reverse Geocode Coordinates
@Mapbox reverse geocode these coordinates: longitude -122.4194, latitude 37.7749. Tell me the street address and neighborhood.Open in a Space →
Embed Custom Map
@Mapbox request style embed HTML for my default style. Center the map on New York City at zoom level 12 and give me the iframe code.Open in a Space →
Validate Address Format
@Mapbox forward geocode '123 Main St, Anytown USA' and tell me if it's a valid address. If so, return the standardized street, city, state, and postal code.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@mapbox convert these three addresses to coordinates: '1600 Pennsylvania Ave NW, Washington DC', 'Times Square, New York', and 'Golden Gate Bridge, San Francisco'
Batch geocoding complete for 3 locations: 1. 1600 Pennsylvania Ave NW → 38.8977°N, 77.0365°W (The White House, confidence: 0.99) 2. Times Square, New York → 40.7580°N, 73.9855°W (Manhattan intersection, confidence: 0.95) 3. Golden Gate Bridge, San Francisco → 37.8199°N, 122.4783°W (landmark structure, confidence: 0.98) All results include full place context (neighborhood, city, state) and are suitable for mapping or route planning. This example shows typical output structure; actual confidence scores and precision vary by address specificity.
Batch geocoding handles up to 50 queries per call, making it efficient for bulk address conversion. Requires a valid API key with geocoding scope. Results are not cached permanently unless you use the separate permanent geocoding endpoint, which needs enterprise account privileges.
@mapbox get me turn-by-turn driving directions from the Statue of Liberty to Central Park, optimized for traffic
Route retrieved (driving-traffic profile, 13.2 miles, ~28 minutes under current conditions): Start at Liberty Island, head northeast on ferry route to Battery Park. Merge onto FDR Drive northbound for 8.4 miles. Take exit 15 toward E 96th St, continue west 0.6 miles. Arrive at Central Park South entrance. Route includes 12 turn instructions, real-time traffic consideration, and alternative paths if congestion detected. This illustrative example reflects typical output; actual routes depend on live traffic data and Mapbox's routing engine state at request time.
Directions API supports multiple profiles (driving, walking, cycling) and optional parameters like traffic awareness or waypoint optimization. Each request consumes API quota based on complexity. The response includes geometry for map rendering, but displaying the route requires additional Mapbox GL JS integration.
@mapbox I have lat/lon coordinates from our field sensors—reverse geocode them and summarize which neighborhoods have the most data points: 40.7489,-73.9680 | 40.7614,-73.9776 | 40.7580,-73.9855 | 40.7128,-74.0060
Reverse geocoding complete for 4 sensor locations: • 40.7489,-73.9680 → Midtown Manhattan, Murray Hill neighborhood • 40.7614,-73.9776 → Midtown Manhattan, Hell's Kitchen neighborhood • 40.7580,-73.9855 → Midtown Manhattan, Times Square area • 40.7128,-74.0060 → Lower Manhattan, Financial District Summary: 3 of 4 sensors (75%) are concentrated in Midtown Manhattan, with Times Square and Hell's Kitchen representing the densest cluster. One outlier in the Financial District. This example demonstrates combining reverse geocoding with AI-driven spatial analysis—actual place names depend on Mapbox's dataset coverage.
Reverse geocoding translates coordinates into human-readable place names, useful for sensor data interpretation or log analysis. Standard reverse geocoding results are not cacheable; if you need permanent storage of place data, use the permanent reverse geocoding tool (requires enterprise account). Rate limits apply per API key tier.
Use-case deep-dives
When Mapbox beats Google Maps for customer-facing store finders
A 6-person e-commerce team building a store locator on their Shopify site needs to geocode 200 retail addresses once, then let customers search by zip code. Mapbox's Batch Geocoding tool handles the initial address-to-coordinates conversion in one call, and Forward Geocoding powers the live search without per-query fees eating the budget. The API_KEY auth means the frontend dev can spin up a demo in an afternoon without OAuth red tape. This wins over Google Maps when you're under 100k monthly searches and want predictable costs—Mapbox's pricing tiers don't punish growth the way pay-per-call models do. If you're over 500k searches or need Street View integration, Google's ecosystem makes more sense. For small teams shipping a clean locator fast, Mapbox's 13 tools cover geocoding, directions, and embeds without vendor lock-in.
Why Retrieve Directions falls short for real-time fleet dispatch
A 3-person logistics startup routing 40 daily deliveries across a metro area might assume Mapbox's Retrieve Directions tool solves their dispatch problem. It doesn't—at least not alone. The tool returns turn-by-turn routes between waypoints, but it lacks multi-stop optimization (you'd need to script your own traveling-salesman logic) and real-time traffic rerouting (Mapbox's traffic layer updates every few minutes, not live). If your drivers follow static morning routes and you're okay writing Python to sequence stops, this works. If you need dynamic rerouting when a customer cancels mid-route or real-time ETA updates texted to customers, you'll hit the MCP's ceiling fast and need a dedicated routing API like Route4Me or Onfleet. Mapbox shines for proof-of-concept routing or low-frequency batch jobs, not high-stakes real-time dispatch.
Permanent Reverse Geocoding for compliance audit trails
A 12-person HVAC company needs to log where technicians clock in and out for labor compliance audits. Every check-in captures GPS coordinates; the back-office team needs human-readable addresses cached forever for DOL inspections. Mapbox's Permanent Reverse Geocoding tool converts lat/lon to addresses you can store indefinitely without violating Terms of Service—critical when audits happen 18 months later. The API_KEY setup means the field app dev can integrate it in a sprint without enterprise sales calls. This beats Google's reverse geocoding (which prohibits long-term caching unless you display a Google Map) and works at scale up to 100k check-ins/month before you need to negotiate enterprise pricing. If your team is under 20 techs and check-ins stay under 5k/month, Mapbox's free tier covers it. Past that threshold, confirm your account has permanent geocoding privileges before you architect around it.
Frequently asked
What does the Mapbox MCP do in Switchy?
It lets your team geocode addresses, retrieve directions, and embed map styles without writing API code. You can batch-process up to 50 locations at once, convert coordinates to place names, or pull turn-by-turn routes—all through natural language prompts in Switchy's chat interface.
Do I need a Mapbox account to use this MCP?
Yes. You need a Mapbox account and a valid API key (access token). Paste the token into Switchy's connection form. Permanent geocoding features require an enterprise Mapbox plan; the MCP will tell you if your account lacks those privileges when you try to use them.
Can the Mapbox MCP create custom maps or edit styles?
No. It retrieves and embeds existing Mapbox styles you've already published, but it won't create new styles or modify layers. For design work, use Mapbox Studio directly. The MCP is for querying data—geocoding, directions, font glyphs—not authoring map visuals.
Why use this instead of calling the Mapbox API myself?
You skip writing boilerplate for token validation, error handling, and batch formatting. Your team can geocode a spreadsheet of addresses or pull route instructions by describing the task in plain English, then pipe results into other Switchy tools without touching code.
Who on my team should connect the Mapbox MCP?
Whoever owns your Mapbox account and can generate API keys. Once connected in Switchy, any workspace member can use the geocoding and directions tools. If you need permanent geocoding, confirm your Mapbox plan supports it before connecting.