MapsData is an MCP server published by ai.mapsdata, hosted at mapsdata.ai. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including mapsdata_search_categories, mapsdata_list_regions, mapsdata_start_scrape, mapsdata_get_scrape, mapsdata_list_scrapes.
Build lead lists from Google Maps: businesses with emails, phones and websites, US/CA/UK/AU.
867 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query * | string | Substring to search for, e.g. 'plumb'. |
| country | string | Optional: the country you will scrape. Categories Google rarely uses there are flagged, with local alternatives (e.g. 'General contractor' in au). |
{
"name": "mapsdata_search_categories",
"title": "Search Google Maps categories",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"description": "Substring to search for, e.g. 'plumb'."
},
"country": {
"enum": [
"au",
"ca",
"uk",
"us"
],
"type": "string",
"description": "Optional: the country you will scrape. Categories Google rarely uses there are flagged, with local alternatives (e.g. 'General contractor' in au)."
}
}
},
"annotations": {
"title": "Search Google Maps categories",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the exact region names a scrape accepts for a country. Submit them verbatim. Abbreviations like 'TX' are rejected; use the full name.
| Parameter | Type | Description |
|---|---|---|
| country | string | one of ["au","ca","uk","us"] |
{
"name": "mapsdata_list_regions",
"title": "List valid regions",
"description": "List the exact region names a scrape accepts for a country. Submit them verbatim. Abbreviations like 'TX' are rejected; use the full name.",
"inputSchema": {
"type": "object",
"properties": {
"country": {
"enum": [
"au",
"ca",
"uk",
"us"
],
"type": "string",
"default": "us"
}
}
},
"annotations": {
"title": "List valid regions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 spends the organization's Scraping Credits (its lead allowance). Set dry_run to check a request against every rule without spending anything. min_reviews, max_reviews and max_emails_per_company are optional. Pass them when the user asks for them. The response reports the filters that apply, including the default email cap.
| Parameter | Type | Description |
|---|---|---|
| query * | string | An exact Google Maps category, e.g. 'Plumber'. Verify it with mapsdata_search_categories first. |
| cities | array | Named cities instead of whole regions. |
| states | array | Full region names, e.g. ['Texas']. Not abbreviations. Use this or cities, not both. |
| country | string | one of ["au","ca","uk","us"] |
| dry_run | boolean | Validate against every rule and return the plan WITHOUT starting a scrape or spending quota. |
| list_name | string | Label for the list. Defaults to the query. |
| limit_basis | string | What total_limit counts. 'emails' stops once that many leads WITH an email are found; leads without one are still delivered and never billed. 'rows' stops at that many leads of any kind. Omit it for the organization's default, which is 'emails' unless the organization used the API before this option… |
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.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string |
{
"name": "mapsdata_get_scrape",
"title": "Check a scrape",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Check a scrape",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List this organization's recent scrapes, newest first.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| status | string | one of ["queued","running","cancelling","cancelled","completed","failed"] |
{
"name": "mapsdata_list_scrapes",
"title": "List recent scrapes",
"description": "List this organization's recent scrapes, newest first.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"status": {
"enum": [
"queued",
"running",
"cancelling",
"cancelled",
"completed",
"failed"
],
"type": "string"
}
}
},
"annotations": {
"title": "List recent scrapes",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string |
{
"name": "mapsdata_cancel_scrape",
"title": "Cancel a scrape",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Cancel a scrape",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| scope | string | 'emails' is rows with a deliverable email, which is what usage is billed on. 'all' is every scraped row. |
| format | string | one of ["csv","xlsx"] |
| job_id * | string |
{
"name": "mapsdata_get_download_link",
"title": "Get a download link",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"job_id"
],
"properties": {
"scope": {
"enum": [
"emails",
"all",
"filtered"
],
"type": "string",
"default": "emails",
"description": "'emails' is rows with a deliverable email, which is what usage is billed on. 'all' is every scraped row."
},
"format": {
"enum": [
"csv",
"xlsx"
],
"type": "string",
"default": "csv"
},
"job_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get a download link",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}How many Scraping Credits the organization has left to spend, and the largest single scrape this plan allows. Read max_rows_this_scrape before choosing a total_limit.
No parameters.
{
"name": "mapsdata_get_usage",
"title": "Check Scraping Credits",
"description": "How many Scraping Credits the organization has left to spend, and the largest single scrape this plan allows. Read max_rows_this_scrape before choosing a total_limit.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Check Scraping Credits",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}MapsData scrapes Google Maps businesses and their email addresses. A scrape's query must be an exact Google Maps category and its regions must be full names, so confirm both with mapsdata_search_categories and mapsdata_list_regions before starting one. Scrapes run for minutes to hours: start one, tell the user, and stop. Do not poll in a loop.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| max_reviews | integer | Skip businesses with more Google reviews. Omit it for no maximum. 0 keeps ONLY businesses with no reviews. |
| min_reviews | integer | Skip businesses with fewer Google reviews. Defaults to 0, no minimum. |
| total_limit * | integer | How many leads to scrape, in the unit limit_basis sets. Read max_rows_this_scrape from mapsdata_get_usage first: a larger request is reduced to the Scraping Credits left, not rejected. |
| max_emails_per_company | integer | Most emails kept per business. Defaults to 5 when omitted. |
{
"name": "mapsdata_start_scrape",
"title": "Start a scrape",
"description": "Start scraping Google Maps businesses and their emails. Returns IMMEDIATELY with a job id; the scrape itself takes 5 minutes to several hours.\n\nBefore 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.\n\nThis spends the organization's Scraping Credits (its lead allowance). Set dry_run to check a request against every rule without spending anything.\n\nmin_reviews, max_reviews and max_emails_per_company are optional. Pass them when the user asks for them. The response reports the filters that apply, including the default email cap.",
"inputSchema": {
"type": "object",
"required": [
"query",
"total_limit"
],
"properties": {
"query": {
"type": "string",
"description": "An exact Google Maps category, e.g. 'Plumber'. Verify it with mapsdata_search_categories first."
},
"cities": {
"type": "array",
"items": {
"type": "object",
"required": [
"city",
"state"
],
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string",
"description": "Full region name."
}
}
},
"description": "Named cities instead of whole regions."
},
"states": {
"type": "array",
"items": {
"type": "string"
},
"description": "Full region names, e.g. ['Texas']. Not abbreviations. Use this or cities, not both."
},
"country": {
"enum": [
"au",
"ca",
"uk",
"us"
],
"type": "string",
"default": "us"
},
"dry_run": {
"type": "boolean",
"default": false,
"description": "Validate against every rule and return the plan WITHOUT starting a scrape or spending quota."
},
"list_name": {
"type": "string",
"description": "Label for the list. Defaults to the query."
},
"limit_basis": {
"enum": [
"emails",
"rows"
],
"type": "string",
"description": "What total_limit counts. 'emails' stops once that many leads WITH an email are found; leads without one are still delivered and never billed. 'rows' stops at that many leads of any kind. Omit it for the organization's default, which is 'emails' unless the organization used the API before this option launched."
},
"max_reviews": {
"type": "integer",
"minimum": 0,
"description": "Skip businesses with more Google reviews. Omit it for no maximum. 0 keeps ONLY businesses with no reviews."
},
"min_reviews": {
"type": "integer",
"minimum": 0,
"description": "Skip businesses with fewer Google reviews. Defaults to 0, no minimum."
},
"total_limit": {
"type": "integer",
"minimum": 1,
"description": "How many leads to scrape, in the unit limit_basis sets. Read max_rows_this_scrape from mapsdata_get_usage first: a larger request is reduced to the Scraping Credits left, not rejected."
},
"max_emails_per_company": {
"type": "integer",
"minimum": 1,
"description": "Most emails kept per business. Defaults to 5 when omitted."
}
}
},
"annotations": {
"title": "Start a scrape",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}