Skip to main content
Glama
gmaps-lead-atlas-mcp

gmaps-lead-atlas-mcp

by msaeedsakib

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-mcp

For 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

  1. Create or select a project at https://console.cloud.google.com/

  2. Enable Places API (New) at https://console.cloud.google.com/apis/library/places.googleapis.com

  3. Create an API key at https://console.cloud.google.com/apis/credentials

  4. Restrict the key to the Places API (New) under API restrictions

  5. 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

query

string

required, e.g. "plumbers"

location

string

"Austin, TX" or "30.2672,-97.7431"

radius_meters

number

only applies to coordinate locations

included_type

string

Places type, e.g. "plumber"

max_results

number

1–60, default 20

filters.has_website

boolean

false selects businesses without a website

filters.has_phone

boolean

false selects businesses without a phone

filters.min_rating / max_rating

number

0–5

filters.min_reviews / max_reviews

number

review count bounds

filters.open_now

boolean

filters.price_levels

string[]

PRICE_LEVEL_INEXPENSIVE, etc.

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 build

Set 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 tools
get_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

    A4.7/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers