Mapsdata

Find and enrich local businesses from Google Maps with owners, emails, phones, websites, and more.

Should I use this

Quality & Safety

A
Description quality
98%
Schema completeness
91%
Naming quality
97%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,103Tokens (tool definitions)
~2.2 KBTypical response size
Significant attention impact (2.42% of 128k context)

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-http

What it can do

Tool inventory

Tools (12)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded12 tools