Google Maps Scraper

Connect Claude, Cursor, Codex, or other MCP clients to GMaps Lead Finder through a remote MCP endpoint with Bearer authentication, documented tools, and usage limits.

Hosted MCP Server

npx add-mcp 'https://gmapsleadfinder.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Agent API & MCP

Connect Claude, Cursor, Codex, or any MCP client to GMaps Lead Finder over HTTPS. For install-first marketing and example prompts, see Agents. Prefer Remote MCP here; use the HTTP API reference when you need raw endpoints.

Your personal key starts with gmf_. Pass it from the client—it is not a server-wide secret. Plans that include API are listed on Pricing. Open Account → API key

Endpoint & authorization

Remote MCP is Streamable HTTP. Point your client at the URL below and send your gmf_ key in the Authorization header on every request.

Endpoint

https://gmapsleadfinder.com/mcp

Authorization

Authorization: Bearer gmf_<your_key>

Tools: gmaps_me, gmaps_create_job, gmaps_get_job, gmaps_get_results, gmaps_create_reviews_job, gmaps_get_reviews_job, gmaps_get_reviews_results, gmaps_create_photos_job, gmaps_get_photos_job, gmaps_get_photos_results.

Hosted at https://gmapsleadfinder.com/mcp. Add it once; Claude, Cursor, Codex, Claude Desktop, and other MCP clients call tools over HTTPS with your key.

Sign in to generate a personal gmf_ key and personalize this install command. Sign in

Commands below use gmf_YOUR_API_KEY until your key is available. After sign-in, open Account → API key to copy your gmf_ key.

claude mcp add --transport http gmaps-finder https://gmapsleadfinder.com/mcp \
  --header "Authorization: Bearer gmf_YOUR_API_KEY"

HTTP API

Need REST instead of MCP? Use Bearer gmf_… against /api/v1. Full request and response details are in the HTTP API reference.

API and Online (leads, reviews, and photos) share one running job per user (HTTP 409 if busy).

Limits & errors

One keyword per leads job; one place per reviews or photos job. Maps, reviews, and photos share one in-flight job (409 if busy). Respect credit balance from /me. Unauthorized or ineligible keys return 401/403—confirm your plan on Pricing and regenerate keys in Account if needed.

OpenAPI

Machine-readable stub available at /openapi-agent.yaml.

/openapi-agent.yaml