Leadmaps for Windsurf — European business data in Cascade

Windsurf reads ~/.codeium/windsurf/mcp_config.json. One entry in its serverUrl syntax and Cascade — Windsurf's agent — can count, search and export 13.2M+ European local businesses (13,233,049 listings) mid-task. Counting is always free, so it sizes every request before spending a credit — ideal with a free sandbox lm_test_ key.

The fastest path: one command

The CLI validates your key against the live API, then writes Windsurf's mcp_config.json in its serverUrl syntax — preserving every other MCP server in the file and saving a .bak backup first:

windsurf — leadmaps connect — 80×24
$ npx leadmaps connect --agent windsurf
Validating your key against api.leadmaps.io …
✓ 13,233,049 listings reachable
✓ Added the "leadmaps" server to ~/.codeium/windsurf/mcp_config.json
Restart Windsurf to load the six leadmaps tools (count_places is always free).
 
Try this first prompt:
"Find 150 real-estate agencies in Lille rated ≥ 4.4 with a website, export to CSV."

Manual setup

  1. Create a free lm_test_ key at app.leadmaps.io/keys (sandbox: ~5,000 real listings, 0 credits).
  2. Add the block below to ~/.codeium/windsurf/mcp_config.json — note Windsurf uses serverUrl, not url.
  3. Restart Windsurf; the six leadmaps tools become available to Cascade.
  4. Switch to an lm_live_ key when you go to production.
{
  "mcpServers": {
    "leadmaps": {
      "serverUrl": "https://mcp.leadmaps.io/mcp",
      "headers": { "Authorization": "Bearer lm_live_xxx" }
    }
  }
}

3 copy-paste prompts

  • Count plumbers rated ≥ 4.5 in Nantes, then deliver the top 20 with phone and website.
  • Find 150 real-estate agencies in Lille rated ≥ 4.4 with a website, export to CSV.
  • List categories around “food”, then count pizzerias without a website in the Rhône department.

MCP tools

ToolCost
count_placesFree — always call first
search_places1 credit per place returned (30-day dedup free)
get_place1 credit (dedup)
list_categoriesFree
create_export1 credit per delivered row
get_export_statusFree

FAQ

Where does Windsurf keep its MCP configuration?

In ~/.codeium/windsurf/mcp_config.json (same path on macOS, Linux and Windows). Windsurf’s remote syntax uses serverUrl — the only difference from the Claude or Cursor HTTP block. `npx leadmaps connect --agent windsurf` writes that file for you, .bak backup included.

Can I develop without spending credits?

Yes: the free lm_test_ key queries a sandbox of ~5,000 real listings for 0 credits — ideal for prototyping lead-gen features with Cascade.

The Leadmaps tools do not show up in Windsurf — what should I check?

Restart Windsurf after editing mcp_config.json, make sure the field is named serverUrl (not url), and check the https://mcp.leadmaps.io/mcp address and the Authorization: Bearer header. Once connected, Cascade sees the six leadmaps tools.

How do I disconnect Leadmaps from Windsurf?

Remove the leadmaps entry from mcp_config.json (the CLI left a .bak backup next to it), then revoke the key at app.leadmaps.io/keys if you no longer use it elsewhere.