The Google Maps rank MCP server for local SEO

What it does

GeoGridAPI measures where a Google listing ranks on Google Maps for one keyword, on every point of a grid around it. The MCP server exposes the same engine as the REST API to your AI agent.

• One question, one map.

  “Where does Plomberie du Marais rank for plumber in Paris?” The agent calls find_business, then run_grid, then answers with the average rank, the points in the top 3 and where the listing drops off.

• Every point is a real Google Maps search.

  At each grid point, the keyword is searched on Google Maps from those coordinates, as a desktop search with no history, and the listing's position among the top 20 places is recorded (null = not in the top 20). Sponsored places are not counted.

• The map comes back as an image.

  A completed grid comes with the PNG heatmap, who ranks ahead and the change since the previous grid of the same map.

• Grid formats.

  Square 3 × 3, 5 × 5, 7 × 7 or 9 × 9, or circle, diamond, hexagon, cross, ellipse and rectangle (13 to 49 points), radius 0.5 to 30 km (1 to 30 km for non-square shapes). Points that fall in the sea are neither measured nor charged.

• Same credits as the console and the API.

  1 credit = 1 grid point (a 7 × 7 costs 49 credits). Only running grids spends credits, and a failed grid is refunded automatically.

The tools

The server exposes 13 tools and 6 ready-made prompts.

* find_business is free but needs a credit balance above zero, and is limited to 30 searches per minute per account. Test grids cost 0 credits.

Six ready-made prompts

In Claude, open the + menu, then GeoGridAPI; in Claude Code, use the /mcp__geogridapi__… commands. Each prompt asks for the listing and the keyword, states the price before running a grid, then answers in the keyword's language.

Install

https://api.geogridapi.io/mcp

https://api.geogridapi.io/mcp

claude mcp add --transport http geogridapi https://api.geogridapi.io/mcp

claude mcp add --transport http geogridapi https://api.geogridapi.io/mcp \
  --header "Authorization: Bearer gga_live_…"

{
  "mcpServers": {
    "geogridapi": {
      "url": "https://api.geogridapi.io/mcp",
      "headers": { "Authorization": "Bearer gga_live_…" }
    }
  }
}

{
  "mcpServers": {
    "geogridapi": {
      "command": "npx",
      "args": ["-y", "github:geogridapi/geogridapi-mcp"],
      "env": { "GEOGRIDAPI_API_KEY": "gga_live_…" }
    }
  }
}

Build for free with test keys

Create a gga_test_… key in the console and use it instead of gga_live_… in the Claude Code, Cursor or stdio config above. Your agent can call every tool, read a full grid object and the map image, and you spend 0 credits. Switch to a gga_live_ key when you are ready to measure real listings.

Test keys need a client that sends an API key header. The Claude and ChatGPT connectors sign in with OAuth and always run live grids.

claude mcp add --transport http geogridapi https://api.geogridapi.io/mcp \
  --header "Authorization: Bearer gga_test_…"

Example prompts

Copy these into Claude, ChatGPT or Cursor once the server is connected:

1. 1

   Where does Plomberie du Marais rank for plumber in Paris? Run a 9 × 9 grid.

   Copy
2. 2

   How much would a 7 × 7 grid for Joe's Pizza Broadway, New York on pizza cost? Don't run it yet.

   Copy
3. 3

   Run a circle grid, medium density, 3.5 km radius, for my listing on emergency plumber, then tell me who ranks ahead in the south-east.

   Copy
4. 4

   Run the same 5 × 5 grid for pizza, pizza delivery and pizza near me and compare the average ranks.

   Copy
5. 5

   Show me the ranking trend of my last grids for plumber and tell me if I improved.

   Copy
6. 6

   Rerun this grid every Monday.

   Copy
7. 7

   How many credits do I have left?

   Copy

FAQ