Mapsdata is an MCP server published by io.github.Mapsdata-io, hosted at www.mapsdata.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 12 tools, including check_account, find_locations, find_categories, search_businesses, list_searches.
Find and enrich local businesses from Google Maps with owners, emails, phones, websites, and more.
905 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Return the current plan, available lead credits, per-search limit, and active jobs. Call this before any credit-spending search or enrichment.
No parameters.
{
"name": "check_account",
"title": "Check Mapsdata account and credits",
"description": "Return the current plan, available lead credits, per-search limit, and active jobs. Call this before any credit-spending search or enrichment.",
"inputSchema": {
"type": "object",
"title": "check_accountArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "check_accountDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Check Mapsdata account and credits",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
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.
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.
| Parameter | Type | Description |
|---|---|---|
| query * | string | City, state, region, or country name to resolve. |
| country_code | any | Optional ISO country code. |
{
"name": "find_locations",
"title": "Find Mapsdata locations",
"description": "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.",
"inputSchema": {
"type": "object",
"title": "find_locationsArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query",
"maxLength": 100,
"minLength": 2,
"description": "City, state, region, or country name to resolve."
},
"country_code": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{2}$"
},
{
"type": "null"
}
],
"title": "Country Code",
"default": null,
"description": "Optional ISO country code."
}
}
},
"outputSchema": {
"type": "object",
"title": "find_locationsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find Mapsdata locations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Business niche or category name to match. |
{
"name": "find_categories",
"title": "Find Mapsdata business categories",
"description": "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.",
"inputSchema": {
"type": "object",
"title": "find_categoriesArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query",
"maxLength": 100,
"minLength": 2,
"description": "Business niche or category name to match."
}
}
},
"outputSchema": {
"type": "object",
"title": "find_categoriesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find Mapsdata business categories",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name | any | Optional display name for the job. |
| query * | string | Business niche or search term. |
| language | string | Language code for Google Maps results. |
| location * | string | Canonical location label returned by find_locations. |
| max_results * | integer | Maximum businesses to return. Pay-on-Find charges only successful outputs. |
| country_code | any | ISO country code from find_locations. |
| expand_nearby | boolean | Whether to search nearby map areas for additional matches. |
| enrich_contacts | boolean | Whether to enrich listings with contact and owner data. |
| idempotency_key * | string | Stable unique key to make retries safe. |
| confirmed_credit_cost * | integer | The maximum Pay-on-Find credit cost the user approved. |
{
"name": "search_businesses",
"title": "Find and enrich local businesses",
"description": "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.",
"inputSchema": {
"type": "object",
"title": "search_businessesArguments",
"required": [
"query",
"location",
"max_results",
"confirmed_credit_cost",
"idempotency_key"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Name",
"default": null,
"description": "Optional display name for the job."
},
"query": {
"type": "string",
"title": "Query",
"maxLength": 300,
"minLength": 1,
"description": "Business niche or search term."
},
"language": {
"type": "string",
"title": "Language",
"default": "en",
"pattern": "^[a-z]{2,3}(-[A-Za-z]{2,4})?$",
"description": "Language code for Google Maps results."
},
"location": {
"type": "string",
"title": "Location",
"maxLength": 300,
"minLength": 1,
"description": "Canonical location label returned by find_locations."
},
"max_results": {
"type": "integer",
"title": "Max Results",
"maximum": 700,
"minimum": 100,
"description": "Maximum businesses to return. Pay-on-Find charges only successful outputs."
},
"country_code": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{2}$"
},
{
"type": "null"
}
],
"title": "Country Code",
"default": null,
"description": "ISO country code from find_locations."
},
"expand_nearby": {
"type": "boolean",
"title": "Expand Nearby",
"default": true,
"description": "Whether to search nearby map areas for additional matches."
},
"enrich_contacts": {
"type": "boolean",
"title": "Enrich Contacts",
"default": true,
"description": "Whether to enrich listings with contact and owner data."
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"pattern": "^[A-Za-z0-9._:-]+$",
"maxLength": 64,
"minLength": 8,
"description": "Stable unique key to make retries safe."
},
"confirmed_credit_cost": {
"type": "integer",
"title": "Confirmed Credit Cost",
"minimum": 0,
"description": "The maximum Pay-on-Find credit cost the user approved."
}
}
},
"outputSchema": {
"type": "object",
"title": "search_businessesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Find and enrich local businesses",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | One-based results page number. |
| scope | string | Where the job was created: all sources, the Mapsdata dashboard, or an integration (REST API or MCP). |
| page_size | integer | Jobs to return per page. |
{
"name": "list_searches",
"title": "List Mapsdata searches",
"description": "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.",
"inputSchema": {
"type": "object",
"title": "list_searchesArguments",
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"minimum": 1,
"description": "One-based results page number."
},
"scope": {
"enum": [
"all",
"dashboard",
"integration"
],
"type": "string",
"title": "Scope",
"default": "all",
"description": "Where the job was created: all sources, the Mapsdata dashboard, or an integration (REST API or MCP)."
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Jobs to return per page."
}
}
},
"outputSchema": {
"type": "object",
"title": "list_searchesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "List Mapsdata searches",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get progress and credit usage for one discovery search. Does not use credits.
| Parameter | Type | Description |
|---|---|---|
| lead_list_id * | string | Discovery search job ID. |
{
"name": "search_status",
"title": "Get search status",
"description": "Get progress and credit usage for one discovery search. Does not use credits.",
"inputSchema": {
"type": "object",
"title": "search_statusArguments",
"required": [
"lead_list_id"
],
"properties": {
"lead_list_id": {
"type": "string",
"title": "Lead List Id",
"format": "uuid",
"description": "Discovery search job ID."
}
}
},
"outputSchema": {
"type": "object",
"title": "search_statusDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Get search status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | One-based results page number. |
| page_size | integer | Businesses to return per page. |
| lead_list_id * | string | Discovery search job ID. |
{
"name": "get_search_results",
"title": "Get search results",
"description": "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.",
"inputSchema": {
"type": "object",
"title": "get_search_resultsArguments",
"required": [
"lead_list_id"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"minimum": 1,
"description": "One-based results page number."
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Businesses to return per page."
},
"lead_list_id": {
"type": "string",
"title": "Lead List Id",
"format": "uuid",
"description": "Discovery search job ID."
}
}
},
"outputSchema": {
"type": "object",
"title": "get_search_resultsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Get search results",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one complete business record by the business ID returned in a search or enrichment result page. Does not use credits.
| Parameter | Type | Description |
|---|---|---|
| business_id * | string | Business ID returned by a search or enrichment result page. |
{
"name": "get_business",
"title": "Get one business",
"description": "Get one complete business record by the business ID returned in a search or enrichment result page. Does not use credits.",
"inputSchema": {
"type": "object",
"title": "get_businessArguments",
"required": [
"business_id"
],
"properties": {
"business_id": {
"type": "string",
"title": "Business Id",
"format": "uuid",
"description": "Business ID returned by a search or enrichment result page."
}
}
},
"outputSchema": {
"type": "object",
"title": "get_businessDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Get one business",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name | any | Optional display name for the job. |
| businesses * | array | 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. |
| country_code | any | 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. |
| owner_emails | boolean | Find owner and decision-maker emails. |
| owner_phones | boolean | Find direct owner and decision-maker phone numbers. |
| business_emails | boolean | Find public business inboxes such as info@ and contact@. |
| idempotency_key * | string | Stable unique key to make retries safe. |
| confirmed_credit_cost * | integer | Maximum Pay-on-Find credit cost the user explicitly approved. |
{
"name": "enrich_businesses",
"title": "Enrich supplied businesses",
"description": "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.",
"inputSchema": {
"type": "object",
"$defs": {
"EnrichmentBusiness": {
"type": "object",
"title": "EnrichmentBusiness",
"properties": {
"place_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9._:-]+$",
"maxLength": 256,
"minLength": 8
},
{
"type": "null"
}
],
"title": "Place Id",
"default": null,
"description": "Google Place ID used to resolve a Maps-only row or missing location evidence."
},
"website_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"minLength": 8
},
{
"type": "null"
}
],
"title": "Website Url",
"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."
},
"business_name": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Public business name to enrich."
},
{
"type": "null"
}
],
"title": "Business Name",
"default": null
},
"google_maps_url": {
"anyOf": [
{
"type": "string",
"maxLength": 4096,
"minLength": 12
},
{
"type": "null"
}
],
"title": "Google Maps Url",
"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."
}
},
"additionalProperties": false
}
},
"title": "enrich_businessesArguments",
"required": [
"businesses",
"confirmed_credit_cost",
"idempotency_key"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Name",
"default": null,
"description": "Optional display name for the job."
},
"businesses": {
"type": "array",
"items": {
"$ref": "#/$defs/EnrichmentBusiness"
},
"title": "Businesses",
"maxItems": 700,
"minItems": 1,
"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."
},
"country_code": {
"anyOf": [
{
"type": "string",
"maxLength": 2,
"minLength": 2
},
{
"type": "null"
}
],
"title": "Country Code",
"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."
},
"owner_emails": {
"type": "boolean",
"title": "Owner Emails",
"default": true,
"description": "Find owner and decision-maker emails."
},
"owner_phones": {
"type": "boolean",
"title": "Owner Phones",
"default": true,
"description": "Find direct owner and decision-maker phone numbers."
},
"business_emails": {
"type": "boolean",
"title": "Business Emails",
"default": true,
"description": "Find public business inboxes such as info@ and contact@."
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"pattern": "^[A-Za-z0-9._:-]+$",
"maxLength": 64,
"minLength": 8,
"description": "Stable unique key to make retries safe."
},
"confirmed_credit_cost": {
"type": "integer",
"title": "Confirmed Credit Cost",
"minimum": 0,
"description": "Maximum Pay-on-Find credit cost the user explicitly approved."
}
}
},
"outputSchema": {
"type": "object",
"title": "enrich_businessesDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Enrich supplied businesses",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}List this account's supplied-business enrichment jobs, newest first. Use scope to narrow the source. Does not use credits.
| Parameter | Type | Description |
|---|---|---|
| page | integer | One-based results page number. |
| scope | string | Where the job was created: all sources, the Mapsdata dashboard, or an integration (REST API or MCP). |
| page_size | integer | Jobs to return per page. |
{
"name": "list_enrichments",
"title": "List Mapsdata enrichment jobs",
"description": "List this account's supplied-business enrichment jobs, newest first. Use scope to narrow the source. Does not use credits.",
"inputSchema": {
"type": "object",
"title": "list_enrichmentsArguments",
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"minimum": 1,
"description": "One-based results page number."
},
"scope": {
"enum": [
"all",
"dashboard",
"integration"
],
"type": "string",
"title": "Scope",
"default": "all",
"description": "Where the job was created: all sources, the Mapsdata dashboard, or an integration (REST API or MCP)."
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Jobs to return per page."
}
}
},
"outputSchema": {
"type": "object",
"title": "list_enrichmentsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "List Mapsdata enrichment jobs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get progress and credit usage for a supplied-business enrichment job. Does not use credits.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | Supplied-business enrichment job ID. |
{
"name": "enrichment_status",
"title": "Get enrichment status",
"description": "Get progress and credit usage for a supplied-business enrichment job. Does not use credits.",
"inputSchema": {
"type": "object",
"title": "enrichment_statusArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id",
"format": "uuid",
"description": "Supplied-business enrichment job ID."
}
}
},
"outputSchema": {
"type": "object",
"title": "enrichment_statusDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Get enrichment status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | One-based results page number. |
| job_id * | string | Supplied-business enrichment job ID. |
| page_size | integer | Businesses to return per page. |
{
"name": "get_enrichment_results",
"title": "Get enrichment results",
"description": "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.",
"inputSchema": {
"type": "object",
"title": "get_enrichment_resultsArguments",
"required": [
"job_id"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"minimum": 1,
"description": "One-based results page number."
},
"job_id": {
"type": "string",
"title": "Job Id",
"format": "uuid",
"description": "Supplied-business enrichment job ID."
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Businesses to return per page."
}
}
},
"outputSchema": {
"type": "object",
"title": "get_enrichment_resultsDictOutput",
"additionalProperties": true
},
"annotations": {
"title": "Get enrichment results",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use check_account before a credit-spending call. Resolve locations with find_locations. Pay on Find maximum cost depends on selected outputs and is capped by the current balance. For supplied-business enrichment, prefer business name plus website and include the country code when known; use a Maps URL or Place ID as fallback identity. An enriched run needs at least 1 available credit per requested business during a trial or 1.5 available credits per requested business on a paid plan. Before search_businesses or enrich_businesses, state that maximum credit cost and obtain the user's confirmation; pass that exact amount as confirmed_credit_cost. Poll jobs to a terminal state and paginate results. Never repeat a creation call with a new idempotency key merely because a response timed out.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.