Home / Clients / Windsurf

Connect Windsurf to hosted MCP servers

Give Windsurf, Codeium's agentic IDE, 10,812 tools through one remote MCP server, without hitting its tool limit.

Steps

  1. Create an API key in the dashboard.
  2. Open Windsurf Settings → Cascade → MCP servers → Add server, or paste the JSON below into ~/.codeium/windsurf/mcp_config.json.
  3. Refresh the server list; Cascade can then search for and call tools.

Add to ~/.codeium/windsurf/mcp_config.json

Add to ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "hj-hub": {
      "serverUrl": "https://mcp.hjlabs.in/mcp/hub",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with a key from your dashboard. Windsurf connects to the HTTP endpoint directly: no bridge, nothing to install.

What Windsurf sees

Three tools: search_tools, call_tool and use_tool. When it needs something, it searches in plain words, gets the best matches with their schemas, and calls one. Any tool can also be called by its full name. You can connect an individual server instead, such as Public Knowledge or Developer Toolbox; the snippet is on each server page.

Other clients