How to Use the Mapbox MCP in Windsurf

Q: How does Cascade use Mapbox in Windsurf to resolve addresses?

Cascade triggers the geocode tool to turn plain text addresses into longitude and latitude pairs. It then feeds those coordinates directly into other tools like getdirections without asking you for manual input. This spatial MCP integration speeds up development significantly.

Q: Can I render static maps with Mapbox inside Windsurf?

Yes, the getstaticmap tool returns a direct image URL for any set of coordinates. Cascade can insert this URL directly into your markdown files or HTML components so you can preview the map inside your workspace.

Q: How do I configure the Mapbox MCP Server in my Windsurf settings?

Open your mcpconfig.json file located in the Windsurf config directory and add the server configuration under the mcpServers key. Cascade will automatically discover the routing and geocoding tools upon restart.

Get instant route calculations and spatial data inside Windsurf as Cascade builds your location-aware apps.

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 Windsurf

Create your Vinkius account to connect Mapbox to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build routing flows autonomously in Windsurf

The `get_directions` tool lets Cascade pull exact routing profiles for driving, walking, or cycling directly into your active workspace using this MCP Server. Instead of manually looking up coordinates, the agent chains `geocode` to resolve your addresses before calling the routing engine. You specify the origin and destination, and Cascade handles the rest. It spits out the exact step-by-step maneuvers and total trip duration without needing you to copy-paste coordinate pairs between browser tabs.

Map out delivery zones with this MCP Server

The `get_isochrone` tool calculates exactly how far a driver can travel within a set timeframe. Our agent uses this geometry to write custom delivery-zone boundaries directly into your frontend code. Right. So, you don't have to guess if a neighborhood falls inside a 15-minute delivery window. Your workspace gets updated with actual travel contours and parsed coordinates in one shot.

Batch coordinate lookups inside Cascade

The `get_distance_matrix` tool computes travel times and distances between multiple origins and destinations simultaneously. Cascade applies this matrix to build dispatch dashboards, writing the backend math and testing the endpoints on the fly. Here's the thing—doing this manually means writing complex loops for coordinate arrays. This integration handles the array formatting, triggers the tool, and parses the returned durations in seconds.

Setup guide

Set up Mapbox MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Mapbox MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Mapbox payment history." If connected, Cascade will call the Mapbox tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Cascade triggers the `geocode` tool to turn plain text addresses into longitude and latitude pairs. It then feeds those coordinates directly into other tools like `get_directions` without asking you for manual input. This spatial MCP integration speeds up development significantly.

Yes, the `get_static_map` tool returns a direct image URL for any set of coordinates. Cascade can insert this URL directly into your markdown files or HTML components so you can preview the map inside your workspace.

Open your `mcp_config.json` file located in the Windsurf config directory and add the server configuration under the `mcpServers` key. Cascade will automatically discover the routing and geocoding tools upon restart.

You can choose between driving, walking, and cycling profiles. The routing tool returns precise distances, travel times, and turn-by-turn maneuvers tailored to each transport type.

Your geocoding queries and coordinate pairs are sent directly to the mapping platform via secure V8 sandboxed environments. Vinkius handles the authentication token securely, ensuring your raw coordinates and routing addresses are never exposed or logged.

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