About AEO Scanner
AEO Scanner is an MCP server for teams assessing how AI search engines and agents interpret a website. It scores visibility and readiness, identifies issues, and can generate fix code.
Key features
- 01Scan sites and produce multiple scores
- 02Show an AI identity card for a brand
- 03Detect a site's business type
- 04Break down issues by category
- 05Generate website fix code
Use cases
- 01Check whether AI search can find a site
- 02Assess readiness for brand citations
- 03Compare a site with competitors
- 04Obtain code to address site issues
MCP support
The MCP server offers scanning, auditing, site comparison, and fix-code tools, plus an optimize_site prompt for a full optimization workflow. Scans require no authentication; other tools require an API key or x402 payment on Base.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://aeo-mcp.convrgent.ai/mcpclaude mcp add --transport http convrgent-aeo-scanner https://aeo-mcp.convrgent.ai/mcp{"mcpServers":{"convrgent-aeo-scanner":{"type":"http","url":"https://aeo-mcp.convrgent.ai/mcp"}}}Open in Cursor{"servers":{"convrgent-aeo-scanner":{"type":"http","url":"https://aeo-mcp.convrgent.ai/mcp"}}}Open in VS Code{"mcpServers":{"convrgent-aeo-scanner":{"type":"http","url":"https://aeo-mcp.convrgent.ai/mcp"}}}{"mcpServers":{"convrgent-aeo-scanner":{"serverUrl":"https://aeo-mcp.convrgent.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Full URL to scan (e.g. https://example.com) |
| pages | integer | No | Number of pages to scan (1-5) |
Details
From the project READMEAEO 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
| Tool | What it does | Price |
|---|---|---|
scan_site | Quick triple-score scan + AI Identity Card + mention readiness + business profile + top issues | Free |
audit_site | Full 58+ check breakdown across 12 categories (4 AEO + 4 GEO + 4 Agent) | $1.00 |
compare_sites | Two-site gap analysis + category winners + overtake fix code | $3.00 |
fix_site | Generated fix code with two-tier score projections — apply directly with Claude Code | $5.00 |
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 require an API key:
- Get your key at scan.convrgent.ai
- Set
AEO_API_KEYin your MCP config
Or pay per call with USDC via x402 protocol (Base network).
Workflow
The included optimize_site prompt guides the full workflow:
- Scan — get baseline scores + mention readiness + business profile (free)
- Compare — benchmark against detected competitors ($3)
- Audit — see detailed breakdown by category ($1)
- Fix — get working code with quick-win and full-ceiling projections ($5)
- Rescan — verify improvement across all scores (free)
Scoring
58+ 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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.