English Français العربية

AEO Scanner

Official registry Developer tools

AI visibility for ChatGPT/Perplexity/Claude — triple score (AEO+GEO+Agent) with fix code. Free.

Source code Documentation

What can you do with AEO Scanner?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http aeo-scanner 'https://aeo-mcp.convrgent.ai/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "aeo-scanner": {
            "type": "http",
            "url": "https://aeo-mcp.convrgent.ai/mcp"
        }
    }
}
PYPI package aeo-scanner
Claude Code 
claude mcp add aeo-scanner -e 'AEO_API_KEY=<your aeo_api_key>' -- uvx aeo-scanner==2.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "aeo-scanner": {
            "command": "uvx",
            "args": [
                "aeo-scanner==2.2.1"
            ],
            "env": {
                "AEO_API_KEY": "<your aeo_api_key>"
            }
        }
    }
}

Environment variables

  • AEO_API_KEY secret API key for paid tools (audit_site, compare_sites, fix_site). Get at https://scan.convrgent.ai

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. AEO Scanner — MCP Server
  2. What it does
  3. Quick start
  4. Tools
  5. Free tier
  6. Paid tools
  7. Workflow
  8. Scoring
  9. Research basis

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

ToolWhat it doesPrice
scan_siteQuick triple-score scan + AI Identity Card + mention readiness + business profile + top issuesFree
audit_siteFull 58+ check breakdown across 12 categories (4 AEO + 4 GEO + 4 Agent)$1.00
compare_sitesTwo-site gap analysis + category winners + overtake fix code$3.00
fix_siteGenerated 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:

  1. Get your key at scan.convrgent.ai
  2. Set AEO_API_KEY in your MCP config

Or pay per call with USDC via x402 protocol (Base network).

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

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.

Frequently asked questions

What is AEO Scanner?

AI visibility for ChatGPT/Perplexity/Claude — triple score (AEO+GEO+Agent) with fix code. Free.

How do I install AEO Scanner?

It runs as a remote server. In Claude Code: claude mcp add --transport http aeo-scanner 'https://aeo-mcp.convrgent.ai/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does AEO Scanner need an API key?

Yes. It expects AEO_API_KEY, which you set in its configuration.

Is AEO Scanner open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains AEO Scanner?

It is published by Convrgent. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.