Mapsdata
Find and enrich local businesses from Google Maps with owners, emails, phones, websites, and more.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mapsdata": {
"url": "https://www.mapsdata.io/mcp"
}
}
}Remote endpoints
https://www.mapsdata.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢check_account
Return the current plan, available lead credits, per-search limit, and active jobs. Call this before any credit-spending search or enrichment.
Input Schema
{
"type": "object",
"properties": {},
"title": "check_accountArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "check_accountDictOutput"
}🟢find_locations(query, country_code)
Resolve a city or region to Mapsdata's canonical location label. Use the returned label and country_code when calling search_businesses. Does not use credits.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "City, state, region, or country name to resolve.",
"maxLength": 100,
"minLength": 2,
"title": "Query",
"type": "string"
},
"country_code": {
"anyOf": [
{
"pattern": "^[A-Z]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional ISO country code.",
"title": "Country Code"
}
},
"required": [
"query"
],
"title": "find_locationsArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "find_locationsDictOutput"
}🟢find_categories(query)
Find canonical Google business category names for a niche. Use display_name as the search query when an exact category is appropriate. Does not use credits.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Business niche or category name to match.",
"maxLength": 100,
"minLength": 2,
"title": "Query",
"type": "string"
}
},
"required": [
"query"
],
"title": "find_categoriesArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "find_categoriesDictOutput"
}🔴search_businesses(query, location, max_results, confirmed_credit_cost, idempotency_key, ...)
Start one asynchronous Google Maps business search in one canonical location. This uses Pay on Find. First call check_account and find_locations, tell the user the maximum cost for all enabled contact outputs, capped by the available balance, and note that starting an enriched run requires at least 1 credit per requested business during a trial or 1.5 credits per requested business on a paid plan. obtain confirmation. Use one stable idempotency_key for retries.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Business niche or search term.",
"maxLength": 300,
"minLength": 1,
"title": "Query",
"type": "string"
},
"location": {
"description": "Canonical location label returned by find_locations.",
"maxLength": 300,
"minLength": 1,
"title": "Location",
"type": "string"
},
"max_results": {
"description": "Maximum businesses to return. Pay-on-Find charges only successful outputs.",
"maximum": 700,
"minimum": 100,
"title": "Max Results",
"type": "integer"
},
"confirmed_credit_cost": {
"description": "The maximum Pay-on-Find credit cost the user approved.",
"minimum": 0,
"title": "Confirmed Credit Cost",
"type": "integer"
},
"idempotency_key": {
"description": "Stable unique key to make retries safe.",
"maxLength": 64,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"title": "Idempotency Key",
"type": "string"
},
"country_code": {
"anyOf": [
{
"pattern": "^[A-Z]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO country code from find_locations.",
"title": "Country Code"
},
"language": {
"default": "en",
"description": "Language code for Google Maps results.",
"pattern": "^[a-z]{2,3}(-[A-Za-z]{2,4})?$",
"title": "Language",
"type": "string"
},
"enrich_contacts": {
"default": true,
"description": "Whether to enrich listings with contact and owner data.",
"title": "Enrich Contacts",
"type": "boolean"
},
"expand_nearby": {
"default": true,
"description": "Whether to search nearby map areas for additional matches.",
"title": "Expand Nearby",
"type": "boolean"
},
"name": {
"anyOf": [
{
"maxLength": 200,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional display name for the job.",
"title": "Name"
}
},
"required": [
"query",
"location",
"max_results",
"confirmed_credit_cost",
"idempotency_key"
],
"title": "search_businessesArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "search_businessesDictOutput"
}🟢list_searches(scope, page, page_size)
List this account's discovery searches, newest first, including searches created in the Mapsdata dashboard, REST API, and MCP. Use scope to narrow the source. Does not use credits.
Input Schema
{
"type": "object",
"properties": {
"scope": {
"default": "all",
"description": "Where the job was created: all sources, the Mapsdata dashboard, or an integration (REST API or MCP).",
"enum": [
"all",
"dashboard",
"integration"
],
"title": "Scope",
"type": "string"
},
"page": {
"default": 1,
"description": "One-based results page number.",
"minimum": 1,
"title": "Page",
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Jobs to return per page.",
"maximum": 100,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
},
"title": "list_searchesArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "list_searchesDictOutput"
}🟢search_status(lead_list_id)
Get progress and credit usage for one discovery search. Does not use credits.
Input Schema
{
"type": "object",
"properties": {
"lead_list_id": {
"description": "Discovery search job ID.",
"format": "uuid",
"title": "Lead List Id",
"type": "string"
}
},
"required": [
"lead_list_id"
],
"title": "search_statusArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "search_statusDictOutput"
}🟢get_search_results(lead_list_id, page, page_size)
Return one page of enriched businesses already found by a discovery search. Results may be read while the job is running. Continue while has_more is true, then fetch all pages once more after the job reaches completed. Does not use credits.
Input Schema
{
"type": "object",
"properties": {
"lead_list_id": {
"description": "Discovery search job ID.",
"format": "uuid",
"title": "Lead List Id",
"type": "string"
},
"page": {
"default": 1,
"description": "One-based results page number.",
"minimum": 1,
"title": "Page",
"type": "integer"
},
"page_size": {
"default": 50,
"description": "Businesses to return per page.",
"maximum": 100,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
},
"required": [
"lead_list_id"
],
"title": "get_search_resultsArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "get_search_resultsDictOutput"
}🟢get_business(business_id)
Get one complete business record by the business ID returned in a search or enrichment result page. Does not use credits.
Input Schema
{
"type": "object",
"properties": {
"business_id": {
"description": "Business ID returned by a search or enrichment result page.",
"format": "uuid",
"title": "Business Id",
"type": "string"
}
},
"required": [
"business_id"
],
"title": "get_businessArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "get_businessDictOutput"
}🔴enrich_businesses(businesses, confirmed_credit_cost, idempotency_key, name, country_code, ...)
Start asynchronous contact enrichment for businesses the user already has. This uses Pay on Find. First call check_account, calculate and state the maximum cost for the selected outputs, and obtain confirmation. The ceiling is the lower of available credits and business count times the selected per-business costs (business email 1, owner email 2, owner phone 5). Starting the job requires at least 1 credit per business during a trial or 1.5 credits per business on a paid plan. Use one stable idempotency_key for retries.
Input Schema
{
"type": "object",
"properties": {
"businesses": {
"description": "Businesses to enrich. Each needs a Google Maps URL, Place ID, or both a business name and website URL. Prefer name and website when available; they become the canonical identity and Maps identifiers remain optional fallback metadata.",
"items": {
"$ref": "#/$defs/EnrichmentBusiness"
},
"maxItems": 700,
"minItems": 1,
"title": "Businesses",
"type": "array"
},
"confirmed_credit_cost": {
"description": "Maximum Pay-on-Find credit cost the user explicitly approved.",
"minimum": 0,
"title": "Confirmed Credit Cost",
"type": "integer"
},
"idempotency_key": {
"description": "Stable unique key to make retries safe.",
"maxLength": 64,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"title": "Idempotency Key",
"type": "string"
},
"name": {
"anyOf": [
{
"maxLength": 200,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional display name for the job.",
"title": "Name"
},
"country_code": {
"anyOf": [
{
"maxLength": 2,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Default ISO country code. Required only when a business is supplied by name and website without a Maps URL or Place ID. Recommended whenever name and website are supplied so Mapsdata can skip Maps resolution.",
"title": "Country Code"
},
"business_emails": {
"default": true,
"description": "Find public business inboxes such as info@ and contact@.",
"title": "Business Emails",
"type": "boolean"
},
"owner_emails": {
"default": true,
"description": "Find owner and decision-maker emails.",
"title": "Owner Emails",
"type": "boolean"
},
"owner_phones": {
"default": true,
"description": "Find direct owner and decision-maker phone numbers.",
"title": "Owner Phones",
"type": "boolean"
}
},
"required": [
"businesses",
"confirmed_credit_cost",
"idempotency_key"
],
"$defs": {
"EnrichmentBusiness": {
"additionalProperties": false,
"properties": {
"business_name": {
"anyOf": [
{
"description": "Public business name to enrich.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Business Name"
},
"website_url": {
"anyOf": [
{
"maxLength": 2048,
"minLength": 8,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public HTTP(S) business website to inspect. When business_name is also supplied, that pair is the canonical identity and takes precedence over Maps identifiers.",
"title": "Website Url"
},
"google_maps_url": {
"anyOf": [
{
"maxLength": 4096,
"minLength": 12,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Google Maps listing URL, including maps.app.goo.gl short links. Used to resolve Maps-only rows or infer missing location evidence.",
"title": "Google Maps Url"
},
"place_id": {
"anyOf": [
{
"maxLength": 256,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Google Place ID used to resolve a Maps-only row or missing location evidence.",
"title": "Place Id"
}
},
"title": "EnrichmentBusiness",
"type": "object"
}
},
"title": "enrich_businessesArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "enrich_businessesDictOutput"
}🟢list_enrichments(scope, page, page_size)
List this account's supplied-business enrichment jobs, newest first. Use scope to narrow the source. Does not use credits.
Input Schema
{
"type": "object",
"properties": {
"scope": {
"default": "all",
"description": "Where the job was created: all sources, the Mapsdata dashboard, or an integration (REST API or MCP).",
"enum": [
"all",
"dashboard",
"integration"
],
"title": "Scope",
"type": "string"
},
"page": {
"default": 1,
"description": "One-based results page number.",
"minimum": 1,
"title": "Page",
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Jobs to return per page.",
"maximum": 100,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
},
"title": "list_enrichmentsArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "list_enrichmentsDictOutput"
}🟢enrichment_status(job_id)
Get progress and credit usage for a supplied-business enrichment job. Does not use credits.
Input Schema
{
"type": "object",
"properties": {
"job_id": {
"description": "Supplied-business enrichment job ID.",
"format": "uuid",
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "enrichment_statusArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "enrichment_statusDictOutput"
}🟢get_enrichment_results(job_id, page, page_size)
Return one page of supplied-business enrichment results. Continue while has_more is true and fetch all pages again after completion. Does not use credits.
Input Schema
{
"type": "object",
"properties": {
"job_id": {
"description": "Supplied-business enrichment job ID.",
"format": "uuid",
"title": "Job Id",
"type": "string"
},
"page": {
"default": 1,
"description": "One-based results page number.",
"minimum": 1,
"title": "Page",
"type": "integer"
},
"page_size": {
"default": 50,
"description": "Businesses to return per page.",
"maximum": 100,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
},
"required": [
"job_id"
],
"title": "get_enrichment_resultsArguments"
}Output Schema
{
"type": "object",
"additionalProperties": true,
"title": "get_enrichment_resultsDictOutput"
}Community
Evidence