API and MCP

1. Get a key

Create a key on your Account page. It is shown once, so store it somewhere safe. You can have up to 5 keys and revoke any of them at any time.

2. Use it with Claude, Cursor or any MCP client

Claude Code:

claude mcp add --transport http localbuyerfinder https://localbuyerfinder.com/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Any client that takes a JSON config:

{
  "mcpServers": {
    "localbuyerfinder": {
      "type": "http",
      "url": "https://localbuyerfinder.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Then just ask: "Find 50 roofing contractors in Boise with no real website and show me the owners."

3. Or call the REST API

curl -H "Authorization: Bearer YOUR_KEY" "https://localbuyerfinder.com/api/v1/cities?q=boise"

curl -X POST -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"business_type":"roofing_contractor","city_id":5586437,"limit":50}' \
  https://localbuyerfinder.com/api/v1/searches

• GET/api/v1/meYour plan and credits.
• GET/api/v1/business-types?q=roofFind the exact business type to search for. Free.
• GET/api/v1/cities?q=boiseFind a city id anywhere in the world. Free.
• POST/api/v1/searchesStart a search: {"business_type": "roofing_contractor", "city_id": 5586437, "limit": 100}. 1 credit per business found.
• GET/api/v1/searchesYour searches.
• GET/api/v1/searches/{id}Status, and the leads once it is done.
• POST/api/v1/searches/{id}/unlockFind owners and test emails. 5 credits per business that gains something.
• POST/api/v1/campaignsOne business type across a region or a list of city ids.
• GET/api/v1/campaigns/{id}Campaign progress and merged leads.

Limits

• 60 requests a minute per key.
• One search, unlock or campaign running at a time per account.
• Searches run live and usually take 1 to 3 minutes. Poll the search every 10 seconds or so.
• Results are yours: every key only ever sees its own account's searches.