BrightEdge MCP

MCP Server Documentation for Claude

Setup guide, tool reference, and troubleshooting

1. Overview

BrightEdge MCP enables AI agents and assistants to access BrightEdge's data and APIs directly. By connecting your preferred AI tool to BrightEdge via MCP (Model Context Protocol), you can query keyword rankings, traffic data, competitor insights, and more — without leaving your AI workflow. MCP is an open standard for securely connecting AI tools to third-party services. BrightEdge hosts a managed MCP server, so no local installation is required.

Once connected, you can ask questions about your organic search performance in plain language and receive data directly from your account — covering keyword rankings, Google Search Console metrics, Share of Voice, competitor comparisons, and AI Overview citation opportunities.

What this connector does

Retrieves read-only data from your connected BrightEdge account. It does not write to, modify, or configure any BrightEdge settings or data. All data is scoped to your authenticated account.

Data sources

Source	What it covers	Requires
GSC	Google Search Console — actual clicks, impressions, CTR, and position from Google	GSC connected to BrightEdge account
KR	Keyword Reporting — tracked keyword rankings, SERP features, estimated traffic	Keywords tracked in BrightEdge
DCX	DataCubeX — web-wide organic keyword data for any domain, including competitors	BrightEdge account (any domain)
SOV	Share of Voice — competitive visibility scores for your configured competitive set	Keywords and Keyword Groups tracked in BrightEdge

2. Prerequisites

Before connecting the BrightEdge MCP, confirm you have the following:

An active BrightEdge account
At least one domain tracked in BrightEdge
Google Search Console connected to BrightEdge (optional, but required for GSC tools)
Tracked keywords (optional, but required for KR and SOV tools)

Account access required

The MCP server only returns Keyword Reporting, Share of Voice, and Google Search Console data for the domain and keyword set connected to your authenticated BrightEdge account. It cannot retrieve data for domains not linked to your account.

3. Connect to Claude

Open Claude Settings

In Claude.ai, click your profile icon in the bottom-left corner and select Settings. Navigate to the Connectors tab.

Find BrightEdge in the directory

Search for BrightEdge in the Connectors directory. Click the BrightEdge connector card to open the detail view.

Connect and authenticate

Click Connect. You will be redirected to BrightEdge's OAuth login. Sign in with your BrightEdge credentials and authorize the connection. You will be redirected back to Claude when authentication is complete.

Verify the connection

The BrightEdge connector should now appear as Connected in your Connectors list. Start a new conversation and try: "What are my top keywords by Share of Voice this week?"

4. Authentication

The BrightEdge MCP uses OAuth 2.0 for authentication. Your BrightEdge credentials are never stored by Claude — the connection is managed via a secure token issued by BrightEdge.

Token expiry and re-authentication

If your session token expires, you will see an authentication error when querying data. To re-authenticate, go to Settings → Connectors → BrightEdge → click Reconnect.

Revoking access

To revoke the connector's access to your BrightEdge account, disconnect the connector from Claude settings, then navigate to your BrightEdge account settings under Integrations → Connected Apps and remove the Claude or ChatGPT authorization.

5. Available tools

The BrightEdge MCP exposes 22 tools across four data sources. All tools are read-only.

Data freshness

GSC data is updated on Google's reporting schedule (typically 2–3 days lag). KR and SOV data are updated weekly. DCX data reflects the most recent available monthly index.

Google Search Console (GSC)

GSC

get_google_search_console_performance

Period-over-period GSC summary — total clicks, impressions, CTR, average position, keyword and page counts for a specified date window.

Example: "How did our organic search performance compare in Q1 versus Q4?"

GSC

get_google_search_console_all_keyword_performance

Keyword-level GSC data — clicks, impressions, CTR, and position per keyword with period comparison.

Example: "Which keywords lost the most clicks this month?"

GSC

get_google_search_console_branded_keyword_performance

GSC keyword data filtered to branded queries only.

Example: "Which branded keywords gained the most clicks last month?"

GSC

get_google_search_console_nonbranded_keyword_performance

GSC keyword data filtered to non-branded queries only.

Example: "Show me non-branded keywords driving the most impressions."

GSC

get_google_search_console_page_performance

Page-level GSC data — clicks, impressions, CTR, and position per URL with period comparison.

Example: "Which pages lost the most clicks from Google this month?"

Keyword Reporting (KR)

get_tracked_keyword_blended_rank

Blended rank for tracked keywords — includes SERP feature positions alongside organic rank.

Example: "Which of my tracked keywords dropped from page 1 this week?"

get_tracked_keyword_classic_rank

Classic (organic-only) rank for tracked keywords — excludes SERP feature positions.

Example: "Show my top 10 keywords by search volume that moved to page 1 for classic rank this month."

get_tracked_keyword_serp_features

Aggregate keyword counts by SERP feature category — AI Overview, Images, PAA, Videos, and more.

Example: "How many of my tracked keywords appear in AI Overviews?"

get_tracked_keyword_serp_features_details

Per-keyword SERP feature presence for a specific feature type.

Example: "Which of my tracked keywords show an AI Overview that I'm not cited in?"

get_tracked_keyword_competitive_comparison_details

Side-by-side blended rank comparison between your domain and a tracked competitor.

Example: "How does our rank compare to competitor.com for our tracked keywords?"

