Most AI visibility tools give you a dashboard. You log in, check the numbers, log out. Fine for reporting. Less useful when you want to do something about what you find.
Connecting AEO Copilot to Claude changes that. Instead of opening a dashboard, you ask a question: which prompts mention my competitors but not me? What's my visibility trend this month? What should I fix first? Claude pulls the data and answers directly.
This is how to connect them.
The API
Five endpoints, all GET requests, all returning JSON.
Authentication is a Bearer token. Every request needs this header:
Getting your API key
Go to Settings > API Keys and generate a key. It starts with aeo_. Keys don't expire, but you can revoke them at any time.
A basic request
Grab the brand id from the response and use it with the other endpoints.
Filtering results
The /results endpoint takes optional query parameters:
from and to take ISO dates. limit defaults to 100, max 500. topicId filters to a single topic.
The MCP server
MCP is the protocol that lets AI assistants connect to external tools. The AEO Copilot MCP server wraps the API so you can ask Claude about your brand's visibility data without leaving the conversation.
The server is open source: github.com/sofianbettayeb/aeo-copilot-mcp
Install in Claude Code
Install in Claude Desktop
Edit claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop after saving.
What it looks like in practice
Once connected, you talk to Claude like you would any conversation:
- "What's my brand's AI visibility score?"
- "Which prompts mention my competitors but not me?"
- "Show me my visibility trend for the last 30 days"
- "What should I fix to improve my AI visibility?"
- "How does my brand compare to [competitor] in AI-generated answers?"
Claude calls the API and translates the response into plain language. You can follow up, filter by date, drill into a specific topic. It works the way you'd expect a conversation to work.
What's coming
The API is v1 and the schema is stable. Write endpoints are next: creating topics, triggering prompt runs, and pushing results into external tools.
If you build something on top of it, or hit something that doesn't work as expected, open an issue on GitHub: github.com/sofianbettayeb/aeo-copilot-mcp.
Get your API key →