BrightEdge MCP

Connect AI Tools to BrightEdge Data

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.


Connection Details

Use the following endpoints depending on your platform's transport requirements:

SettingValue
MCP Endpoint (HTTP)https://mcp2.brightedge.com/mcp
SSE Endpointhttps://mcp2-sse.brightedge.com/sse
Use the MCP Endpoint for platforms that support standard HTTP/MCP transport (ChatGPT, Claude, Copilot, Lovable). Use the SSE Endpoint for platforms that require Server-Sent Events transport (Manus, OpenClaw).

Who Can Access BrightEdge MCP?

All BrightEdge customers with a valid set of BrightEdge login credentials (including username and password) can connect to the MCP server.

You can use your existing credentials to connect to and query the MCP server within the defined usage limits. For any questions or concerns, please reach out to the BrightEdge team at .


Authentication

All platforms use OAuth 2.0 authentication. When prompted during setup, you will sign in with your BrightEdge account credentials. BrightEdge uses Auth0 as its identity provider — you will see a BrightEdge-branded login screen hosted on auth0.com.


Available Setup Guides

  • ChatGPT (Web): OAuth setup via ChatGPT Settings → Apps
  • Claude (Web & Desktop): Custom connector via Claude Settings → Connectors
  • Microsoft Copilot: MCP tool in Copilot Studio with OAuth
  • Slack: Pre-configured app, connect account via Slack desktop
  • OpenClaw: Mcporter middleware + terminal configuration
  • n8n: MCP Client node with OAuth2 — HTTP Streamable transport
  • Manus: Custom MCP via SSE transport + Bearer token
  • Lovable: Custom connector via Lovable Settings → Connectors
  • Relevance AI: MCP tool added via agent configuration with OAuth

ChatGPT (Web)

Platform 1 of 9

Connect BrightEdge MCP to ChatGPT on the web to query BrightEdge data directly within your ChatGPT conversations.

Note: MCP connector support in ChatGPT requires a Pro or Plus account. The feature is currently in beta and is available via ChatGPT Settings → Apps.
Prerequisites
  • An active BrightEdge account
  • Access to the target AI platform
  • A ChatGPT Pro or Plus account
Connection Details
SettingValue
Server URL / MCP Endpointhttps://mcp2.brightedge.com/mcp
Setup Steps
1
Open ChatGPT Settings

Navigate to chatgpt.com and log in. Click your profile icon in the bottom-left corner and select Settings.

2
Navigate to Apps

In Settings, select the Apps section, then click Create app.

3
Enter the BrightEdge Connection Details

Fill in the following fields. Leave all other pre-populated fields as they are:

  • Server URL: https://mcp2.brightedge.com/mcp
  • OAuth Client ID
  • OAuth Client Secret

Leave the Resource with DNS URL field as pre-populated, then click Create.

Note: You may need to click into Advanced Auth settings to view all the required fields.

4
Authenticate with BrightEdge

A BrightEdge login screen will appear. Enter your BrightEdge account credentials and click Log In. Once authenticated, the connector will be added to your account.

5
Activate the Connector in Chat

Close the settings dialog. In the chat interface, click the + icon in the message input area, then select More. Select the BrightEdge connector you just created to activate it for the current conversation.

6
Start Prompting

With the connector active, you can now query BrightEdge data directly in ChatGPT.

For best results, mention BrightEdge explicitly in your prompt, e.g. 'Using BrightEdge, show me the top 10 keywords by traffic this month.'

Claude (Web & Desktop)

Platform 2 of 9

Connect BrightEdge MCP to Claude on the web (claude.ai) or via the Claude desktop application. Claude uses OAuth authentication and provides per-tool permission controls once connected.

Prerequisites
  • An active BrightEdge account
  • Access to the target AI platform
  • A Claude account (any paid plan)
SettingValue
Remote MCP Server URL (Web)https://mcp2-sse.brightedge.com/sse
AuthenticationOAuth (Auth0)
Setup Steps
1
Open Settings

Launch Claude and click on your profile name in the bottom-left corner. Select Settings from the dropdown.

2
Navigate to Connectors

In the Settings menu, locate and click Connectors. You will see existing integrations (such as Google Drive and GitHub).

3
Add a Custom Connector

Click Add custom connector and fill in the following fields:

  • Name: BrightEdge MCP
  • Remote MCP Server URL: https://mcp2-sse.brightedge.com/sse
  • OAuth Client ID

Expand Advanced settings if the Client ID field is not immediately visible. Click Add to save the connector.

4
Authenticate with BrightEdge

The BrightEdge connector will now appear in your connectors list. Click Connect. Claude will redirect you to a BrightEdge OAuth/Auth0 login screen. Enter your BrightEdge email and password, then click Log In. Once authenticated, Claude will securely link the connector to your account.

