Leadmaps for Cursor — business data while you build

Cursor reads .cursor/mcp.json. One command — or one file — one key, and your AI pair-programmer can query 13.2M+ real European business listings while writing the code that consumes them — ideal with a free sandbox lm_test_ key.

The fastest path: one command

One command wires every Cursor project at once: the CLI validates your key against the live API, then writes the leadmaps server into ~/.cursor/mcp.json (global) — preserving your other MCP servers and saving a .bak backup first. Prefer a per-project config? The manual setup below covers it.

cursor — leadmaps connect — 80×24
$ npx leadmaps connect --agent cursor
Validating your key against api.leadmaps.io …
✓ 13,233,049 listings reachable
✓ Added the "leadmaps" server to ~/.cursor/mcp.json
Restart Cursor 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. Create .cursor/mcp.json in your project with the block below.
  3. Reload Cursor; the six leadmaps tools appear in the MCP panel.
  4. Switch to an lm_live_ key when you go to production.
{
  "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

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

Should I commit .cursor/mcp.json with my key?

No: commit the file with a placeholder and inject the key via an environment variable, or keep the file local (.gitignore). An lm_live_ key pushed to a public repo must be revoked immediately.

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 inside Cursor.

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

Reload Cursor after creating .cursor/mcp.json, check the https://mcp.leadmaps.io/mcp URL and the Authorization: Bearer header. Once connected, the MCP panel lists the six leadmaps tools.

Does the CLI write to my project or to my global config?

`npx leadmaps connect --agent cursor` writes the global ~/.cursor/mcp.json (all your projects), read-modify-write: your other MCP servers are preserved and the previous file is backed up as .bak. To scope Leadmaps to a single project, create .cursor/mcp.json by hand with the block above instead.