Built for your agent
From a search to a useful dataset.
Give your agent the same business data workflow you use in your workspace.
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.
How to connect
One endpoint, one auth header
Configure your client to use /api/mcp, then pass your API key in the authorization header.
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Accept: application/json, text/event-streamStreamable HTTP — your client handles protocol negotiation.
Bearer API key authentication — configure secrets outside prompts.
Connect your tools
Choose your MCP client
Keep your API key in a secure environment variable or your client’s protected input setting.
Add this server to .mcp.json. Make GMSCRAPER_API_KEY available in the environment that launches Claude Code.
{
"mcpServers": {
"google-maps-data": {
"type": "http",
"url": "https://gmapscrawl.com/api/mcp",
"headers": {
"Authorization": "Bearer ${GMSCRAPER_API_KEY}"
}
}
}
}Need step-by-step guidance? Read the MCP setup guide
Built for your workflow
Built for data-aware AI workflows
Move from a question to structured local business research without switching tools.
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 the businesses in your dataset.
Listing enrichment
Bring available business and contact fields into CRM, reporting, or internal workflows.
Put it to work
Example prompts to try
Try a focused request in your connected client. With a test key, ask your agent to label the results as simulated.
Prompt
“Find one page of coffee shops in Seattle and return their website, phone number, rating, and review count.”
Prompt
“Search for restaurants in Portland and compare the returned business categories and ratings. Point out missing data.”
Prompt
“Search one page of plumbers in Austin and format the returned businesses as a table with names, phone numbers, and websites.”
Frequently asked questions
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 and receive results directly using your API-workspace credentials.
Which MCP transport does it use?
The server uses stateless Streamable HTTP at https://gmapscrawl.com/api/mcp. /mcp remains a compatibility alias. Your client initializes the connection and negotiates the protocol version.
How do I authenticate the MCP server?
Configure Authorization: Bearer with your API key in the client’s secret configuration. Browser login cookies do not authenticate this endpoint, and keys should never go in a prompt or URL.
Can I connect Claude Code, Cursor, VS Code, or Codex?
Yes, with a version that supports remote HTTP MCP and custom authorization headers. Use the client configurations above and ensure the configured environment variable is available to that client.
What Google Maps data can my agent retrieve?
Business searches return available listing attributes, contact details, ratings, and review counts. The server exposes only search_google_maps.
Do I need an API plan?
Live work requires an API entitlement and an available cloud service. MCP shares API usage; an Online subscription does not include it. Use a test credential to validate the integration with simulated fixtures.
Take the next step
Give your AI agent Google Maps data.
Create an API key, connect the MCP server, and bring business research into your preferred client.