5
Configure Tool Permissions

After connecting, Claude will display the list of tools exposed by the BrightEdge MCP server. For each tool you can set the permission to Allowed, Blocked, or Ask every time. For uninterrupted use, set Read-only tools to Allowed.

6
Start Prompting

The BrightEdge connector is now active. In any chat, ensure the BrightEdge connector is enabled (visible in the chat toolbar), then start prompting.

Microsoft Copilot

Platform 3 of 9

Add BrightEdge MCP as a tool in Microsoft Copilot Studio to give your Copilot agents access to live BrightEdge data.

Prerequisites
  • An active BrightEdge account
  • Access to the target AI platform
  • Access to Microsoft Copilot Studio (copilotstudio.microsoft.com)
Connection Details
SettingValue
Server URLhttps://mcp2.brightedge.com/mcp
Setup Steps
1
Access Copilot Studio

Navigate to copilotstudio.microsoft.com and log in with your Microsoft credentials.

2
Create or Open an Agent

In the left panel, navigate to Agents and click New Agent (or open an existing agent). Provide a name, description, and select GPT-4o or your preferred model.

3
Add a New Tool

From within your agent, navigate to the Tools section and click Add Tool → Create New → Select MCP.

4
Enter the BrightEdge Connection Details

Fill in the following fields:

  • Server URL: https://mcp2.brightedge.com/mcp
  • OAuth Client ID
  • OAuth Client Secret
  • Auth URL: https://be-mcp-server-v2-gigjheawsa-uc.a.run.app/authorize
  • Token & Refresh URL: https://be-mcp-server-v2-gigjheawsa-uc.a.run.app/token
  • Scope: openid profile email

Click Create. A Redirect URL will be generated.

Share the generated Redirect URL with the BrightEdge team to have it allowlisted before proceeding.
5
Connect the Tool to Your Agent

Return to your agent and add the BrightEdge tool from the Tools section. A login screen will appear — enter your BrightEdge credentials to establish the connection.

6
Verify the Installation

Navigate to the Tools section of your agent and confirm that the BrightEdge MCP tool is shown as installed and active.

7
Start Prompting

Navigate to your agent and begin prompting. The agent can now call BrightEdge tools to answer queries.

Slack

Platform 4 of 9

The BrightEdge Slack App connects BrightEdge data and actions directly into your Slack workspace using Slack's standard OAuth installation flow. Installation takes only a few minutes and requires no technical configuration.

Prerequisites
  • An active BrightEdge account
  • Access to the target AI platform
  • A Slack account with access to the workspace where the app will be installed
  • Workspace admin approval may be required if your organisation restricts third-party app installations
Installation URL

Use the following link to begin the installation. Open it in a browser while signed in to your Slack account:

https://slack.com/oauth/v2/authorize?client_id=10825199192177.11032644384785&scope=app_mentions:read,assistant:write,channels:history,chat:write,im:history,users:read&user_scope=
Note: This link launches Slack's official OAuth installation flow. You do not need a BrightEdge API token or OAuth credentials — Slack handles the authorisation automatically.
Setup Steps
1
Open the Installation Link

Open the installation URL above in any modern browser while signed in to your Slack account. This launches Slack's official OAuth installation flow.

2
Select Your Slack Workspace

Slack will prompt you to select the workspace where the BrightEdge App will be installed.

  • If you are signed in to multiple workspaces, choose the correct one from the workspace switcher.
  • If you are not signed in, Slack will ask you to sign in first.
3
Review Permissions

Slack will display the list of permissions (OAuth scopes) requested by the BrightEdge App. Review them before continuing. Permissions include:

  • Reading user and channel information
  • Reading message history (channels and direct messages)
  • Posting messages
4
Approve the Installation

Click Allow to grant the requested permissions and complete the installation. Once approved, Slack installs the app into your selected workspace. You may be redirected back to BrightEdge or to a Slack confirmation page.

5
Confirm the App is Installed

After installation, verify that the BrightEdge App is available in your workspace:

  • Open Slack.
  • Go to Apps in the left sidebar.
  • Search for BrightEdge.
  • Confirm the app is listed and accessible.

Troubleshooting

Missing Permissions: If installation fails, confirm the installer has the required role in the Slack workspace. Some permission scopes can only be approved by a workspace admin or owner.

Workspace Restrictions: Some Slack workspaces restrict third-party app installations. In that case, a workspace admin must approve the BrightEdge App before it can be installed.

Reinstalling the App: If the app was previously installed and its requested scopes have changed, a reinstall may be required for the new permissions to take effect. Simply open the installation link again and follow the same steps.

OpenClaw

Platform 5 of 9

Connect BrightEdge MCP to OpenClaw using mcporter, a middleware CLI that bridges OpenClaw with external MCP servers. Setup involves enabling mcporter in the OpenClaw UI and configuring it via the terminal.

