Do I need a paid plan for the MCP server?

Yes, live work requires an API entitlement plus an available cloud service — an Online subscription does not include MCP/API usage. A test credential is available to validate the integration with simulated fixtures at no cost.

How is API usage counted?

One accepted search request for one source page equals one API unit. Pre-admission validation, authentication, quota, and infrastructure denials are free; successful searches (including empty pages) use one unit, and failed searches release the reserved unit.

Can I try it without signing in?

Yes. The landing-page tool allows up to three admitted requests per UTC day per bound browser identity and network source, though abuse controls can deny a request before that limit is reached.

Can I export the data to CSV, Excel, or JSON files?

CSV, JSON, and Excel exports are features of the Online scraper plans (starting on paid tiers); the MCP server itself returns structured JSON directly to your agent.

Google Maps Scraper MCP Server — Connect your AI agent to Google Maps business data

G Maps Crawl offers a remote Model Context Protocol (MCP) server that lets AI agents search Google Maps business data and receive up to 20 businesses per synchronous search in structured JSON. Agents can retrieve available addresses, contact details, ratings, and review counts for prospecting research, local market analysis, and listing enrichment.

Key Features

Remote MCP server

Stateless Streamable HTTP endpoint at https://gmapscrawl.com/api/mcp with bearer API key authentication; /mcp remains a compatibility alias.

search_google_maps tool

Single exposed tool that finds businesses by keyword and location and returns available listing attributes, contact details, ratings, and review counts in structured JSON.

Up to 20 businesses per search

Each synchronous search returns up to 20 businesses directly to the agent, with a result shape that includes up to 10 review children and 20 photo/video metadata children where available.

Broad client compatibility

Works with MCP Inspector, Claude Code, Cursor, VS Code, Codex, and any client supporting remote HTTP MCP with custom authorization headers.

Test credentials with simulated fixtures

A test key lets you validate the integration with simulated data before committing to live API usage.

Usage-based API billing

One accepted search request for one source page is one API unit; pre-admission denials are free, and failed searches release the reserved unit.

How It Works

Search businesses

Find businesses by keyword and location, with listing details your agent can organize and analyze.

Retrieve listing data

Read available addresses, contact details, ratings, and review counts in structured result pages.

Use results directly

Receive up to 20 businesses in structured JSON for research and applications.

Pros & Cons

Pros

Simple setup: one endpoint and one Authorization header, with copy-paste configurations for Claude Code, Cursor, VS Code, and Codex
Returns structured JSON with names, websites, phone numbers, ratings, and review counts that agents can format into tables or analyze directly
Free test credential with simulated fixtures lets you verify the integration without live usage
Fair API accounting: authentication, quota, and infrastructure denials are free, and failed searches release the reserved unit
Server keeps secrets out of prompts by using bearer key authentication via environment variables

Cons

Who It's For

Best for

Developers wiring Google Maps business lookups into Claude Code, Cursor, VS Code, or Codex workflows
Sales teams using AI agents for local prospecting research and outreach list building
Analysts comparing categories, ratings, and review counts across local business datasets
Teams enriching CRM, reporting, or internal workflows with business and contact fields

Not ideal for

Large-scale bulk scraping where you need thousands of records in one job rather than 20 per synchronous search
Clients that cannot handle remote HTTP MCP with custom auth headers or that require OAuth sign-in

Use Cases

Prospecting research: build a focused list of local businesses for sales research and outreach planning

Local market analysis: compare categories, ratings, and review counts across businesses in your dataset

Listing enrichment: bring available business and contact fields into CRM, reporting, or internal workflows

Pricing

Self-serve plans run from Free ($0/month, 1,000 records) to Professional ($149/month, 500,000 records), with Enterprise custom-priced; prices are monthly in USD and exclude tax, with a seven-day guarantee on self-serve purchases. Note that live MCP work requires an API entitlement and does not come included with an Online subscription — MCP shares API usage, billed at one unit per accepted search

Free

$0/month

1,000 records/month, up to 2 keywords per task, basic business information and phone numbers. Excludes email & social media, custom export fields, CSV/Excel/JSON, and priority support.

Lite

$19/month

20,000 records/month, up to 5 keywords per task, with email & social media, custom export fields, CSV/Excel/JSON, and priority support included.

Basic

$49/month

80,000 records/month, up to 10 keywords per task, with email & social media, custom export fields, CSV/Excel/JSON, and priority support included.

Best for High Volume Growth

$99/month

250,000 records/month, up to 20 keywords per task, with email & social media, custom export fields, CSV/Excel/JSON, and priority support included.

Professional

$149/month

500,000 records/month, up to 50 keywords per task, with email & social media, custom export fields, CSV/Excel/JSON, and priority support included.

FAQ

What is the Google Maps Scraper MCP server?

It is a remote Model Context Protocol server that lets compatible AI agents search for up to 20 businesses per synchronous search and receive structured results directly, using your API-workspace credentials.

How do I connect and authenticate?

Point your client at POST https://gmapscrawl.com/api/mcp using stateless Streamable HTTP, and pass your API key as Authorization: Bearer in the header. Keys should live in a secure environment variable — never in a prompt or URL, and browser login cookies do not authenticate this endpoint.

Which clients are supported?

MCP Inspector, Claude Code, Cursor, VS Code, and Codex are supported, along with any client that supports remote HTTP MCP and custom authorization headers. There is no OAuth sign-in option.

What data can my agent retrieve?

Google Maps Scraper MCP Server