# GridWhy

> GridWhy is an MCP server for maps and travel. Check Google Maps rank history, why it changed, and start grid scans from your AI. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $29 a month
- **Platforms:** Web, API
- **Website:** https://gridwhy.com/docs/mcp
- **MCP Registry name:** com.gridwhy/gridwhy
- **Categories:** maps and travel, marketing and SEO
- **Listing updated:** 2026-11-14

## About

Three tools make up the server. get_history lists locations, tracked keywords and their scans newest first, with how many grid points rank in the top 20 and top 3, average and best rank, a one-line what-changed and a report link. explain_change says why rankings moved between a scan and the one before it, covering coverage, competitors that rose or appeared, review velocity, rating and category or name changes, with a ready line to paste to the client and next steps. run_scan starts a grid scan for one tracked keyword, takes 15 to 30 seconds and counts against manual scan limits, though a keyword's first scan is free.

Claude and ChatGPT connect with OAuth and two permissions, read and scan; Claude Code, Cursor and scripts can use a gw_ API key instead. The same three operations exist over REST. Hourly call limits are 100 on Solo, 500 on Agency and 2,000 on Agency+, and scheduled scans are never limited by the API. The pitch is for consultants and small agencies who report on local rankings for clients.

## Features

- **Rank history:** Shows top-20 and top-3 grid counts, average and best rank per scan.
- **Change diagnosis:** Explains moves in coverage, competitors, reviews, rating and category.
- **On-demand scans:** run_scan starts a grid scan in 15 to 30 seconds.
- **Scoped OAuth:** Choose read and scan permissions when connecting.
- **REST parity:** The same three operations are available over a REST API.
- **Plan-based limits:** Hourly call and manual scan limits rise with each plan.

## Good for

- Ask which clients lost ground on Google Maps this week
- Write a client update explaining a ranking drop
- Trigger a fresh scan for one keyword before a call
- Script scans from CI with an API key

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gridwhy https://gridwhy.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gridwhy.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gridwhy": {
      "url": "https://gridwhy.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gridwhy": {
      "type": "http",
      "url": "https://gridwhy.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gridwhy": {
      "serverUrl": "https://gridwhy.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gridwhy": {
      "type": "http",
      "url": "https://gridwhy.com/mcp"
    }
  }
}
```

## Tools

- `get_history`: Locations, tracked keywords and scans, newest first, with rank counts and a what-changed line.
- `explain_change`: Why the ranking changed between a scan and the one before it, with findings and next steps.
- `run_scan`: Start a grid scan for one tracked keyword now.

## FAQ

### Is MCP included on every plan?

Yes, the docs say the MCP server is included on every plan, Solo too.

### How do I connect?

Paste https://gridwhy.com/mcp into Claude or ChatGPT and sign in, or use a gw_ API key as a Bearer header.

### Do scans cost extra?

Manual scans count against daily and 30-day allowances (5 and 30 on Solo); the first scan of a keyword is free and scheduled scans are not limited.

### What happens when a trial ends?

Connected apps get a clear error until you pick a plan.

### Is GridWhy free?

GridWhy is a paid product with a free trial. Paid plans start at $29 a month.

### How do I add GridWhy to Claude Code?

Run this command in your terminal: claude mcp add --transport http gridwhy https://gridwhy.com/mcp

### What are the best alternatives to GridWhy?

The closest alternatives to GridWhy are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Tutu eSIM, MCP and Red Center Studio free tools.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/gridwhy
