Leadmaps for Claude — European business data in your conversations

Claude speaks MCP natively. One command — or one config block — and it can count, search and export 13.2M+ European local businesses (13,233,049 listings) — counting is always free, so Claude sizes every request before spending a credit.

The fastest path: one command

The leadmaps CLI on npm (zero dependencies, nothing to install) validates your key live against the free count endpoint — an invalid key exits and writes nothing — then registers the MCP server with Claude Code at user scope:

Manual setup

1. Create your API key at app.leadmaps.io/keys (a free lm_test_ key works, no card needed).
2. Claude Code: run `claude mcp add --transport http leadmaps https://mcp.leadmaps.io/mcp --header "Authorization: Bearer lm_live_xxx"`.
3. Claude Desktop: add the JSON block below via mcp-remote in claude_desktop_config.json.
4. Ask Claude to `count_places` for your target — it is free — then search or export.

{
  "mcpServers": {
    "leadmaps": {
      "type": "http",
      "url": "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

Why Claude + Leadmaps works so well

Claude is the most capable MCP client on the market: it plans multi-step research on its own. Given the Leadmaps server, a single prompt like "Build me a list of 150 real-estate agencies in Lille rated 4.4+, with a website, exported as CSV" becomes a safe, budgeted pipeline:

1. count_places (free) — Claude checks the result size first: 612 matches.
2. create_export — Claude launches an async export limited to 150 rows.
3. get_export_status — Claude polls once, then hands you the download URL.
4. 150 credits charged, and re-running the same request within 30 days is free (dedup).

Working with the spending cap

If your account hits its spending cap mid-export, the job pauses (paused_cap) instead of failing. Claude is told explicitly: "do NOT poll further; tell the user to raise the cap at app.leadmaps.io/billing then call resume". No infinite loops, no surprise invoices.

Claude Code one-liner

claude mcp add --transport http leadmaps https://mcp.leadmaps.io/mcp \
  --header "Authorization: Bearer lm_live_xxx"

Claude Desktop (via mcp-remote)

{
  "mcpServers": {
    "leadmaps": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.leadmaps.io/mcp",
               "--header", "Authorization: Bearer lm_live_xxx"]
    }
  }
}

A prospecting agent prompt that works

You are my local prospecting agent. Always call count_places before any search. Never deliver more than 200 places without asking me. Prefer create_export for anything above 50 results. Report credits_charged after every paid call.

FAQ