ai.mapsdataPublished by mapsdata.aiOfficial publisherv1.0.0Updated Oct 25, 2026
Build lead lists from Google Maps: businesses with emails, phones and websites, US/CA/UK/AU.
MapsData builds Google Maps lead lists with emails, phones and websites for US, CA, UK and AU, letting an assistant start, monitor and download scrapes.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
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/ai.mapsdata%2Fmapsdata/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.Add this to your client's mcpServers config.
{
"mcpServers": {
"mapsdata": {
"type": "http",
"url": "https://mapsdata.ai/mcp"
}
}
}Search Google Maps categories
Search the Google Maps business categories MapsData can scrape. CALL THIS FIRST, before mapsdata_start_scrape: a scrape's query must be one of these exact categories, and a free-text guess like 'plumbing companies' is rejected.
limitqueryrequiredList valid regions
List the exact region names a scrape accepts for a country. Submit them verbatim. Abbreviations like 'TX' are rejected; use the full name.
countryStart a scrape
Start scraping Google Maps businesses and their emails. Returns IMMEDIATELY with a job id; the scrape itself takes 5 minutes to several hours. Before calling this, confirm the category with mapsdata_search_categories and the region with mapsdata_list_regions. Those two mistakes are the overwhelming majority of rejections. This consumes the user's monthly lead allowance. Set dry_run to check a request against every rule without spending anything.
queryrequiredcitiesstatescountrydry_runlist_nametotal_limitrequiredCheck a scrape
Get the current state of one scrape. This is an INSTANT SNAPSHOT of a job that runs for minutes to hours. Do NOT call it repeatedly in a loop. The response includes next_action, the suggested next step for the job's current status. MapsData also emails the user when a scrape finishes.
job_idrequiredList recent scrapes
List this workspace's recent scrapes, newest first.
limitstatusCancel a scrape
Cancel a queued or running scrape. A queued scrape costs nothing. CANCELLING A RUNNING SCRAPE STILL BILLS the leads already delivered, so confirm with the user before calling this.
job_idrequiredGet a download link
Get a link to a finished scrape's results. The link expires in 15 minutes, so hand it to the user promptly rather than storing it.
scopeformatjob_idrequiredCheck plan usage
How much of this month's lead allowance is left, and the largest single scrape this plan allows. Read max_rows_this_scrape before choosing a total_limit.
Takes no parameters.
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.
Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.
A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.
