pypi aeo-scannerstreamable-httpMITupdated 4mo ago
AI search visibility audit for any website. Three scores, one scan.
What can you do with AEO Scanner?
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 58+ 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 require an API key:
- Get your key at scan.convrgent.ai
- Set
AEO_API_KEYin your MCP config
Or pay per call with USDC via x402 protocol (Base network).
Workflow
The included optimize_site prompt guides the full workflow:
- Scan — get baseline scores + mention readiness + business profile (free)
- Compare — benchmark against detected competitors ($3)
- Audit — see detailed breakdown by category ($1)
- Fix — get working code with quick-win and full-ceiling projections ($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.
Install
Add AEO Scanner to your client. Pick the one you use.
{
"servers": {
"aeo-scanner": {
"type": "http",
"url": "https://aeo-mcp.convrgent.ai/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add aeo-scanner -- uvx aeo-scannercodex mcp add aeo-scanner -- uvx aeo-scanneramp mcp add aeo-scanner -- uvx aeo-scanner{
"mcpServers": {
"aeo-scanner": {
"command": "uvx",
"args": [
"aeo-scanner"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"aeo-scanner": {
"command": "uvx",
"args": [
"aeo-scanner"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"aeo-scanner": {
"command": "uvx",
"args": [
"aeo-scanner"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"aeo-scanner": {
"command": "uvx",
"args": [
"aeo-scanner"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"aeo-scanner": {
"command": "uvx",
"args": [
"aeo-scanner"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"aeo-scanner": {
"type": "local",
"command": "uvx",
"args": [
"aeo-scanner"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"aeo-scanner": {
"command": {
"path": "uvx",
"args": [
"aeo-scanner"
]
}
}
}
}Add to your Zed `settings.json`.
uvx aeo-scannerRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
4 tools
AEO Scanner exposes 4 tools to a connected agent.
- scan_site
- Quick triple-score scan + AI Identity Card + mention readiness + business profile + top issues
- audit_site
- Full 58+ check breakdown across 12 categories (4 AEO + 4 GEO + 4 Agent)
- compare_sites
- Two-site gap analysis + category winners + overtake fix code
- fix_site
- Generated fix code with two-tier score projections — apply directly with Claude Code
Score
75 / 100
Good
- Documentation22/25
- Maintenance19/25
- Trust13/20
- Capability6/15
- Install experience15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 136 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 4 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 2.2.1Latest | Apr 17, 2026 |
| 2.2.0 | Apr 4, 2026 |
| 2.1.0 | Apr 2, 2026 |
| 2.0.0 | Apr 1, 2026 |
| 1.0.1 | Apr 1, 2026 |