AEO Scanner

io.github.ConvrgentPublished by GitHub account Convrgentv2.2.1Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingDeveloper ToolsData & Analytics

Overview

AI-generated overview

A remote or local MCP server that scans a website's AI search visibility and returns AEO, GEO and Agent Readiness scores, audits and fix code.

What you can do
Scan a site for free and get three 0-100 scores, an AI Identity Card, mention readiness and a detected business profile with top issues. Run a paid full audit across 12 categories with per-check issues and recommendations. Compare two sites side by side for competitive gaps and category winners. Generate fix code for visibility issues (schema, robots.txt, sitemap, llms.txt, meta tags, structured data) with projected scores.
When to use it
Useful when you want to check or improve how AI search engines and agents find, cite and interact with a website, benchmark it against a competitor, or get concrete code to fix visibility gaps.
Requirements
Either the remote HTTP endpoint or the local PyPI package run with uvx (stdio). The free scan needs no authentication. Paid tools need an AEO_API_KEY environment variable, or per-call payment in USDC via the x402 protocol on the Base network. Network access to the site being scanned.
Before you install
Paid tools (audit, compare, fix) cost money per call ($1, $3, $5) and require an API key or crypto payment; the key is a secret to keep private. The service fetches the target site and sends its content to a third-party server. Free scans are rate limited per IP and per URL.

Installation

In SourceWeft

  1. Open AEO Scanner in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Convrgent%2Faeo-scanner/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "aeo-scanner": {
      "type": "http",
      "url": "https://aeo-mcp.convrgent.ai/mcp"
    }
  }
}

README

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:

bash
# Claude Codeclaude 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):

bash
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.

Source: README.md at commit 46c902f

Tools

4

scan_site

Quick AI visibility scan. Returns three scores: AEO Score (0-100, AI search engine findability), GEO Score (0-100, AI citation readiness), and Agent Readiness Score (0-100, AI agent interaction capability). Also returns AI Identity Card with mention readiness (0-100, predicts how likely AI will mention the brand), detected competitors, business profile (commerce/saas/media/general), and top 5 issues. 77+ checks across 12 categories. Free — no API key needed. Does NOT return per-check details or fix code — use audit_site for full breakdown, fix_site for generated fixes, compare_sites to benchmark against a competitor.

Parametersurlrequiredpages

audit_site

Full AI visibility audit across 77+ checks in 12 categories (4 AEO + 4 GEO + 4 Agent Readiness). Returns detailed per-check scores with specific issues and recommendations, AI Identity Card with mention readiness and detected competitors, and business profile. GEO checks include 3 research-backed citation signals: factual density, answer frontloading, and source citations. Agent Readiness covers emerging agent-discovery standards Cloudflare's isitagentready.com evaluates: RFC 9727 api-catalog, SEP-1649 MCP Server Card, and IETF Content-Signal (draft-romm-aipref). Does NOT generate fix code — pass this response's id as scan_id to fix_site (within 1 hour) to get fixes WITHOUT a re-crawl, or use compare_sites to benchmark against a competitor. Pay per call ($1.00) via x402 — USDC on Base or Solana. Machine payment via signed X-PAYMENT header; see https://www.x402.org/. On payment_required, the response includes the full x402 payload with payTo/amount/asset.

Parametersurlrequiredpagescategories

fix_site

Generate complete fix code for all AI visibility issues across AEO, GEO, and Agent Readiness. Returns working code you can apply directly — schema generation, robots.txt, sitemap, llms.txt, meta tags, structured data, citation signals, entity markup. Also returns two-tier score projections: quick wins (critical + high fixes only) and full implementation ceiling (all fixes). TIP: pass scan_id from a fresh audit_site result (kept 1 hour) to skip the re-crawl — instant response, same price. Content recommendations include research citations. Run scan_site first to see which issues exist. Pay per call ($5.00) via x402 — USDC on Base or Solana. On payment_required, the response includes the full x402 payload with payTo/amount/asset.

Parametersurlpagesformatscan_id

compare_sites

Competitive gap analysis — scans two sites concurrently, shows side-by-side scores, category-by-category winners, competitive gaps (checks where the competitor scored 20+ higher), and generated overtake fix code with projected scores after closing gaps. Use this when the user wants to benchmark against a competitor or when scan_site detects competitors in the AI Identity Card. Pay per call ($3.00) via x402 — USDC on Base or Solana. On payment_required, the response includes the full x402 payload with payTo/amount/asset.

ParametersurlrequiredpagescompetitorUrlrequired

Version history

1
  1. v2.2.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts