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.

How AI agents find AeoState

Beyond the MCP server, AeoState publishes machine-readable descriptions so AI agents and agent registries can discover it on their own. Each address below answers with JSON that any site may read.

MCP Server Card
https://aeostate.com/.well-known/mcp/server-card.json
AI catalog (ARD)
https://aeostate.com/.well-known/ai-catalog.json
API catalog (RFC 9727)
https://aeostate.com/.well-known/api-catalog

Agent Skills

Agents that support Agent Skills can load the skill AeoState publishes from this index. It shows them how to run a free AI visibility check through the MCP server or the HTTP API and how to read the result. Each skill is listed with a SHA-256 digest so the agent can verify what it downloaded.

Agent Skills index
https://aeostate.com/.well-known/agent-skills/index.json

Pages as markdown

Request any public page with the header Accept: text/markdown to get its text as markdown instead of HTML, with its title, address and language at the top. Browsers keep getting the normal page.

Example
curl -H "Accept: text/markdown" https://aeostate.com/en/pricing

Tools in the browser (WebMCP)

In a browser that supports WebMCP, an AI agent working on this site can open its pages, read the current prices, check a running scan and fill in the free-score form. The visitor still confirms and submits the form. WebMCP is experimental and only available in some browser builds; everywhere else nothing changes.

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