MCP Connectors

Connect AEO Goal to Claude, Cursor, and other MCP-compatible AI tools.

Last updated August 31, 2026

AEO Goal exposes an MCP (Model Context Protocol) server that lets you connect your AI visibility data directly to Claude, Cursor, VS Code, and other MCP-compatible tools.

Server URL

https://mcp.aeogoal.com/mcp

That’s the only value you need. Authentication is OAuth in the browser - there is no static key to copy. The same URL is shown in the app under Settings → Connectors. (Older aeoranks.ai addresses are retired and won’t connect.)

Connecting Claude (web or desktop)

  1. In Claude, open Settings → Connectors → Add custom connector.
  2. Name it (e.g. AEO Goal) and paste the URL https://mcp.aeogoal.com/mcp.
  3. Click Connect - a browser window opens to sign in to AEO Goal.
  4. On the consent screen, grant the scopes you want (see below), then approve.

“AEO Goal” appears as a connected tool. See the full MCP Tools Reference for what you can ask.

Permissions (scopes)

You choose these on the consent screen:

  • platform:read - read brands, share-of-mind, citations, rankings, competitors.
  • platform:write - add tracked prompts, keywords, and competitors.
  • content:write - generate AEO/blog drafts (saved unpublished; nothing is auto-published).
  • reports:read / reports:write - white-label reports (Enterprise plan).

Grant only what you need - you can reconnect later to add more. If a tool replies insufficient_scope, reconnect and grant the scope it names.

Connecting Cursor

Add the server to ~/.cursor/mcp.json:

{
  "servers": {
    "aeogoal": {
      "url": "https://mcp.aeogoal.com/mcp"
    }
  }
}

Restart Cursor, then click Authenticate / Login on the AEO Goal server when prompted to complete the OAuth sign-in. The tools appear in the AI panel.

Rate limits

The MCP endpoint allows 120 requests per 60 seconds per connection. Heavy automated use may trigger rate limiting (HTTP 429); back off and retry after the Retry-After header duration.

Revoking access

Go to Settings → Connectors and click Disconnect on any connection to immediately revoke its access token.

Frequently asked questions

What is the AEO Goal MCP server URL?

The server URL is https://mcp.aeogoal.com/mcp, and it is the only value you need. The same URL is shown in the app under Settings then Connectors, and older aeoranks.ai addresses are retired and will not connect.

How does authentication work for MCP connectors?

Authentication is OAuth in the browser, so there is no static key to copy. When you connect a tool, a browser window opens to sign in to AEO Goal and you grant scopes on the consent screen.

Which permissions can I grant when connecting?

You can grant platform:read for reading brands, share-of-mind, citations, rankings, and competitors, platform:write for adding tracked prompts, keywords, and competitors, content:write for generating unpublished drafts, and reports:read or reports:write for white-label reports on the Enterprise plan. Grant only what you need and reconnect later to add more.

How do I revoke a connector's access?

Go to Settings then Connectors and click Disconnect on any connection to immediately revoke its access token.