AI SEO Tracker MCP is a Streamable HTTP server. After OAuth, the agent can read the same visibility data you see in the product, and add prompts the user asked to track.
MCP URL (production):
https://aiseotracker.com/api/agent/mcp
Always prefer the URL from Settings → Agent. It comes from getMcpResourceUrl() / getAgentConnectConfig(), so local and custom domains stay correct.
Use an MCP client. A browser GET returns an HTML help page, not JSON-RPC.
How it works
- You add the URL in the client. No token in the file.
- The client POSTs without
Authorization. - The server returns 401 plus
agent_auth_requiredand OAuth metadata. - The client opens a browser. You sign in and Allow.
- Later calls send a Bearer token. Tools run as you.
Access matches the website: if you cannot open a project in the UI, MCP cannot read or add prompts there. The session is account-wide, even though you copied the URL from one project.
Config
{
"mcpServers": {
"aiseotracker": {
"url": "{{AISEOTRACKER_MCP_URL}}"
}
}
}
Client-specific steps: Get started.
Call order
aiseo_list_projectsto getprojectSlug.- Then
aiseo_list_prompts,aiseo_list_sources,aiseo_list_snippets,aiseo_list_competitorsas needed. aiseo_add_promptsonly for queries the user asked to track.
Do not invent slugs. If dataStatus is no_data, create a project at /new or wait for a scan.
Empty data
Every project tool includes dataStatus:
| Value | Meaning |
|---|---|
ok | There is at least one result |
no_data | The project has none of this type yet |
empty_filter | The project has data; the filter matched nothing |
no_data is not a 401. Do not reconnect OAuth. Do not scrape the public site.