aeo-scanner

AEO Scanner — MCP Server

AI search visibility audit for any website. Three scores, one scan.

What it does

• AEO Score (0-100): How well AI search engines (ChatGPT, Perplexity, Google AI Overviews) can find, read, and cite your content
• GEO Score (0-100): How likely AI is to cite your site as a source — citation readiness for AI-generated answers
• Agent Readiness (0-100): How easily AI agents can understand, interact with, and transact on your site
• Mention Readiness (0-100): Predicts how likely AI will mention your brand, based on 12 research-backed signals
• AI Identity Card: How AI currently perceives your brand — gaps, citable claims, detected competitors
• Business Profile: Auto-detected business type (commerce/saas/media/general) with which scores matter most

Quick start

Remote server (recommended) — zero install, just add the URL:

# Claude Code
claude mcp add --transport http aeo-scanner https://aeo-mcp.convrgent.ai/mcp

# Claude Desktop / Claude.ai
# Settings → Connectors → Add custom connector → https://aeo-mcp.convrgent.ai/mcp

# Cursor — add to .cursor/mcp.json
{ "aeo-scanner": { "url": "https://aeo-mcp.convrgent.ai/mcp" } }

Then ask your AI assistant: "Scan example.com for AI visibility"

Alternative: local install via PyPI (stdio transport):

claude mcp add aeo-scanner -- uvx aeo-scanner

Tools

Free tier

scan_site works without any authentication. No API key, no wallet, no setup.

Rate limits: 20 scans/hour per IP, 5 per URL per day.

Paid tools

audit_site, compare_sites, and fix_site are pay-per-call via the x402 protocol — USDC on Base or Solana. No API key, no account.

Without payment, the tool returns a structured payment_required error containing the full x402 payload (payTo address, amount, asset). x402-capable clients retry automatically with a signed X-PAYMENT header; other agents can relay the payment details to their operator.

Workflow

The included optimize_site prompt guides the full workflow:

1. Scan — get baseline scores + mention readiness + business profile (free)
2. Compare — benchmark against detected competitors ($3)
3. Audit — see detailed breakdown by category ($1)
4. Fix — get working code with quick-win and full-ceiling projections ($5)
5. Rescan — verify improvement across all scores (free)

Scoring

77+ checks across 12 categories. See the built-in aeo://reference/scoring-methodology resource for full details.

AEO categories: Structured Data (30%), Meta & Technical (20%), AI Accessibility (25%), Content Quality (25%)

GEO categories: Brand Narrative Clarity (25%), Citation Readiness (25%), Authority Signals (25%), Entity Definition (25%)

Agent Readiness categories: Machine Identity (30%), API Discoverability (25%), Structured Actions (25%), Programmatic Access (20%)

Grades: A (90+), B (75-89), C (60-74), D (40-59), F (0-39)

Research basis

GEO checks are backed by peer-reviewed research: Princeton KDD 2024 (+115% visibility from citing sources), Growth Memo (44.2% citations from first 30% of content), Cornell (+28% from quantitative claims), and more. See scoring methodology for full citations.

---

Built by Convrgent — AI visibility tools for agents.