# AI SEO Tracker

> AI SEO Tracker measures how ChatGPT, Perplexity, Gemini, Copilot, and AI Overviews mention a brand. From an agent: fetch [SKILL.md](https://aiseotracker.com/SKILL.md), connect MCP (OAuth, no static API keys), read live visibility data, optionally add prompts. Tools are namespaced `aiseo_*` (snake_case). The only write is `aiseo_add_prompts`. It does not send email, add competitors, or charge a card. Never paste access tokens in chat. Never invent ranks or URLs when `dataStatus` is `no_data`. Claude Code is a supported MCP client. We do not scan Claude or Grok.

## When to use AI SEO Tracker

Use it when the user wants **AI search visibility** for a brand they already track:

- Weekly recap of wins, gaps, and citations
- What to write next from missing prompts
- Who to pitch among pages models already cite
- Where tracked rivals beat them, and how models describe each brand
- Reddit threads AI already cites

Do **not** use MCP as a substitute for creating a project or running scans. Empty results include `dataStatus: "no_data"`. Wait; do not scrape the public site.

How an agent should work:

1. Fetch [SKILL.md](https://aiseotracker.com/SKILL.md) first. It has the MCP URL, tool order, and rules. Do not guess from memory.
2. For the in-app Report brief, fetch [ai-seo-report/SKILL.md](https://aiseotracker.com/ai-seo-report/SKILL.md).
3. For a missing-prompt content campaign, fetch [content-coverage/SKILL.md](https://aiseotracker.com/content-coverage/SKILL.md) and stop for approval before writing files.
4. Connect MCP at `https://aiseotracker.com/api/agent/mcp` (or the URL from `/p/{projectSlug}/settings/agent`). Browser OAuth. See [docs](https://aiseotracker.com/docs).
5. Call `aiseo_list_projects` first. Pass `projectSlug` to the other tools.
6. Answer from tool JSON only. Do not invent ranks.

## MCP

- URL: `https://aiseotracker.com/api/agent/mcp`
- Discovery: [/.well-known/mcp](https://aiseotracker.com/.well-known/mcp) · [server card](https://aiseotracker.com/.well-known/mcp/server-card.json)
- Transport: Streamable HTTP JSON-RPC
- Auth: Better Auth OAuth resource server. 401 + `agent_auth_required` starts PKCE. Manage connections at `/account/agents`.
- Tools: `aiseo_list_projects`, `aiseo_get_scan`, `aiseo_list_sources`, `aiseo_list_prompts`, `aiseo_list_snippets`, `aiseo_list_competitors`, `aiseo_add_prompts`
- Scan state: call `aiseo_get_scan`. `done` means no in-flight jobs, not that every prompt has results. There is no subscribe tool.
- Empty data: `dataStatus` is `ok` | `no_data` | `empty_filter`
- Tool docs: [tools](https://aiseotracker.com/docs/tools) · [aiseo_list_projects](https://aiseotracker.com/docs/tools/aiseo-list-projects) · [aiseo_get_scan](https://aiseotracker.com/docs/tools/aiseo-get-scan) · [aiseo_list_sources](https://aiseotracker.com/docs/tools/aiseo-list-sources) · [aiseo_list_prompts](https://aiseotracker.com/docs/tools/aiseo-list-prompts) · [aiseo_list_snippets](https://aiseotracker.com/docs/tools/aiseo-list-snippets) · [aiseo_list_competitors](https://aiseotracker.com/docs/tools/aiseo-list-competitors) · [aiseo_add_prompts](https://aiseotracker.com/docs/tools/aiseo-add-prompts)

Human docs: [https://aiseotracker.com/docs](https://aiseotracker.com/docs)

## Agent docs

- [Overview](https://aiseotracker.com/docs)
- [Get started](https://aiseotracker.com/docs/get-started)
- [Auth](https://aiseotracker.com/docs/auth)
- [Connect MCP](https://aiseotracker.com/docs/mcp)
- [Tools](https://aiseotracker.com/docs/tools)
- Skills: [Setup](https://aiseotracker.com/docs/setup-skill) · [Report](https://aiseotracker.com/docs/ai-seo-report) · [Content coverage](https://aiseotracker.com/docs/content-coverage)
- [Troubleshooting](https://aiseotracker.com/docs/troubleshooting)

## Developer resources

- [Setup](https://aiseotracker.com/SKILL.md): connect MCP · [docs](https://aiseotracker.com/docs/setup-skill)
- [Report](https://aiseotracker.com/ai-seo-report/SKILL.md): same brief as the Report page · [docs](https://aiseotracker.com/docs/ai-seo-report)
- [Content coverage](https://aiseotracker.com/content-coverage/SKILL.md): posts for missing prompts · [docs](https://aiseotracker.com/docs/content-coverage)
- [Markdown pages](https://aiseotracker.com/markdown/docs/get-started): public file-backed pages as markdown at `/markdown/<path>`
- [AI Catalog (ARD)](https://aiseotracker.com/.well-known/ai-catalog.json)
- [Sitemap](https://aiseotracker.com/sitemap.xml)
- [llms.txt](https://aiseotracker.com/llms.txt)

## Docs (humans)

- [How it works](https://aiseotracker.com/how-it-works)
- [Pricing](https://aiseotracker.com/pricing)
- [Help](https://aiseotracker.com/help)
- [Blog](https://aiseotracker.com/blog)