How to Use the Mapbox (Maps & Geospatial) MCP in Windsurf

Q: How do I configure Mapbox (Maps & Geospatial) in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json or use the Settings UI under Cascade. Add the Vinkius endpoint token to your MCP servers array and hit refresh. Cascade will auto-discover the mapping tools.

Q: What happens if the routing optimization fails?

Invalid coordinates cause solveoptimization to return an error. Cascade reads that failure, usually runs reversegeocode to figure out what went wrong, and corrects the input automatically.

Give Windsurf's Cascade the ability to geocode addresses, optimize routes, and generate maps without prompting every step.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mapbox (Maps & Geospatial) MCP to Windsurf

Create your Vinkius account to connect Mapbox (Maps & Geospatial) 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 (Maps & Geospatial) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf autonomous routing

Your agent handles complex spatial tasks natively through this MCP integration. You set a goal to build a delivery dashboard, and Cascade uses `solve_optimization` to sequence the stops automatically. It figures out the traveling salesperson problem without needing a step-by-step breakdown. Operations chain together naturally. If you provide raw addresses, the agent runs `search_places` to get the coordinates, feeds them into `get_distance_matrix`, and plots the result. You watch Windsurf build the logic while you focus on the architecture.

Location context for spatial apps

The Mapbox MCP Server gives your workspace direct access to geocoding and elevation data. Tell the agent to find the nearest distribution centers, and it fires off `get_isochrones` to calculate reachable areas by drive time. You get instant spatial awareness injected right into your codebase. Messy GPS data gets cleaned up fast. If your user uploads a jagged track log, Cascade applies `snap_to_road` to align the path before running `get_elevation` to build an accurate terrain profile. The agent handles the API interactions behind the scenes.

Visual map generation

Leaving the editor to check if coordinates are correct wastes time. The agent calls `generate_static_map` and returns a URL you can preview right in your markdown files or terminal logs. You see exactly what the user will see. Autocomplete testing works perfectly here. Cascade opens a `geocoding_session`, tests your search inputs, and verifies the responses match the expected locations. You get working location features without writing the boilerplate.

Setup guide

Set up Mapbox (Maps & Geospatial) 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 (Maps & Geospatial) 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 (Maps & Geospatial) payment history." If connected, Cascade will call the Mapbox (Maps & Geospatial) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "mapbox-maps-geospatial-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 (Maps & Geospatial) 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 (Maps & Geospatial) MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` or use the Settings UI under Cascade. Add the Vinkius endpoint token to your MCP servers array and hit refresh. Cascade will auto-discover the mapping tools.

Yes. Cascade excels at multi-step tasks. It converts an address with `search_places`, passes the coordinates to `get_directions`, and writes the resulting polyline into your code without stopping for permission.

You need a Vinkius subscription to access the managed MCP Server. That single endpoint token handles the authentication for all the map features.

Invalid coordinates cause `solve_optimization` to return an error. Cascade reads that failure, usually runs `reverse_geocode` to figure out what went wrong, and corrects the input automatically.

Vinkius runs every request in an ephemeral V8 Isolate Sandbox. When your agent sends raw coordinates or user addresses to the Mapbox API, the environment spins up, executes the routing or geocoding, and immediately dies. Zero-trust architecture means no location histories are ever stored.

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