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 67+ 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

67+ 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aeo_scanner-2.2.2.tar.gz (106.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aeo_scanner-2.2.2-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

Details for the file aeo_scanner-2.2.2.tar.gz.

File metadata

  • Download URL: aeo_scanner-2.2.2.tar.gz
  • Upload date:
  • Size: 106.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for aeo_scanner-2.2.2.tar.gz
Algorithm Hash digest
SHA256 bdcc616bd1b28cf8d7f53a46105c5cdfe7b82a452b237bccdcf96f19cb6a8779
MD5 b160e5951dbeae045415728b5053b89f
BLAKE2b-256 9760efaa81298423b67999fafae1c808168661412a11437d0d6724c67ebba481

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeo_scanner-2.2.2.tar.gz:

Publisher: publish-pypi.yml on Convrgent/aeo-saas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeo_scanner-2.2.2-py3-none-any.whl.

File metadata

  • Download URL: aeo_scanner-2.2.2-py3-none-any.whl
  • Upload date:
  • Size: 7.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for aeo_scanner-2.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f01be8b54eed8b948f8a14cc6e5e5f2949beaff071f47bbd03f4adb6bb96012d
MD5 f936be1934ade0297cdbb9153b3f9f30
BLAKE2b-256 b95eb2f15dafaa6525496b1059b4c778d2c17788dcf9d2e5e292a6ae96efa0b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeo_scanner-2.2.2-py3-none-any.whl:

Publisher: publish-pypi.yml on Convrgent/aeo-saas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page