Setup guide

Connect ReachSurge to Cursor

Add ReachSurge to Cursor's MCP configuration and ask the agent about your AI visibility data while you work — citations, share of voice, authority scores, analytics, and forecasts.

Requires a ReachSurge Growth plan or higher · Read-only by default · API-key auth

1
Create a ReachSurge API key
In ReachSurge, go to Settings → API and create a key. Leave it read-only unless you want Cursor to queue page generation.
2
Add ReachSurge to mcp.json
Create or edit .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally) and add the server, replacing the placeholder with your key:
.cursor/mcp.json
```
{
  "mcpServers": {
    "reachsurge": {
      "url": "https://reachsurge.ai/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer rs_live_YOUR_KEY"
      }
    }
  }
}
```
3
Use it in the agent
Enable the server in Cursor's MCP settings if prompted, then ask the agent "List my ReachSurge sites" or "Show my AI citation trend for the last 30 days".

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

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.