Leadmaps pour Windsurf — la donnée business européenne dans Cascade

Windsurf lit ~/.codeium/windsurf/mcp_config.json. Une entrée dans sa syntaxe serverUrl et Cascade — l'agent de Windsurf — compte, cherche et exporte 13,2M+ d'entreprises locales européennes (13 233 049 fiches) en pleine tâche. Le comptage est toujours gratuit, il évalue donc chaque requête avant de dépenser un crédit — idéal avec une clé sandbox lm_test_ gratuite.

Le chemin le plus rapide : une commande

La CLI valide votre clé contre l'API live, puis écrit le mcp_config.json de Windsurf dans sa syntaxe serverUrl — en préservant tout autre serveur MCP du fichier, backup .bak d'abord :

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."

Installation manuelle

  1. Créez une clé lm_test_ gratuite sur app.leadmaps.io/keys (sandbox : ~5 000 fiches réelles, 0 crédit).
  2. Ajoutez le bloc ci-dessous à ~/.codeium/windsurf/mcp_config.json — Windsurf utilise serverUrl, pas url.
  3. Redémarrez Windsurf ; les six tools leadmaps deviennent disponibles pour Cascade.
  4. Passez sur une clé lm_live_ pour la production.
{
  "mcpServers": {
    "leadmaps": {
      "serverUrl": "https://mcp.leadmaps.io/mcp",
      "headers": { "Authorization": "Bearer lm_live_xxx" }
    }
  }
}

3 prompts copiables

  • Compte les plombiers notés ≥ 4,5 à Nantes, puis livre-moi les 20 premiers avec téléphone et site web.
  • Trouve 150 agences immobilières à Lille avec note ≥ 4,4 et un site web, exporte en CSV.
  • Liste les catégories disponibles autour de « restauration », puis compte les pizzerias sans site web dans le Rhône.

Les tools MCP

ToolCoût
count_placesGratuit — à appeler en premier
search_places1 crédit par fiche retournée (re-livraison 30 j gratuite)
get_place1 crédit (dédup)
list_categoriesGratuit
create_export1 crédit par ligne livrée
get_export_statusGratuit

FAQ

Où Windsurf stocke-t-il sa configuration MCP ?

Dans ~/.codeium/windsurf/mcp_config.json (même chemin sous macOS, Linux et Windows). La syntaxe distante de Windsurf utilise serverUrl — c'est la seule différence avec le bloc HTTP de Claude ou Cursor. `npx leadmaps connect --agent windsurf` écrit ce fichier pour vous, backup .bak inclus.

Puis-je développer sans consommer de crédits ?

Oui : la clé lm_test_ gratuite interroge une sandbox d'environ 5 000 fiches réelles pour 0 crédit — idéale pour prototyper vos features lead-gen avec Cascade.

Les tools Leadmaps n’apparaissent pas dans Windsurf, que vérifier ?

Redémarrez Windsurf après avoir modifié mcp_config.json, vérifiez que le champ s'appelle bien serverUrl (pas url), l'adresse https://mcp.leadmaps.io/mcp et le header Authorization: Bearer. Une fois la connexion établie, Cascade voit les six tools leadmaps.

Comment déconnecter Leadmaps de Windsurf ?

Supprimez l'entrée leadmaps de mcp_config.json (la CLI a laissé un backup .bak à côté), puis révoquez la clé sur app.leadmaps.io/keys si vous ne l'utilisez plus ailleurs.