Bring Geocoding
to Windsurf
Create your Vinkius account to connect Mapbox to Windsurf and start using all 8 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the Mapbox MCP Server?
Connect to Mapbox and access world-class location services through natural conversation.
What you can do
- Geocoding — Convert addresses, place names and POIs to coordinates and structured addresses
- Reverse Geocoding — Convert GPS coordinates to human-readable addresses
- Directions — Get driving, walking and cycling routes with step-by-step instructions
- Distance Matrix — Calculate travel times and distances between multiple locations
- Isochrones — Show areas reachable within a specific time or distance
- Elevation — Get elevation data for any coordinates
- Static Maps — Generate map image URLs for any location
- Nearby Search — Find points of interest near coordinates
How it works
- Subscribe to this server
- Enter your Mapbox Access Token
- Start using location services from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Developers — geocode addresses, calculate routes and generate map images via API
- Logistics — optimize delivery routes with distance matrices and isochrones
- Travelers — get directions, find nearby places and check elevation data
Built-in capabilities (8)
Returns the place name, coordinates, address components (street, city, state, postal code, country), place type and bounding box. Use this to find coordinates for use with directions, distance matrix and other tools. Convert a place name to coordinates
Returns route distance, duration, geometry, step-by-step instructions and maneuver data. Supports driving (mapbox/driving), walking (mapbox/walking) and cycling (mapbox/cycling) profiles. Coordinates are semicolon-separated "longitude,latitude" pairs (e.g. "-77.0365,38.8977;-74.006,40.7128" for DC to NYC). Get driving, walking or cycling directions
Useful for logistics, delivery routing and travel planning. Returns a matrix of durations (seconds) and distances (meters) between all source-destination pairs. Coordinates are semicolon-separated "lon,lat" pairs. Supports driving, walking and cycling profiles. Get travel times between multiple origins and destinations
Useful for hiking, aviation and geographic research. Coordinates are comma-separated "lon,lat" pairs. Get elevation for coordinates
Returns polygon contours showing the reachable area. Useful for determining service areas, commute ranges and accessibility. Coordinates are "lon,lat". Get reachable area within a time or distance
Returns a direct image URL that can be used in markdown, HTML or downloaded. Supports customizable zoom level and image dimensions. Generate a static map image for a location
Returns the nearest address, city, state, country and other location details. Convert coordinates to an address
Returns nearby places with names, addresses, categories, distances and coordinates. Use query to search for specific types of places (e.g. "restaurant", "gas station", "hotel"). Search for places near coordinates
Why Windsurf?
Windsurf's Cascade agent chains multiple Mapbox tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 8 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
- —
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
- —
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
- —
JSON-based configuration means zero code changes: paste a URL, reload, and all 8 tools are immediately available
- —
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Mapbox in Windsurf
Why run Mapbox with Vinkius?
The Mapbox connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 8 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.
* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.
Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect Mapbox using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Mapbox and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect Mapbox to Windsurf through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
Mapbox for Windsurf
Every request between Windsurf and Mapbox is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
How do I get a Mapbox Access Token?
Sign up for a free account at account.mapbox.com, go to Access Tokens and create a new token. Copy the token — it starts with pk..
Can I get driving directions?
Yes! Use get_directions with coordinates and the 'driving' profile. Returns route distance, duration, step-by-step instructions and geometry. Also supports 'walking' and 'cycling' profiles.
What are isochrones used for?
Isochrones show the area reachable within a specific time or distance from a location. Useful for delivery zones, commute analysis, real estate proximity and accessibility planning.
Can I calculate distances between multiple locations?
Yes! Use get_distance_matrix with multiple coordinate pairs. Returns a matrix of durations (seconds) and distances (meters) between all source-destination pairs. Supports driving, walking and cycling profiles.
How does Windsurf discover MCP tools?
Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.
Can Cascade chain multiple MCP tool calls?
Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
Does Windsurf support multiple MCP servers?
Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.
Server not connecting
Check Settings → MCP for the server status. Try toggling it off and on.
Explore More MCP Servers
View all →
Zoho Sheet
13 toolsConnect your AI agents to Zoho Sheet for spreadsheet management: workbooks, worksheets, cell data, rows, and sharing.
Banco Inter
8 toolsConnect to your Banco Inter Empresas digital account. Automate Pix, Boletos, balance inquiries and statements.
SemVer Version Manager
2 toolsStop LLMs from guessing software versions. Deterministically evaluate semantic version bounds, compatibilities, and sort releases perfectly.
StackHawk
10 toolsConnect your AI to the StackHawk DAST platform. Run automated security scans, triage alerts seamlessly, and find vulnerabilities effortlessly.