Setup guide

Set up @mapbox/mcp-server in Windsurf

communityunknownunknown

Mapbox MCP server.

01Configuration

{
  "mcpServers": {
    "mapbox-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mapbox/mcp-server"
      ]
    }
  }
}

Add this to ~/.codeium/windsurf/mcp_config.json. Generated from the captured install method (npx); the mcpServers shape is shared across Claude Desktop, Cursor, Windsurf, Cline, and VS Code.

02Steps

Make sure Windsurf is installed and up to date.
Open ~/.codeium/windsurf/mcp_config.json and add the block above (merge into any existing mcpServers).
Provide any required API keys/credentials as environment variables.
Restart Windsurf and confirm @mapbox/mcp-server’s tools appear.

03Other runtimes

Claude Desktop Cursor Cline Continue Goose VS Code OpenAI Agents SDK LangGraph CrewAI

04Provenance

config_sourcegenerated from captured install method

last_checked2026-06-30 00:10Z

sourcesnpm registry [p4] · Awesome MCP Servers (wong2) [p6]

Next step

Ship @mapbox/mcp-server to your agents as a governed Loadout — config, scopes, and approval rules in one place.

Build a Loadout

See also: server page · is it safe? · alternatives