get_tracked_keyword_brightedge_volume

Blended rank and BrightEdge proprietary search volume for tracked keywords.

Example: "Show me my tracked keywords sorted by BrightEdge search volume."

DataCubeX (DCX)

DCX

get_keywords_losing_rank

Keywords that dropped in organic rank with estimated traffic impact.

Example: "Which keywords are we losing rank on this month?"

DCX

get_keywords_driving_opportunity

Keywords ranking between positions 4–20 with high traffic potential if rank improves.

Example: "Which keywords are just off page 1 with the most traffic potential?"

DCX

get_pages_losing_rank

Pages and site directories losing organic visibility with estimated traffic impact.

Example: "Which sections of our site are losing the most organic traffic?"

DCX

get_pages_gaining_rank

Pages and site directories gaining organic visibility with estimated traffic impact.

Example: "Which pages are gaining the most organic traffic this month?"

DCX

get_keywords_with_aioverview_opportunity

Keywords where a Google AI Overview exists but your domain is not currently cited.

Example: "Show me keywords where AI Overviews appear but we're not cited."

DCX

compare_competitor_performance

Domain-level organic keyword coverage and estimated traffic comparison across up to five domains.

Example: "Compare our keyword coverage against competitor.com and ahrefs.com."

DCX

compare_competitor_domain_gap_keywords

Row-level keyword gap showing which keywords a competitor ranks for that your domain does not.

Example: "What keywords does competitor.com rank for that we don't?"

Share of Voice (SOV)

SOV

get_share_of_voice_competitive_domains

Lists and ranks domains in your SOV competitive set by SOV score.

Example: "Which are our top domains by Share of Voice?"

SOV

get_share_of_voice_keywords

Keyword-level Share of Voice scores, volume, and rank with period comparison.

Example: "Which keywords have the highest Share of Voice this week?"

SOV

get_share_of_voice_pages

Page-level Share of Voice scores and competitive market share with period comparison.

Example: "Which pages gained the most Share of Voice compared to last week?"

Server

SRV

get_brightedge_mcp_server_info

Returns MCP server version, environment, and supported tool categories. Makes no external API call.

Example: "What version of the BrightEdge MCP is connected?"

6. Date formats

Most tools require a time range. The format depends on the reporting cadence:

# Monthly — YYYYMM
compare_time_range_start = 202504   # April 2025
compare_time_range_end   = 202503   # March 2025 (previous period)

# Weekly — YYYYWW
weekly_time_range_start  = 202518   # Week 18 of 2025
weekly_time_range_end    = 202517   # Week 17 of 2025

# Quarterly — YYYYQ
compare_time_range_start = 20251    # Q1 2025
compare_time_range_end   = 20244    # Q4 2024

Do not use the current incomplete month

For monthly cadence, always reference the last fully closed month as compare_time_range_start. Using the current month will return partial data.

7. Troubleshooting

Error or symptom	Likely cause	Fix
Authentication failed	OAuth token expired or revoked	Disconnect and reconnect the BrightEdge connector in Claude or ChatGPT settings.
Empty results returned	No data for the requested period, or domain not tracked	Verify the domain is tracked in your BrightEdge account. Check that the time range is fully closed (not the current partial month).
GSC data unavailable	Google Search Console not connected to BrightEdge	Connect GSC in your BrightEdge account under Settings → Integrations → Google Search Console.
SOV data unavailable	Share of Voice competitive set not configured	Ensure that you are tracking keywords and keyword groups in BrightEdge, and your tracked keywords are ranking for the primary tracked search engine.
Competitor data not found	Competitor not tracked in BrightEdge for KR tool; DCX tools work for any domain	For KR data, ensure that the competitor is tracked in your BrightEdge account. For keyword gap data, use the DCX compare tools instead.

8. FAQ

Does this connector write to or modify my BrightEdge account?

No. All supported tools are strictly read-only. The connector cannot create, update, delete, or configure anything in your BrightEdge account.

Can I query data for competitor domains I don't track?

Yes, for DCX tools (compare_competitor_performance, compare_competitor_domain_gap_keywords, get_keywords_losing_rank, etc.) which use BrightEdge's web-wide DataCubeX index. SOV and KR tools are limited to your configured account data.

Why is my GSC data showing a 2–3 day lag?

This is expected behavior, as it's Google's standard reporting delay for Search Console data. BrightEdge syncs GSC data on Google's schedule.

What is the difference between blended rank and classic rank?

Blended rank incorporates SERP feature positions (AI Overviews, Featured Snippets, Images, etc.) alongside organic positions. Classic rank is organic-only. Use blended rank for a complete picture of your search visibility; use classic rank when you want to isolate organic performance.

Can I use this connector without a BrightEdge subscription?

No. Access to a BrightEdge account is required to use the connector. Contact BrightEdge sales at brightedge.com/requestademo to discuss access. If you are an existing customer, contact your Customer Success Manager to get access to BrightEdge.

Is my BrightEdge login stored by Claude or ChatGPT?

No. Authentication uses OAuth 2.0 — only a secure access token is held, not your credentials. You can revoke access at any time from your BrightEdge account under Integrations → Connected Apps.

9. Support

If you cannot resolve an issue using the troubleshooting guide, contact BrightEdge support via integrations@brightedge.com.