gmaps-lead-atlas-mcp
Allows an LLM to find and qualify local business leads via the Google Maps Places API, with capabilities to search businesses by criteria, get detailed information, and sweep an area for comprehensive coverage.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gmaps-lead-atlas-mcp dental clinics in Austin with no website and fewer than 20 reviews"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gmaps-lead-atlas-mcp
An MCP server that lets an LLM find and qualify local business leads through the official Google Maps Places API.
Ask your assistant for "dental clinics in Austin with no website and fewer than 20 reviews" and get a contactable list back.
Install
claude mcp add gmaps-lead-atlas -e GOOGLE_MAPS_API_KEY=YOUR_KEY -- npx -y gmaps-lead-atlas-mcpFor Claude Desktop, Cursor, or Windsurf, add this to the MCP config file:
{
"mcpServers": {
"gmaps-lead-atlas": {
"command": "npx",
"args": ["-y", "gmaps-lead-atlas-mcp"],
"env": { "GOOGLE_MAPS_API_KEY": "YOUR_KEY" }
}
}
}Related MCP server: Generect Live API MCP Server
Getting an API key
Create or select a project at https://console.cloud.google.com/
Enable Places API (New) at https://console.cloud.google.com/apis/library/places.googleapis.com
Create an API key at https://console.cloud.google.com/apis/credentials
Restrict the key to the Places API (New) under API restrictions
Enable billing on the project — Places API requires it even within the free tier
Set a budget alert first
This server calls a paid API. Before your first sweep, set a budget alert at https://console.cloud.google.com/billing/budgets so an unattended agent cannot surprise you.
Every tool response reports api_calls_used and session_calls_total so the model can see what it is spending.
sweep_area is the only expensive tool — it defaults to 25 tiles and reports exactly how many it searched.
Tools
search_businesses
Search by query and area with lead-qualification filters.
Parameter | Type | Notes |
| string | required, e.g. |
| string |
|
| number | only applies to coordinate locations |
| string | Places type, e.g. |
| number | 1–60, default 20 |
| boolean |
|
| boolean |
|
| number | 0–5 |
| number | review count bounds |
| boolean | |
| string[] |
|
One caveat worth knowing: Google ranks results by prominence, which correlates with having a website
and many reviews. Businesses without a web presence are ranked last and often fall outside the 60-result
ceiling. A short list under has_website: false means the view is truncated, not that few such businesses
exist. Use sweep_area for representative coverage.
get_business_details
Full details for up to 10 place IDs: opening hours, all phone formats, address components, reviews, business status. One API call per ID.
sweep_area
Tiles a city or region into overlapping circular searches and deduplicates, applying the 60-result
ceiling per tile instead of per query. Parameters: query, area, included_type,
tile_radius_meters (default 1500), max_tiles (default 25), filters.
Reports tiles_searched, tiles_total, and truncated so a partial sweep is never silently partial.
What this is not
This is a read-through query tool. It stores nothing, caches nothing, and writes no database. Results are returned to the model for the duration of a session. Using the Google Maps Platform to build a persistent derived dataset is prohibited by its Terms of Service — please keep it that way.
Places API does not return email addresses.
Development
npm install
npm test # no API key needed
npm run typecheck
npm run buildSet GOOGLE_MAPS_API_KEY to additionally run the single live smoke test.
Releases publish from CI via npm trusted publishing — see RELEASING.md.
License
AGPL-3.0-or-later. See LICENSE.
You may use this commercially, including running a lead-generation business with it. If you offer it to others over a network, the AGPL requires you to release your source under the same license.
Available Tools
3 toolsget_business_detailsGet business detailsA
Fetch full Google Maps details for up to 10 businesses by place ID. Returns opening hours, all phone formats, address components, reviews and business status. Costs one API call per place ID — use search_businesses first to narrow the list.
Inputs: place_ids (required). Returns: results, api_calls_used, session_calls_total
search_businessesSearch businessesA
Search Google Maps for businesses matching a query, with lead-qualification filters.
IMPORTANT: Google ranks results by prominence, which correlates strongly with having a website and many reviews. Businesses lacking a website or phone are therefore ranked LAST and often fall outside the 60-result ceiling. A small result count under has_website:false means the view is truncated, NOT that few such businesses exist. Use sweep_area for representative coverage of a city or region.
Inputs: query (required), filters, location, max_results, +2 more. Returns: note, businesses, result_count, api_calls_used, +1 more
sweep_areaSweep areaA
Search an entire city or region by tiling it into overlapping circular searches, then deduplicating.
Use this instead of search_businesses when you need representative coverage rather than the top results. A plain search returns at most 60 results ranked by prominence; this applies that ceiling per tile instead.
COST: this issues roughly one to three API calls per tile. max_tiles defaults to 25. Raise max_tiles for better coverage and higher cost. Every response reports the exact call count.
Inputs: area (required), query (required), filters, max_tiles, +2 more. Returns: truncated, businesses, tiles_total, result_count, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: search_businesses for targeted queries with filters, sweep_area for tiled regional coverage, and get_business_details for fetching full details by place ID. The descriptions explicitly clarify when to use each, leaving no ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case: search_businesses, sweep_area, get_business_details. The verbs are clear and the pattern is uniform.
Three tools is well-scoped for a Google Maps lead-gen server. Each tool covers a necessary part of the workflow—search, area sweep, and details—without unnecessary overlap or bloat.
The tool surface covers the full lead-generation flow: finding businesses via search or area sweep, then retrieving detailed information including reviews and status. There are no obvious gaps for the stated purpose.
Maintenance
Related MCP Connectors
Real-time Google Maps local business leads, reviews, places & emails MCP. OAuth or API key.
Search Google Maps businesses via MCP - name, address, phone, rating, hours, GPS.
Real-time local business places, reviews, geocoding & contact emails MCP. OAuth or API key.
All HasData scraping tools in one MCP server: Google, TikTok, Instagram, maps, e-commerce and more.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceIntegrates with Google Places API to allow searching, retrieving details, and finding nearby places through an MCP server interface.ISC
- AlicenseAqualityAmaintenanceMCP server for B2B lead generation and company search using the Generect Live API. Provides tools to search leads, companies, generate emails, and get lead by URL.21351 npm1MIT
- FlicenseAqualityDmaintenanceMCP server for real-time public-web lead research without search API keys, using Google Maps and web search engines with LLM-based extraction, crawling, and local lead storage/export.8-
- AlicenseBqualityDmaintenanceMCP server that exposes Google Business Profile / Google My Business REST APIs as MCP tools, returning Google API responses directly without added workflow or business logic.721Apache 2.0