# GBP Peak [Verified owner] [Health: Active]

**Category:** 🗺️ Location Services  
**Repository:** https://github.com/Peakdrum/gbppeak-mcp  
**GitHub Stars:** 1  
**Views:** 7  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gbp-peak

## Description
Google Maps geo-grid rank scanning for local SEO. Run scans, read rank maps and competitor stats, check rank at any place, research local keywords. Tools: list_analyses, find_keywords, list_scans, suggest_keywords, keyword_graph_url, get_rank_map, rank_at_point, trigger_scan. Bridges to the hosted GBP Peak MCP endpoint with a bearer API token.

## Tools
Capabilities this server exposes over MCP:

- **list_analyses** — Your GBP Peak keyword analyses (businesses)
- **find_keywords** — Local keyword research — measured demand × competition × intent scoring
- **list_scans** — Geo-grid rank scans for one keyword or location
- **suggest_keywords** — Generate new keyword candidates from a seed + research prompt
- **keyword_graph_url** — Interactive keyword relationship graph for an analysis
- **get_rank_map** — Full geo-grid rank map: stats, competitors, PNG map image
- **rank_at_point** — "What's my rank at <place>?" — geocodes a place and reads the nearest grid point
- **trigger_scan** — Run a new geo-grid scan (costs scan points, `confirm: true` required)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "gbp-peak": {
    "command": "npx",
    "args": ["-y","gbppeak-mcp"],
    "env": {
      "GBPPEAK_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `GBPPEAK_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What the GBP Peak MCP server does

The GBP Peak MCP server gives MCP-compatible AI clients access to a GBP Peak account through a local stdio bridge. GBP Peak measures Google Maps visibility across geographic grids rather than reducing a business to one city-wide rank. The available data includes keyword analyses, scan results, competitor information, rank history, and visibility in AI answer engines such as ChatGPT, Gemini, and Perplexity.

The bridge connects to the hosted MCP endpoint at `https://gbppeak.com/api/mcp`. Authentication uses a bearer-style API token, and the tools operate within the associated GBP Peak account. The package does not run the scanning service locally; it forwards MCP requests to the hosted service.

## How it works

Install and run the package as an stdio process. The MCP client starts it with `npx`, passes the account token through the environment, and communicates with the hosted endpoint through the bridge. A single token is used for both the REST API and MCP access.

Rank data is organized around analyses, keywords, locations, and geo-grid scans. A scan can cover a grid of up to 50 by 50 points. To answer a question about a particular place, the rank lookup tool geocodes the place and reads the closest available grid point. Starting a new scan is an account-affecting operation: it consumes scan points and requires explicit confirmation.

## Setup and configuration

Obtain an API token from GBP Peak under Settings → AI access. Add the package to an MCP client configuration with the `gbppeak-mcp` npm package and set `GBPPEAK_TOKEN` to the issued `gbpk_…` value.

The default destination is `https://gbppeak.com/api/mcp`. `GBPPEAK_URL` can override that address for a self-hosted instance. The repository describes the package as MIT licensed.

## Tools and capabilities

The GBP Peak MCP server exposes these operations:

- `list_analyses` retrieves the keyword analyses, representing tracked businesses.
- `find_keywords` researches local keywords using measured demand, competition, and intent scoring.
- `list_scans` lists geo-grid scans for a keyword or location.
- `suggest_keywords` proposes keyword candidates from a seed and research prompt.
- `keyword_graph_url` returns an interactive relationship graph URL for an analysis.
- `get_rank_map` retrieves grid statistics, competitor results, and a PNG map image.
- `rank_at_point` checks the rank nearest to a named place after geocoding it.
- `trigger_scan` starts a new geo-grid scan when `confirm: true` is supplied.

These tools fit workflows such as comparing local-pack performance across neighborhoods, finding terms for a local campaign, reviewing competitors, and checking a business's position at a specific place.

## Limitations and notes

The service requires a GBP Peak account and API token. Scan creation uses scan points, so agents should not invoke `trigger_scan` without the required confirmation and account capacity. Results depend on the scans and analyses available in the connected account. The bridge itself is stdio-based and relies on the hosted GBP Peak endpoint unless `GBPPEAK_URL` is changed.

_Full upstream README: https://allmcps.com/mcp/gbp-peak/readme_

