# AI SEO Tracker

> AI SEO Tracker measures how ChatGPT, Perplexity, Claude, and other models mention a brand. From an agent: connect MCP (OAuth, no static API keys), read live visibility data, optionally add prompts, optionally install one of five skills. 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`.

## 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. 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).
2. Call `aiseo_list_projects` first. Pass `projectSlug` to the other tools.
3. If a skill is requested, fetch `/skills/{slug}` and follow it. Do not invent ranks.

## MCP

- URL: `https://aiseotracker.com/api/agent/mcp`
- 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_list_sources`, `aiseo_list_prompts`, `aiseo_list_snippets`, `aiseo_list_competitors`, `aiseo_add_prompts`
- 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_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)

## Use cases (featured skills)

- [Weekly Visibility Brief](https://aiseotracker.com/skills/weekly-visibility-brief)
- [Content Brief from Gaps](https://aiseotracker.com/skills/content-brief-from-gaps)
- [Citation Outreach](https://aiseotracker.com/skills/citation-outreach)
- [Competitor Gap Analysis](https://aiseotracker.com/skills/competitor-gap-analysis)
- [Reddit SEO](https://aiseotracker.com/skills/reddit-seo)

Gallery: [https://aiseotracker.com/skills](https://aiseotracker.com/skills)

## Agent docs

- [Overview](https://aiseotracker.com/docs)
- [Get started](https://aiseotracker.com/docs/get-started)
- [Use cases](https://aiseotracker.com/docs/use-cases)
- [Auth](https://aiseotracker.com/docs/auth)
- [Connect MCP](https://aiseotracker.com/docs/mcp)
- [Tools](https://aiseotracker.com/docs/tools)
- [Skills](https://aiseotracker.com/docs/skills)
- [Troubleshooting](https://aiseotracker.com/docs/troubleshooting)

## Developer resources

- [Markdown pages](https://aiseotracker.com/markdown/docs/use-cases): public file-backed pages as markdown at `/markdown/<path>`
- [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)