Skip to main content

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

Tool What it does Price
scan_site Quick triple-score scan + AI Identity Card + mention readiness + business profile + top issues Free
audit_site Full 77+ 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 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.

Release files for aeo-scanner 2.2.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aeo-scanner 2.2.5
File Size Uploaded
aeo_scanner-2.2.5.tar.gz 106.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aeo-scanner 2.2.5
File Interpreter ABI Platform
aeo_scanner-2.2.5-py3-none-any.whl Python 3 none any Details

Total release size: 114.8 kB

Release files / aeo_scanner-2.2.5.tar.gz

Download URL aeo_scanner-2.2.5.tar.gz
Size 106.8 kB
Tags Source
SHA-256 checksum
How to use checksums
362510c7e979923941daf684e904b43e64fb0f4396cd9b534619b57cddadb170
BLAKE2b-256 checksum
How to use checksums
381de488801ef53981106b08f4282cbe3b3371a2d5676c84c931239bd0f60d57
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 4, 2026.

Transparency log

Release files / aeo_scanner-2.2.5-py3-none-any.whl

Download URL aeo_scanner-2.2.5-py3-none-any.whl
Size 8.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cce6bcd6758ee619c4ac06149f09373d02713b69d6157d6d86b790cf6e6a25fa
BLAKE2b-256 checksum
How to use checksums
28673c131b5047a6a33d1319ada2e6f5b239e0638fdd2855178c10eeed25aa85
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 4, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

2.2.5 This release

2 release files

2.2.4

2 release files

2.2.3

2 release files

2.2.2

2 release files

2.2.1

2 release files

2.2.0

2 release files

2.1.0

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page