Prerequisites
  • An active BrightEdge account
  • Access to the target AI platform
  • Access to OpenClaw
  • Node.js and npm installed
SettingValue
Server URL (SSE)https://mcp2-sse.brightedge.com/sse
Setup Steps
1
Enable mcporter in OpenClaw

In the OpenClaw UI, navigate to Skills in the left navigation menu. Locate mcporter in the Built-in Skills list and toggle it on.

2
Install mcporter via npm

Then install mcporter globally via npm by running the following command in your terminal:

npm install -g mcporter
3
Add the BrightEdge MCP Server

Add the BrightEdge MCP server configuration to your local mcporter setup. Navigate to the .mcporter folder (create it if it doesn't exist):

cd $HOME/.mcporter/
4
Configure the .mcporter Directory

Create or update credentials.json with the following content:

{
  "version": 1,
  "entries": {
    "brightedge|fc7a79fb09a7771d": {
      "serverName": "brightedge",
      "serverUrl": "https://mcp2.brightedge.com/mcp",
      "clientInfo": {
        "client_id": "NM9It06JLxFxSASeXvxdoEveq01Uhohv"
      }
    }
  }
}

Create or update mcporter.json with the following content:

{
  "mcpServers": {
    "brightedge": {
      "baseUrl": "https://mcp2.brightedge.com/mcp",
      "auth": "oauth"
    }
  }
}
5
Authenticate with BrightEdge

Run the authentication command to link your BrightEdge account:

mcporter be-mcp auth

A BrightEdge login page will open in your browser. Enter your credentials and sign in. To verify the connection is active, run:

mcporter list
6
Invoke BrightEdge in OpenClaw

With authentication complete, use the /skill command in OpenClaw to query BrightEdge:

/skill <mcp_server_name> <query>
/skill brightedge Get me the top 3 keywords for this month.

BrightEdge data will be returned directly within your OpenClaw workflow.

n8n

Platform 6 of 9

Connect BrightEdge MCP to n8n to incorporate live BrightEdge data into automated workflows and multi-step pipelines. n8n uses the MCP Client node with OAuth2 authentication.

Prerequisites
  • An active BrightEdge account
  • Access to the target AI platform
  • An n8n account (cloud or self-hosted)
Connection Details
SettingValue
Server TransportHTTP Streamable
MCP Endpoint URLhttps://mcp2.brightedge.com/mcp
AuthenticationMCP OAuth2
Setup Steps
1
Create a New Workflow

In n8n, navigate to Workflows and click Create workflow. This opens a blank workflow canvas.

2
Add an MCP Client Node

On the workflow canvas, click Add first step (or the + icon). In the node search panel, search for MCP Client and select it to add it as a step.

3
Configure the MCP Client — Transport & Endpoint

With the MCP Client node selected, open the Parameters tab and set the following:

  • –  Server Transport: HTTP Streamable
  • –  MCP Endpoint URL: https://mcp2.brightedge.com/mcp
  • –  Authentication: MCP OAuth2
4
Create the OAuth2 Credential

For the Credential for MCP OAuth2 API field, click Create New Credential. A credential form will open — enter the following values:

  • –  Use Dynamic Client Registration: Off (toggle off)
  • –  Grant Type: Authorization Code
  • –  Authorization URL: https://mrkt-0365.us.auth0.com/authorize
  • –  Access Token URL: https://mrkt-0365.us.auth0.com/oauth/token
  • –  Client ID
  • –  Client Secret
Ensure "Use Dynamic Client Registration" is toggled off before saving.
5
Save and Connect to BrightEdge

Click Save, then click Connect to MCP. A BrightEdge login page will open — enter your BrightEdge credentials to complete the OAuth flow.

6
Select a Tool and Configure Your Query

Once authenticated, return to the MCP Client node. In the Tool dropdown, select the BrightEdge tool you want to use. Set Input Mode to Manual and enter your prompt in the Values to Send field.

Example prompt: show me ranking between Jan to Feb 2026

7
Execute the Workflow

Click Execute step (or Execute workflow if you have multiple nodes) to run the workflow. BrightEdge data will be returned as the node output.

You can chain the MCP Client node output into further n8n nodes — for example, sending results to Slack, writing to a Google Sheet, or triggering further logic.

Manus

Platform 7 of 9

Connect BrightEdge MCP to Manus using a direct SSE configuration. Manus supports custom MCP servers via its Connectors panel, with Bearer token authentication.

Prerequisites
  • An active BrightEdge account
  • Access to the target AI platform
  • A Manus account (web or desktop)
SettingValue
Server URL (SSE)https://mcp2-sse.brightedge.com/sse
Auth Header ValueBearer <your-brightedge-token>
Setup Steps
1
Open the Connect Apps Panel

In the Manus interface, locate the prompt input area. Click the Connect apps button (the second icon in the toolbar below the prompt input). This opens the connector options.

2
Open Add Connectors

A list of available connectors will appear. Scroll to the bottom and click + Add connectors. This opens the full Connectors dialog.

3
Navigate to the Custom MCP Tab

In the Connectors dialog, click the Custom MCP tab at the top. If no custom MCPs have been added yet, you will see a message saying 'No custom MCP added yet'.

4
Open Direct Configuration

Click the + Add custom MCP dropdown button and select Direct configuration from the options (the alternative is Import by JSON). This opens the MCP configuration form.

5
Enter the BrightEdge Configuration

Fill in the MCP configuration form with the following values:

  • Server Name: BrightEdge
  • Transport Type: SSE
  • Server URL: https://mcp2-sse.brightedge.com/sse

In the Custom headers section, click + Add custom header and enter:

  • Header name: Authorization
  • Header value: Bearer <your-brightedge-token>

The Icon and Note fields are optional.

Replace <your-brightedge-token> with your BrightEdge API token. Contact your BrightEdge team if you do not have a token.
6
Save the Configuration

Click Save or Try it out to test before saving. BrightEdge will appear in the Custom MCP tab, confirmed with a green checkmark.

7
Start Prompting

Close the connector dialog. Click Connect apps again — BrightEdge will now appear in the connector list and will be enabled by default. You can now include BrightEdge data in any Manus task or prompt.

Lovable

Platform 8 of 9

Connect BrightEdge MCP to Lovable via its personal connector's settings. Lovable uses OAuth authentication and supports both HTTP and SSE endpoints.

Prerequisites
  • An active BrightEdge account
  • Access to the target AI platform
  • A Lovable account (lovable.dev)
SettingValue
Server URL (SSE)https://mcp2-sse.brightedge.com/sse
AuthenticationOAuth
Setup Steps
1
Log Into Lovable

Navigate to lovable.dev and sign in with your account credentials.

2
Open Settings

Click Settings in the navigation menu or from your profile dropdown.

3
Navigate to Connectors

In Settings, select Connectors. In the Personal connectors section, click Custom.

4
Enter the BrightEdge Connection Details

Fill in the connector form with the following values:

  • –  Server URL: https://mcp2-sse.brightedge.com/sse
  • –  Authentication: OAuth
  • –  OAuth Client ID
  • –  OAuth Client Secret

Click Add (or Connect) to proceed.

5
Authorize Access

A BrightEdge authorization screen will appear. Select your workspace and click Allow to grant Lovable access.

6
Confirm the Connection

Once connected, BrightEdge MCP will appear as "Enabled" in your Personal Connectors list. You can now use BrightEdge data in your Lovable projects and prompts.

If you need to disconnect or reconnect the BrightEdge connector, return to Settings → Connectors → Personal connectors and manage it from there.

Relevance AI

Platform 9 of 9

Connect BrightEdge MCP to Relevance AI to give your agents and tools access to live BrightEdge data within automated workflows.

Prerequisites
  • An active BrightEdge account
  • Access to the target AI platform
  • A Relevance AI account
SettingValue
Server URLhttps://mcp2.brightedge.com/mcp
Setup Steps
1
Open Your Agent or Tool

In Relevance AI, navigate to the Agent or Tool you want to connect BrightEdge MCP to. Open its settings or configuration panel.

2
Add a New Tool

Look for the Integrations, Tools, or MCP section within the agent configuration. Click Add tool or Add integration.

3
Select MCP as the Tool Type

When prompted for a tool type, choose MCP Server or Model Context Protocol.

4
Enter the BrightEdge Connection Details

Fill in the following fields:

  • –  Server URL: https://mcp2.brightedge.com/mcp
  • –  OAuth Client ID
  • –  OAuth Client Secret
  • –  Auth URL: https://mrkt-0365.us.auth0.com/authorize
  • –  Token URL: https://mrkt-0365.us.auth0.com/oauth/token
  • –  Scope: openid profile email
5
Authenticate with BrightEdge

Click Connect or Save. A BrightEdge login screen will appear — enter your BrightEdge credentials to complete the OAuth flow. Once authenticated, the connection will be confirmed.

6
Save and Test

Save the configuration. Test the connection by running a sample query within Relevance AI to confirm BrightEdge data is returned successfully.

If you encounter connection issues, verify the Server URL and OAuth credentials are entered exactly as shown above.

Using BrightEdge Data in Workflows

Once connected, your Relevance AI agents can query BrightEdge data as part of any workflow step. When building prompts or agent instructions, be specific about which BrightEdge data you need and how you want it used.

Example agent instruction:

When the user asks about keyword performance, use the BrightEdge
MCP tool to retrieve the relevant keyword data and summarise
the findings in plain language.
,