Set up AI SEO Tracker in your agent, then run one real job.
You need:
- An AI SEO Tracker account with at least one project that has finished a scan
- An MCP client (Cursor, Claude Code, Claude, Grok, ChatGPT, and similar)
There are no static API keys. Auth is browser OAuth from the MCP client.
1. Create a project
Sign in, create a project, wait until prompts and sources exist. Empty tool results with dataStatus: "no_data" mean the scan has not landed. That is expected, not a broken connection.
Open Settings → Agent at /p/{projectSlug}/settings/agent. Copy the config shown for your client.
2. Add the MCP server
Production URL:
https://aiseotracker.com/api/agent/mcp
Prefer the URL from Agent settings so local and custom domains stay correct. Do not add an Authorization header.
Cursor
Save as .cursor/mcp.json in the repo (or Settings → MCP):
{
"mcpServers": {
"aiseotracker": {
"url": "{{AISEOTRACKER_MCP_URL}}"
}
}
}
Reload the window. Settings → MCP → Connect next to aiseotracker. Sign in and Allow.
Claude Code
claude mcp add --transport http aiseotracker {{AISEOTRACKER_MCP_URL}}
Restart if the server does not appear. Approve OAuth in the browser.
Claude, Grok, ChatGPT
Add a custom MCP / connector with only the URL. Connect, then sign in and Allow.
The first request without a token is 401 with agent_auth_required. That is how the client discovers OAuth. Details: Auth.
3. Test it
A test run reads live project data. It does not send email or start a scan.
Paste this in the same chat (Agent settings copies it with your slug filled in):
Call aiseo_list_projects. Use the first project. List missing prompts and the top citation domains. Summarize what to do this week. Do not invent ranks.
Review:
- Did a login window open, then succeed?
- Did
aiseo_list_projectsreturn slugs you recognize? - If prompts/sources are empty, is
dataStatusno_data? Wait for a scan rather than retrying OAuth.
If the client never opens a browser, see Troubleshooting.
4. Pick a job
Do not start with a catalog of skills. Pick one use case:
| Job | Skill |
|---|---|
| Monday recap | Weekly Visibility Brief |
| What to write | Content Brief from Gaps |
| Who to pitch | Citation Outreach |
| Why a rival wins | Competitor Gap Analysis |
| Reddit threads AI cites | Reddit SEO |
Save SKILL.md under .cursor/skills/{slug}/. If MCP is already connected, skip the OAuth steps in the file.
Next steps
- Use cases
- Connect MCP
- MCP tools
- Revoke at /account/agents