Windsurf

Add to mcp_config.json.

Windsurf’s Cascade agent reads a JSON config file. One gotcha: the field is serverUrl, not url.

Step 01

Edit ~/.codeium/windsurf/mcp_config.json.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bankbridge": {
      "serverUrl": "https://bankbridge.money/api/mcp",
      "headers": {
        "Authorization": "Bearer bbk_your_api_key_here"
      }
    }
  }
}

Restart Windsurf after editing the config.

Windsurf also supports ${env:VAR}interpolation if you’d rather not hardcode tokens.

Step 02

Verify it works.

Reload Cascade, then ask:

try this

what are my recurring subscriptions?

Troubleshooting

Client connects but shows 0 tools.

Usually the client is caching an old config, or you're on a mode that doesn't expose tools (Ask/Edit vs Agent, for example).

Fix: Fully quit + relaunch the host app. In VS Code Copilot, switch to Agent mode.

401 Unauthorized on every call.

The API key is missing, typo'd, or got revoked. Check the Authorization header starts with `Bearer ` (note the space) and ends in a key you still own.

Fix: Paste a fresh key from Settings.

Tools return a NO_CONNECTIONS warning.

You haven't linked a bank yet.

Fix: Visit Connect a bank — the bank-connect flow opens automatically, ~30 seconds.

Problems? Email hello@bankbridge.money.