Windsurf MCP Enrichment — Connect RichAPI to Cascade

Create an account at app.richapi.ai/signup and copy your key.

Windsurf keeps MCP servers in ~/.codeium/windsurf/mcp_config.json. Reach it through Settings → Cascade → MCP servers, or edit the file. The shape is the mcpServers object you already know from Claude:

{
  "mcpServers": {
    "richapi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.richapi.ai/mcp",
        "--header",
        "x-api-key: ${RICHAPI_KEY}"
      ]
    }
  }
}

Export RICHAPI_KEY in your environment before launching Windsurf, or put the literal key here and accept that it is sitting in a file in your home directory.

Some Windsurf versions accept a remote server directly through a serverUrl field instead of a command. Where that works it is fewer moving parts; it has also changed between releases, so we are not printing it as the default. The shim works either way.

Refresh the server list and the tools appear in Cascade. If they do not, it is almost always npx: Windsurf launched from the dock does not always inherit the PATH your shell has.

We are not in Windsurf's MCP plugin store. There is no one-click install for this, just the config above.

Cascade is autonomous by design, which is the feature and also the thing to be careful with. "Enrich this file" against a 4,000-row CSV is a 4,000-call instruction and it will not check in halfway.

Every RichAPI tool is a read-only lookup. Nothing sends email, posts anything, or writes to a CRM, so a runaway loop costs credits rather than reputation. Still: put a row cap in the prompt, run the first batch, look at the output, then raise it. The 100 free credits are a good size for exactly this test.

Prepaid credits, one pool shared with REST. Each tool above bills its published per-call rate; people_search bills per result, so any estimate needs a result count attached. Rate tiers are on /pricing; the waterfall cost calculator will price a list before you run it.

On email_finder, email_verifier and phone_finder, a call that finds nothing costs zero. The sources ran and were paid; you were not charged. Everywhere else a 2xx bills, including an empty one.

Is this an official Windsurf integration? No. Standard MCP server, standard client, and no plugin store listing.

Does Windsurf's config differ from Claude's? Same mcpServers shape, different file: ~/.codeium/windsurf/mcp_config.json.

Why is Cascade not showing the tools? Refresh the MCP server list first. Then check that npx resolves in the environment Windsurf actually launched with.

Can I keep the tool list short? Connect only what you use. A long tool list makes model tool-selection worse in any client, and this catalog is not small.

Same key from my code? Yes. One key, one credit pool, api.richapi.ai.