How to Use the Mapbox MCP in Claude

Q: Can Claude Desktop pull Mapbox directions for multiple waypoints?

Yes. The getdirections tool accepts semicolon-separated coordinate pairs. You can pass your origin, intermediate stops, and final destination directly through the Claude Desktop interface to plot the route.

Q: How does Claude Desktop handle Mapbox search queries?

The agent uses the searchnearby tool to find points of interest near specific coordinates. It passes your query, like "gas station" or "coffee shop," and returns names, distances, and categories.

Q: Can I get elevation profiles for hiking routes?

Use the getelevation tool by passing comma-separated coordinates. Your agent can query this multiple times along a route to calculate total vertical climb.

Map raw addresses to coordinates and fetch driving routes directly inside your Claude Desktop chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mapbox MCP to Claude Desktop

Create your Vinkius account to connect Mapbox to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Mapbox with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Mapbox MCP Server brings spatial data to Claude Desktop

Look, copying coordinates back and forth from a web browser to your chat window is a waste of time. This MCP Server lets your agent translate addresses to coordinates using `geocode` instantly. You type a street address, and the server returns exact latitude and longitude values right inside your thread. Once you have those coordinates, you can immediately run `reverse_geocode` to inspect nearby intersections. The tool returns structured data containing the postal code, city, and bounding box—and this matters—without you writing a single line of Python to fetch it.

Calculate routing and drive times in your chat

Right. So. Planning delivery runs or dispatch grids usually requires writing boilerplate API requests. Instead, you can use this MCP tool to let Claude Desktop call `get_directions` and spit out turn-by-turn driving, walking, or cycling instructions. If you need to evaluate multiple drop-off points at once, the `get_distance_matrix` tool handles the math. It calculates travel times and distances between all your coordinate pairs, giving your agent the raw numbers to sort your logistics queue.

Generate static map images and isochrones

Here's the thing about spatial analysis. You need to see the actual boundary to know if a delivery area makes sense. The `get_isochrone` tool draws reachable contours based on drive times, showing exactly how far a driver can get in fifteen minutes. To make these boundaries readable, you can render them on a map. Use `get_static_map` to generate a direct image URL that displays right inside your Claude Desktop markdown preview. You get visual proof of your service zones without leaving the chat.

Setup guide

Set up Mapbox MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Mapbox MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Mapbox MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under mapbox-mcp.

json

{
  "mcpServers": {
    "mapbox-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mapbox. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Mapbox now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Mapbox MCP in Claude Desktop

Open your config file. Adding this MCP server takes under two minutes by pasting your API access token under the mcpServers key. Once you save and restart the app, the spatial tools become instantly active in your chat window.

Yes. The `get_directions` tool accepts semicolon-separated coordinate pairs. You can pass your origin, intermediate stops, and final destination directly through the Claude Desktop interface to plot the route.

The agent uses the `search_nearby` tool to find points of interest near specific coordinates. It passes your query, like "gas station" or "coffee shop," and returns names, distances, and categories.

Use the `get_elevation` tool by passing comma-separated coordinates. Your agent can query this multiple times along a route to calculate total vertical climb.

Your location coordinates and geocoded addresses pass straight to the Mapbox API over TLS. Vinkius runs this in a zero-trust sandbox, meaning no location history or spatial queries are saved to disk after the tool returns its payload.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript