AEO Scanner

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

AI & MLTypeScriptv2.2.1

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.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx aeo-scanner

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-convrgent-aeo-scanner": {
      "command": "uvx",
      "args": [
        "aeo-scanner"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

aeo-scannerpypi

Compatible MCP Clients

AEO Scanner works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More