GBP Peak logo

GBP Peak

GBP Peak MCP server connects AI agents to Google Maps geo-grid rank scans and local SEO research.

Install GBP Peak

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gbp-peak": {
      "command": "npx",
      "args": [
        "-y",
        "gbppeak-mcp"
      ],
      "env": {
        "GBPPEAK_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

npx -y gbppeak-mcp

404 npm error 404 'gbppeak-mcp@*' is not in this registry. npm error 404 npm error 404 Note that you can also install from a npm error 404 tarball, folder, http url, or git url. npm notice npm notice New major version of npm available! 10.9.9 -> 12.2.2 npm notice Changelog: https://github.com/npm/cli/releases/tag/v12.2.2 npm notice To update run: npm install -g npm@12.2.2 npm notice npm error A complete log of this run can be found in: /home/user/.npm/_logs/2026-11-08T13_10_12_050Z-debug-0.log

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked .

Overview

The GBP Peak MCP server bridges stdio MCP clients to the hosted GBP Peak endpoint for Google Maps rank scanning and local SEO research. It authenticates with a GBP Peak API token and exposes tools for keyword research, scan retrieval, rank maps, point checks, and scan creation. Use it when an agent needs location-specific local-pack rankings, competitor data, or keyword analysis from a GBP Peak account.

Use cases

  • Check Google Maps rank across a local geo-grid
  • Research local keywords by demand and competition
  • Compare competitors in a rank map
  • Ask for rank at a specific place
  • Start a confirmed geo-grid scan

Key features

  • Google Maps geo-grid rank scanning
  • Local keyword research and suggestions
  • Competitor statistics and PNG rank maps
  • Place-based nearest-grid rank checks
  • Interactive keyword relationship graphs
  • Hosted MCP endpoint with bearer token authentication

Tools8

What GBP Peak lets your agent do. Expand a tool for its parameters.

Self-reported~147 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

12/12 checks healthy over the last 45d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · gbppeak-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Tools exposed8Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How GBP Peak works

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.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about GBP Peak

GBP Peak is an MCP server that connects AI agents to the hosted GBP Peak endpoint and Google Maps local SEO data. Its main tools list analyses and scans, research and suggest keywords, create keyword graph URLs, retrieve rank maps, check rank at places, and trigger geo-grid scans.

Install it through an MCP client configuration using `npx -y gbppeak-mcp`. Set the `GBPPEAK_TOKEN` environment variable to a token from GBP Peak Settings → AI access, then start the client so it can launch the stdio bridge.

GBP Peak works with Claude Desktop, Claude Code, Cursor, Windsurf, and Cline. The repository describes the package as a stdio bridge usable by stdio MCP clients.

Use the `rank_at_point` tool with a place. It geocodes the supplied place and reads the nearest point from the relevant geo-grid data, allowing an agent to answer a location-specific ranking question.

Yes, `trigger_scan` costs scan points and requires `confirm: true`. Agents should only call it when the user intends to create a new geo-grid scan and the connected GBP Peak account has available scan capacity.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGBP Peak AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gbp-peak?style=directory)](https://allmcps.com/mcp/gbp-peak)
HTML Embed
<a href="https://allmcps.com/mcp/gbp-peak"><img src="https://allmcps.com/api/badge/gbp-peak?style=directory" alt="GBP Peak on AllMCPs" /></a>