MCP & API

Score AI visibility from Claude, your agents and your pipeline.

AeoState runs a Model Context Protocol (MCP) server at https://aeostate.com/mcp, with the same HTTP API behind it. Connect once and the free AI-visibility score renders as an interactive card in Claude Desktop, claude.ai, Claude Code, Cursor and every other MCP host — or call the API directly from a script.

Tools

Free tools work for anyone — no account, no key. Tools marked “API key” act for a registered account: create a free account, then a personal key under Account → API access.

Connect in one step

Copy one of these into your host. Add the Authorization header when you have a key.

MCP endpoint
https://aeostate.com/mcp
Claude Code
claude mcp add --transport http aeostate https://aeostate.com/mcp
Cursor, VS Code, claude.ai connectors and other hosts (JSON)
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp"
    }
  }
}
Same, acting for your account
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Plain HTTP for pipelines

The same three calls the MCP server makes. Start a scan, poll it, read the report — from CI, a CRM workflow or a nightly job.

1 · Start a scan
curl -s -X POST https://aeostate.com/api/analyze \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","industry":"family dental clinic","category":"family dental clinic","locale":"en"}'
# → {"mode":"async","jobId":"…"} (poll below) or the finished free summary
2 · Poll until it completes
curl -s https://aeostate.com/api/scan-jobs/<jobId>
# → {"status":"queued|running|completed|failed","stage":"crawling|scoring|completed","reportId":"…"}
3 · Read the report
curl -s https://aeostate.com/api/reports/<reportId>
# → 402 + the free summary (score, grade, confidence, section teasers)

Anonymous scans follow the site's free-score rules (rate limits; where the free score is email-gated, the score link is emailed). With a key they run as your account: no gate, per-key limits, and your paid reports.

Free score vs. Advanced Report

No account

Free score — every tool, every visitor

  • Your overall visibility score, its grade, and our confidence in it
  • How clearly your published content supports AI answers
  • The first finding holding your visibility back

Get a personal API key

Sign in (or create a free account), open Account → API access, create a key and paste it into the snippets above. Keys act only on scans and the reports you bought — never on your account, billing or anyone else's reports.

Get your key
MCP & API — score AI visibility from Claude, agents and pipelines — AeoState