gmaps.dev

dev.gmapsPublished by gmaps.devOfficial publisherv1.0.0Updated Oct 26, 2026

Find businesses by what they are and where they are, collect a whole city, and export the list.

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Remote MCP server for finding businesses by type and location, collecting whole areas, and exporting the results as files.

What you can do
  • Search and read places by name, area, Google cid, place ID or Maps link
  • Start, monitor, cancel and quote area-wide collections that gather places in the background
  • Check coverage of an area for a term and review monthly credit usage
  • Export a collection's places as csv, json or xlsx and read the download link
  • Create, list, update, delete and test webhooks, and review delivery history
  • List the projects and licenses credited by the service
When to use it
Useful when an assistant needs local business or place data for a city or neighborhood, wants to build a list of places in an area and export it, or needs webhook notifications when a background collection finishes.
Requirements
A remote streamable HTTP endpoint; no local package. Most tools need an API key, and webhook tools also need a paid plan. Collections consume credits, so a plan with a credit allowance is required.
Before you install
Collections spend credits as new places arrive, so costs accrue in the background; quote a collection first and check usage. Export links open without an API key for 24 hours, so share them carefully. Webhook creation returns a signing secret once, and webhook tools can delete endpoints and their delivery records.

Installation

In SourceWeft

  1. Open gmaps.dev in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.gmaps%2Fgmaps/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "gmaps-dev": {
      "type": "http",
      "url": "https://api.gmaps.dev/mcp"
    }
  }
}

Tools

18

get_attributions

List the open-source projects we build on

List the projects credited by gmaps.dev, with their licenses and notices. No API key needed. Costs no credits.

Takes no parameters.

search_places

Search for places

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.

ParametersgeorequiredlangwaitlimitkeywordsrequiredminRating

get_place

Look up a place

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.

Parametersplacerequired

create_collection

Start a collection

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.

ParametersgeorequiredlangenrichkeywordsrequiredmaxPlacesminRating

list_collections

List your collections

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.

Parameterslimitoffsetstatus

get_collection

Read a collection

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.

Parametersidrequired

cancel_collection

Cancel a collection

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.

Parametersidrequired

quote_collection

Quote a collection

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.

ParametersgeorequiredlangenrichkeywordsrequiredmaxPlacesminRating

create_export

Export a collection

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.

ParametersformatlocalecollectionIdrequired

get_export

Read an export

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.

Parametersidrequired

get_coverage

Check an area's coverage

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.

Parametersgeorequiredlangkeywordsrequired

get_usage

Get credit usage

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.

Takes no parameters.

create_webhook

Add a webhook endpoint

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.

Parametersurlrequiredeventsdescription

list_webhooks

List your webhook endpoints

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.

Takes no parameters.

update_webhook

Change a webhook endpoint

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.

Parametersidrequiredeventsenableddescription

delete_webhook

Delete a webhook endpoint

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.

Parametersidrequired

test_webhook

Send a test event

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.

Parametersidrequiredmessage

list_webhook_deliveries

List an endpoint's deliveries

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.

Parametersidrequiredlimit

Version history

1
  1. v1.0.0LatestOct 19, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Gmaps integrations

Google Maps Brasil — Monitor de Novos Negócios (+CNPJ)

Published by GitHub account paulovitorti

Remote MCP server that detects new businesses on Google Maps in Brazil and returns fresh leads already carrying a CNPJ.

Streamable HTTPWeb executableAuth
Business & CommerceCredential requiredOct 27, 2026

Google Maps Brasil - Leads Locais

Published by GitHub account paulovitorti

A remote MCP server that lets an assistant pull Brazilian Google Maps business listings enriched with phone, email, website and federal tax registry (CNPJ) data

Streamable HTTPWeb executableAuth
Business & CommerceCredential requiredOct 24, 2026