mcpField
M
mcp-local-business-lead-builder

mcp-local-business-lead-builder

Local
github.com/mambalabsdevBusiness & Marketing0Updated 1d ago

About mcp-local-business-lead-builder

An MCP server that builds local business lead lists from public Google Maps search results. It accepts queries or category-location pairs and returns business details, with filters and deduplication.

Key features

  1. 01Search by query or category and location
  2. 02Return contact, address, rating, and hours
  3. 03Filter by rating, reviews, website, or phone
  4. 04Deduplicate businesses across searches

Use cases

  1. 01Find rated roofing contractors in a city
  2. 02Build a lead list of local dentists
  3. 03Compare business contacts across several locations

MCP support

Exposes the `build_local_business_leads` tool to MCP clients. It starts the Apify actor, waits for the run, and returns dataset rows.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"com-mambabuilt-mcp-local-business-lead-builder": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-local-business-lead-builder"
],
"env": {
"APIFY_TOKEN": "<APIFY_TOKEN>"
}
}
}
}
Run commandnpx -y @mambalabsdev/mcp-local-business-lead-builder
Environment variables to set
APIFY_TOKENSecretApify API token from https://console.apify.com/account/integrations

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@mambalabsdev/mcp-local-business-lead-builder1.0.0

Tools

1

Saved tool list · updated 4d ago

ParameterTypeRequiredDescription
dedupeenumNoSkip a business an earlier search in the same run returned. Default true.true | false
countrystringNoTwo letter country code Google uses to rank results. Default us.
queriesarrayNoSearches the way you type them in Google Maps: a business category and a place, for example dentist in Austin, TX. Up to 100 per run.
languagestringNoTwo letter language code for the results. Default en.
locationsarrayNoPlaces to search in: a city with its state or country, a ZIP code, or a neighborhood. Combined with every category.
categoriesarrayNoBusiness categories, for example roofing contractor. Each is searched in every location.
min_ratingstringNoKeep only businesses rated at or above this, for example 4.0. Filtered businesses are not billed.
proxy_modeenumNoauto uses the Apify proxy and moves a refused request to residential addresses; residential uses residential only. A reliability choice; proxy use adds nothing to the price. Default auto.auto | residential
min_reviewsstringNoKeep only businesses with at least this many Google reviews.
require_phoneenumNoSkip businesses with no phone. Default false.true | false
max_charge_usdstringNoOptional. The run stops before any row that would take its charges over this amount.
require_websiteenumNoSkip businesses with no website. Default false.true | false
max_places_per_querystringNoPlace rows per search, 1 to 500. Each place row is billed. Default 20.

Details

From the project README

Local Business Lead Builder MCP Server

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

An MCP server for the Mamba Labs Local Business Lead Builder actor on Apify. Give it a business category and a place, or a search such as dentist in Austin, TX. Each run reads the public Google Maps search results and returns one row per business with website, phone, address, rating, and review count.

What's Inside

What it does

Give queries (for example plumber in Austin, TX), or categories plus locations to search every pair. You get one row per business: name, Google place ID and Maps link, website and domain, phone in local and international format, full address with city, postal code, state, and country, latitude and longitude, categories, star rating, review count, and weekly hours. Each search ends with one free summary row with its counts. Filters for rating, reviews, website, and phone drop businesses before they are billed, and a business found by two searches is returned once. All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-local-business-lead-builder": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-local-business-lead-builder"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The build_local_business_leads tool appears.

Prerequisites

Example prompts

  • "Find 50 roofing contractors in Denver, CO with a website and at least 4 stars."
  • "List dentists in Manchester, UK with their phone numbers and review counts."
  • "Build a lead list of HVAC contractors in Austin, Dallas, and Houston, Texas."

Tool

build_local_business_leads. One tool. Example arguments:

{
  "categories": ["roofing contractor"],
  "locations": ["Denver, CO"],
  "max_places_per_query": "50",
  "require_website": "true",
  "min_rating": "4.0"
}

Inputs

Every buyer facing input of the actor, unchanged. Omitted inputs take the actor's own defaults. Numbers and booleans are sent as strings.

InputTypeDescription
queriesarraySearches, for example dentist in Austin, TX. Up to 100
categoriesarrayBusiness categories, searched in every location
locationsarrayPlaces: a city with its state or country, a ZIP code, or a neighborhood
max_places_per_querystringPlace rows per search, 1 to 500. Default 20
min_ratingstringKeep businesses rated at or above this
min_reviewsstringKeep businesses with at least this many reviews
require_websitestringtrue or false. Default false
require_phonestringtrue or false. Default false
dedupestringSkip repeats across searches. Default true
languagestringTwo letter language code. Default en
countrystringTwo letter country code for ranking. Default us
max_charge_usdstringOptional cost cap for the run
proxy_modestringauto or residential. Default auto

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

EventFree planBronzeSilverGold
place-row, per business returned$0.003$0.00285$0.0027$0.00255
apify-actor-start, per run start$0.0005$0.0005$0.0005$0.0005

Search summary rows, blocked and error rows, filtered businesses, and skipped repeats are free.

Your keys

The actor needs no key. It reads the public Google Maps search results and holds no Google key or any other key. Proxy traffic adds nothing to your price: Mamba Labs pays the platform costs of the run. proxy_mode is a reliability setting.

Full actor documentation

apify.com/mambalabs/local-business-lead-builder

License

MIT. See LICENSE.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.