gmaps.dev
Server Details
Find businesses by what they are and where they are, collect a whole city, and export the list.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 18 tools
Tools target distinct resources and actions, but there is some conceptual overlap around collections (get_collection, list_collections, get_coverage, quote_collection) and between search_places and create_collection, which can both initiate background collection work. Descriptions clarify boundaries, so misselection is unlikely but not impossible.
All 18 tools use consistent snake_case verb_noun naming (e.g., create_collection, get_place, list_webhooks, update_webhook). No deviations or mixed conventions.
18 tools is on the heavy side for an MCP server; while each tool maps to a specific operation, the surface covers multiple sub-domains (collections, exports, webhooks, usage) and could feel bloated. The rubric places 16-25 tools as borderline heavy.
Core lifecycle is covered (create/list/get/cancel collection, search/get place, create/get export, full webhook CRUD), but there is no direct tool to list places in a collection (only a file export) and no delete operation for collections or their places, despite export errors implying deletion exists. These are notable gaps for agents needing to manage or iterate over place data.
Available Tools
18 toolscancel_collectionCancel a collectionADestructiveInspect
Stop a collection you no longer want. One that has not started yet stops at once and costs nothing. One already running keeps the places that have arrived and the credits they cost; the search in flight finishes, and nothing new starts. A collection that has already ended cannot be cancelled. Needs an API key. Costs no credits.
Inputs: id (required).
create_collectionStart a collectionAInspect
Search a whole area, square by square, and collect up to maxPlaces of the places in it. Answers straight away with the collection, then works through the area in the background. Read the collection again to see how far it has got. Starting one costs nothing: each new place costs one credit as it arrives, and saved places cost nothing. Needs an API key.
Inputs: geo (required), keywords (required), lang, enrich, +2 more.
create_exportExport a collectionAInspect
Get a link to a collection's places as one file: csv, json or xlsx. The file has the places the collection holds now, even if it is still running. The link opens without an API key for 24 hours, so share it only with people who should see the file. Needs an API key. Costs no credits.
Inputs: collectionId (required), format, locale.
create_webhookAdd a webhook endpointAInspect
Tell us where to POST when a collection ends, instead of asking us every few seconds whether it is done. The answer shows the signing secret once and never again. Store it, then check every request against it. The body carries counts and a link to the places, never the places themselves. Needs an API key and a paid plan. Costs no credits.
Inputs: url (required), events, description.
delete_webhookDelete a webhook endpointADestructiveInspect
Stop sending to an endpoint and forget it, along with the record of what we sent there. To pause one instead, set enabled to false. That keeps the secret, so you do not have to change your code to turn it back on. Needs an API key and a paid plan. Costs no credits.
Inputs: id (required).
get_attributionsList the open-source projects we build onARead-onlyInspect
List the projects credited by gmaps.dev, with their licenses and notices. No API key needed. Costs no credits.
Inputs: no named parameters.
get_collectionRead a collectionARead-onlyInspect
See where a collection has got to: how much of the area is searched, how many places have arrived, and what it has cost so far. Read it again whenever you want an update. Needs an API key. Costs no credits.
Inputs: id (required).
get_coverageCheck an area's coverageARead-onlyInspect
See how much of an area we have already searched for a term, when we last searched it, and how many places we have saved there. Use it to decide whether to collect again or just read the saved places. Needs an API key. Costs no credits and starts nothing.
Inputs: geo (required), keywords (required), lang.
get_exportRead an exportARead-onlyInspect
Read an export you made, with its download link, while the link still works. After 24 hours, or once the collection's places are deleted, it answers 404: make a new export from the collection. Needs an API key. Costs no credits.
Inputs: id (required).
get_placeLook up a placeARead-onlyInspect
Read one saved place, by our id, Google's cid, Google's place ID, or a Google Maps link to it. It never searches: a place we have not saved answers 404, and searching its area with search_places brings it in. Needs an API key. Costs no credits.
Inputs: place (required).
get_usageGet credit usageARead-onlyInspect
See this month's credits: what your plan includes, what you have used, what is left today and this month, and the same totals for each API key. Needs an API key. Costs no credits.
Inputs: no named parameters.
list_collectionsList your collectionsARead-onlyInspect
Your collections, newest first, with the total so you know how many more there are. Filter by status to find the ones still running. Needs an API key. Costs no credits.
Inputs: limit, offset, status.
list_webhook_deliveriesList an endpoint's deliveriesARead-onlyInspect
What we sent to one endpoint, newest first: which event, whether it arrived, how many tries it took, and what your server answered. This is where to look when an event never showed up. Kept for 7 days. Needs an API key and a paid plan. Costs no credits.
Inputs: id (required), limit.
list_webhooksList your webhook endpointsARead-onlyInspect
Every endpoint you have added, newest first, with whether it is still receiving events and why we stopped if it is not. Secrets are not shown again after the endpoint is created. Needs an API key and a paid plan. Costs no credits.
Inputs: no named parameters.
quote_collectionQuote a collectionARead-onlyInspect
See what collecting an area would cost before you start it: how much of it we have searched recently, how many places we have saved there (those cost nothing), how many searches are left to run, and the most it can cost in credits. Needs an API key. Costs no credits and starts nothing.
Inputs: geo (required), keywords (required), lang, enrich, +2 more.
search_placesSearch for placesAInspect
Find places by what they are and where they are, such as bakeries in Curitiba. Places we saved from earlier searches come back at once, for free. If they do not fill limit, a collection starts to find the rest and the answer includes it: each new place costs one credit as it arrives, and it stops at limit, so a search never costs more than limit credits. Search again later, or read the collection, to get the new ones; with wait, the answer waits up to 60 seconds for them. Needs an API key.
Inputs: geo (required), keywords (required), lang, wait, +2 more.
test_webhookSend a test eventADestructiveInspect
Send a "ping" to one of your endpoints now, so you can check your code reads it and the signature checks out before a real collection depends on it. Answers straight away with the delivery; read the deliveries list a moment later to see what your server said. Needs an API key and a paid plan. Costs no credits.
Inputs: id (required), message.
update_webhookChange a webhook endpointADestructiveInspect
Change which events an endpoint receives, rename it, or switch it off and on. This is how an endpoint comes back after we stopped sending to it: fix your server, then set enabled to true. The failure count starts again from zero. Whatever you leave out stays as it was. Needs an API key and a paid plan. Costs no credits.
Inputs: id (required), events, enabled, description.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Related MCP Connectors
Every business of a kind in a city, from Google Maps, read from its website, with verified emails.
Find local businesses on Google Maps, Yellow Pages and Yelp, then pull emails and phones from sites.
Local business leads from Google Maps, 7 directories, DuckDuckGo and OpenStreetMap, with contacts
Find 16M+ US businesses by city/category; build lead lists with owners, contacts, status and hours.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables assembling local business prospect lists from Google Maps searches by category and place, returning one row per business with website, phone, address, coordinates, categories, rating, review count, and weekly hours. Supports filters for minimum rating, review count, website, and phone, plus URL and category-plus-location queries, deduplication across searches, and Clay-ready output via Apify.171 npmMIT
- AlicenseNot gradedqualityDmaintenanceSearch Apple Maps for businesses with Apple ratings and aggregated Yelp and TripAdvisor reviews. Useful for lead generation, restaurant research, and competitive analysis.MIT
- AlicenseAqualityCmaintenanceSearch for local businesses worldwide. Structured data optimized for AI agents. • Search Millions of businesses over 49 countries (Europe, Northamerica, Southamerica, Asia, Oceania) • Quality & demand scoring for every business • Ranking based on real user click-through data • No API key needed, free access • Rate limit: 500 requests/hour per IP61MIT
- FlicenseNot gradedqualityBmaintenanceRetrieves vetted Local Services Ads businesses (Google Guaranteed or Screened) as clean JSON for any service and US city, enabling lead generation, local SEO monitoring, and competitor tracking.-
Glama MCP Gateway
Add one secure layer between your agents and this server.