MapsScraper.dev

Research public business listings, reviews and photos into workspace lists, with explicit unit budgets and receipts.

Hosted MCP Server

npx add-mcp 'https://mapsscraper.dev/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Connect your workspace

Create a scoped API key in your workspace. Start with read-only access when you only need existing results.

Review a task estimate

Tell your agent the business query, maximum records and maximum workspace units. Inspect the estimate before execution.

Take the result with you

Read the summary, inspect data provenance, then export or organize your businesses in the web workspace.

Browser agents can use the free tools directly

In browsers with page-level WebMCP support, two free tools offer actions that agents can call:

Each action generates a result and updates the visible form and preview. These local actions need no workspace key and do not publish, open links, download files or send messages. Normal form controls work when the browser does not support WebMCP.

Use a client that supports authenticated HTTP MCP

The Google Maps MCP endpoint uses Streamable HTTP. Connect with a scoped workspace key as a bearer token, or from an OAuth-capable MCP client after verified-account and workspace consent. Claude Code, Codex and Cursor provide configurable MCP connections; this product’s platform-specific installation has not been certified. ChatGPT and Claude host acceptance and directory listings are not verified.

MCP client configuration (JSON)

{
  "mcpServers": {
    "mapsscraper": {
      "url": "https://mapsscraper.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WORKSPACE_KEY"
      }
    }
  }
}

Google Maps MCP tools that respect your workspace

Read

  • get_capabilities
  • get_account_usage
  • estimate_job
  • get_job
  • get_job_results
  • list_datasets
  • get_workspace_config
  • get_batch
  • read_list
  • read_report
  • list_workspace_records
  • read_monitor_runs
  • read_merge_receipt

Run (uses workspace units)

  • create_job
  • create_batch
  • cancel_job

Organize

  • create_list
  • save_business
  • qualify_business
  • create_report
  • find_matches
  • preview_merge
  • apply_reviewed_merge
  • undo_merge

Share

  • list_shares
  • create_reviewed_share
  • revoke_share

External business text is untrusted data. A tool response never authorizes spending, changing permissions, or sending messages. Budgets and workspace access are enforced on the server.

Set up your connection