Skip to main content
MCP connector overview

Setup guide

Connect ReachSurge to ChatGPT

ChatGPT can connect to remote MCP servers through custom connectors (available with developer mode on paid ChatGPT plans). Add the ReachSurge endpoint and ask about your AI visibility data in chat. Connector availability and menus vary by ChatGPT plan and rollout — if you don't see the option, check OpenAI's connector documentation for your plan.

Requires a ReachSurge Growth plan or higher · Read-only by default · OAuth sign-in, no API keys

  1. 1

    Enable developer mode

    In ChatGPT, open Settings → Connectors → Advanced and enable developer mode (paid plans). This unlocks adding custom MCP connectors.

  2. 2

    Add the ReachSurge connector

    Choose Create / Add custom connector, name it ReachSurge, and paste the server URL. Complete the OAuth sign-in with the same email you use for ReachSurge.

    MCP server URL

    https://reachsurge.ai/api/mcp/mcp
  3. 3

    Use it in a conversation

    Enable the ReachSurge connector in a new chat (via the tools/plus menu), then ask "List my sites in ReachSurge" or "How did my AI citations trend this month?".

Not on Growth yet? The MCP connector is included on Growth and Enterprise plans. See pricing or start with a free preview.

Frequently asked questions

Do I need a paid ChatGPT plan?

Custom MCP connectors require developer mode, which OpenAI offers on paid ChatGPT plans. Availability differs by plan and region — the ReachSurge side only requires a Growth+ account.

Why do I see "This account is not authorised to sign in"?

The email you use to sign in from your AI assistant must match a verified ReachSurge account on a Growth+ team. Sign in with the same email you use for ReachSurge.

Is the ReachSurge MCP connector read-only?

Yes, by default. OAuth connections and standard API keys can only read your data (citations, analytics, scores, forecasts). The single write tool — generate_page — requires an API key created with write access explicitly enabled in Settings → API. Checking job status with get_job is a read and works on any connection.

Which ReachSurge plan do I need?

The MCP connector is available on the Growth plan and above. OAuth sign-ins from accounts on lower plans are rejected with a 403 plan_required error, and API keys can only be created on Growth and Enterprise teams.

What data can the assistant access?

Only your own team's data: AI citations, citation overview, share of voice, authority score, first-party analytics, Google Search Console and GA4 metrics, traffic forecasts, and your site and page inventory. Connections are tenant-isolated and every tool call is recorded in your tamper-evident audit log.

How do I disconnect or revoke access?

In ReachSurge, go to Settings → API → Connected apps and disconnect the connection; access is blocked immediately. API keys can be deleted in Settings → API. OAuth access is also removed automatically on plan downgrade or cancellation. If you downgrade between paid plans, existing API keys keep working at the lower plan's rate limits (delete them if that's not intended); if you cancel entirely, they stop working.

Does connector usage count against my plan limits?

Connector traffic shares your plan's API budget and is rate-limited per call. The generate_page write tool charges your normal page-generation quota, exactly as if you generated the page from the dashboard.

Connect from other clients

Full connector reference — tools, security, troubleshooting — in the help center.