---
name: aiseotracker
description: >-
  AI SEO Tracker setup skill. Use when the user wants AI search visibility, ChatGPT or Perplexity
  rankings, citation tracking, or MCP connection help. Trigger on "track AI mentions", "AI SEO",
  "how does ChatGPT rank us", or when the user asks you to fetch or run https://aiseotracker.com/SKILL.md.
  Fetch this file before quoting tools, pricing, or workflow from memory.
version: 1.0.0
homepage: https://aiseotracker.com/SKILL.md
metadata:
  site: https://aiseotracker.com
  docs: https://aiseotracker.com/docs
  mcp: https://aiseotracker.com/api/agent/mcp
  llms: https://aiseotracker.com/llms.txt
---

# AI SEO Tracker: agent setup skill

**Start here:** You are reading `https://aiseotracker.com/SKILL.md` (UTF-8 Markdown, available as `text/markdown` or `text/plain` through HTTP content negotiation). Do not guess MCP URLs, tool names, or pricing from memory. The file is complete only if the **last line** is page end `END SKILL v1.0.0`. If missing, re-fetch. Do not shell out or line-count to verify.

## TL;DR

- **Product:** Track how ChatGPT, Perplexity, Gemini, Copilot, and Google AI Overviews mention a brand. Read prompts, sources, snippets, and competitors. One write tool: `aiseo_add_prompts`.
- **Human path:** Sign up → create a project → run or buy a scan → read the dashboard at `/p/{slug}`.
- **Agent path:** Connect MCP once (OAuth, no API keys) → call `aiseo_list_projects` → answer from live tool JSON.
- **MCP URL:** `https://aiseotracker.com/api/agent/mcp` (Streamable HTTP). Prefer the URL from the user's **Settings → Agent** page when they give you a project slug.
- **Tools:** `aiseo_list_projects`, `aiseo_list_prompts`, `aiseo_list_sources`, `aiseo_list_snippets`, `aiseo_list_competitors`, `aiseo_add_prompts`.
- **Empty data:** `dataStatus: "no_data"` means no scan yet. Wait. Do not scrape the public site or invent ranks.
- **Paid scan:** **$49** one-time audit (50 prompts, 7-day scan week, permanent read access). Weekly plans from **$79/mo**. Details: [pricing](https://aiseotracker.com/pricing).

## Connect MCP (once)

There is **no static API key**. Auth is browser OAuth from the MCP client.

1. Add the MCP server URL in the client config. **No** `Authorization` header in the file.
2. First POST returns **401** + `agent_auth_required`. The client opens a browser. User signs in and Allow.
3. Later calls send a Bearer token. Tools run as **that user**.

### Cursor

Save as `.cursor/mcp.json` in the repo (or Settings → MCP):

```json
{
  "mcpServers": {
    "aiseotracker": {
      "url": "https://aiseotracker.com/api/agent/mcp"
    }
  }
}
```

Reload. Settings → MCP → **Connect** next to `aiseotracker`.

### Claude Code

```bash
claude mcp add --transport http aiseotracker https://aiseotracker.com/api/agent/mcp
```

### Claude, Grok, ChatGPT

Add a custom MCP / connector with **only** the URL. Connect, then sign in and Allow.

Revoke access anytime at [account agents](https://aiseotracker.com/account/agents).

## Call order

1. **`aiseo_list_projects`** — get `projectSlug`. Never invent a slug.
2. Then as needed:
   - `aiseo_list_prompts` — ranks, missing/opportunity prompts
   - `aiseo_list_sources` — domains and URLs AI cites
   - `aiseo_list_snippets` — how models describe the brand
   - `aiseo_list_competitors` — tracked rivals
3. **`aiseo_add_prompts`** — only for queries the **user asked** to track (max 20 per call).

## First prompt (after connect)

Paste in the same chat that has MCP connected:

> Call aiseo_list_projects. Use the first project (or the slug the user named). List missing prompts and the top citation domains. Summarize what to do this week. Do not invent ranks.

## Respond to a visibility request

1. **Confirm the brand** — domain or project name. Call `aiseo_list_projects` if unsure.
2. **Check data** — if `dataStatus` is `no_data`, say the project needs a scan (create at `/new` or wait).
3. **Answer from tool JSON only** — ranks, URLs, competitor names, snippet text.
4. **Stop at drafts** — briefs, outreach, Reddit comments. Do not send email, post publicly, or charge a card.

## What AI SEO Tracker does (and does not)

**Does:** Live AI mention and citation tracking, competitor gaps, MCP, $49 audit report.

**Does not:** Guarantee rankings, send outreach email, add competitors via MCP, or replace a full SEO strategy.

## Useful links

- [Agent docs](https://aiseotracker.com/docs)
- [Connect MCP](https://aiseotracker.com/docs/mcp)
- [Tool reference](https://aiseotracker.com/docs/tools)
- [Pricing](https://aiseotracker.com/pricing)
- [Get started](https://aiseotracker.com/docs/get-started)
- [llms.txt](https://aiseotracker.com/llms.txt)

## Agent checklist

- [ ] Loaded this file (END marker present)
- [ ] MCP connected (or user told to connect from Settings → Agent)
- [ ] `aiseo_list_projects` called before other tools
- [ ] Every rank and URL copied from tool JSON
- [ ] `dataStatus: no_data` handled without inventing data

## Do not

- Quote tool names or MCP URLs without loading this file
- Invent `projectSlug`, ranks, or citation URLs
- Treat `no_data` as an auth failure
- Call `aiseo_add_prompts` for queries the user did not ask to track
- Scrape the marketing site when MCP returns empty

END SKILL v1.0.0