Skip to main content
MCP connector overview

Setup guide

Connect ReachSurge to Claude in under 2 minutes

Add ReachSurge as a custom connector in Claude and ask questions like "How are my AI citations trending?" or "Which competitors outrank me for this keyword?" directly in chat. Connections use OAuth 2.1 — no API keys to copy — and are read-only by default.

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

  1. 1

    Open Claude's connector settings

    In Claude (claude.ai or the desktop app), open Settings → Connectors and choose Add custom connector.

  2. 2

    Enter the ReachSurge endpoint

    Paste the connector URL. Claude discovers the OAuth sign-in automatically — approve access on the consent screen and sign in with the same email you use for ReachSurge.

    Connector URL

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

    Ask about your data

    Start with "List my sites in ReachSurge", then try "Show my citation overview for the last 30 days" or "What's my share of voice against competitors?". Claude calls the ReachSurge tools and answers from your live data.

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

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.