GBP Peak

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.