OpenAEO MCP server
dev.openaeo/audit·v1.6.4Asks 8 AI crawlers for your page, checks who really answered, and writes the fixes. MIT.
0 stars147 downloads/wk
Reviews
Write oneNobody has reviewed OpenAEO yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
OpenAEO tools (15, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
aeo_alertsWhat changed on this site since the last check: a crawler that could reach it last week and
aeo_auditAudit a live website for AI-search visibility (AEO/GEO). Fetches the page as an AI crawler
aeo_authenticityHow much of the AI crawler traffic a site thinks it is getting is actually real, and how that
aeo_check_htmlScore a page's HTML against the checks a single file can satisfy (title, meta description,
aeo_citationswrite actionRun a citation test: ask the assistants a buyer question and record whether this business is
aeo_competitorsCompetitor share of voice: which domains the assistants name instead of you, across your
aeo_crawler_intelHas this site's CDN started refusing AI crawlers? Reads OpenAEO's corpus of per-crawler
aeo_driftWhat regressed. Lists checks that were passing and are not any more, and crawlers that were
aeo_fix_filesGenerate the paste-ready files a site needs to be readable and citable by AI assistants:
aeo_fix_htmlTake a page's HTML and return it with the missing structural pieces injected into <head>:
aeo_fix_my_siteONE-SHOT for people who don't have a codebase. Give it a domain and it audits the site,
aeo_historyScore history for a tracked site: how the AEO score has moved over time, and which checks
aeo_packetGenerate an engineering packet for a domain (the open-source version): an ordered list of tickets, each with the audit
aeo_read_logRead a server access log and report what AI crawlers actually got: which arrived, what status
aeo_verify_crawlerCheck whether an IP address really belongs to the crawler it claims to be, against the ranges
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan12 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 80 days ago12/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace7/10
How OpenAEO compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 77/100
- higher than 50% of 48,255 servers
- Tools
- 15
- the typical server has 7
- Tools that change things
- 7%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 147
- more than 71% of 12,191 servers with a package
What its tools let an agent do: 14 read · 1 change
Install OpenAEO in Claude Code, Cursor or VS Code
Runs npx -y openaeo-audit on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add audit -- npx -y openaeo-audit
What the publisher says
From the OpenAEO repository's README, as published. We do not edit it. Read it on GitHub
OpenAEO Audit
Check whether your website is retrievable and citable by AI answer engines — ChatGPT, Claude, Gemini, and Perplexity — from your terminal, in one command.
npx openaeo-audit yoursite.comNo install, no signup, no dependencies. It fetches your page the way an AI crawler does, scores it out of 100, and hands you the exact fixes that raise it.
AEO (Answer Engine Optimization) and GEO (Generative Engine Optimization) are the new SEO: your customers increasingly ask an assistant instead of scrolling ten blue links, and the winners are whoever the AI can read, trust, and recommend. This tool tells you where you stand.
Quick start
# pretty report
npx openaeo-audit example.com
# machine-readable JSON (for CI, dashboards, scripts)
npx openaeo-audit example.com --jsonExample output:
example.com
54/100 · AI-ready
AI-ready, not yet cited.
Retrievable, but thin on quotable specifics and structured data. Fixable without a redesign.
✓ Content readable in raw HTML — 1,240 visible words
✗ robots.txt allows GPTBot, ClaudeBot, PerplexityBot — robots.txt disallows gptbot
✗ llms.txt index present — missing
⚠ Organization + WebSite JSON-LD — Organization
⚠ Product / Offer schema with price — no priced Offer
⚠ Answer + a number in the first 100 words — vague / no title or meta
✗ FAQPage schema present — missing
✓ Freshness (dateModified) present — dateModified set
6 fixes to raise your score:
1. Unblock AI crawlers in robots.txt
Why: A single inherited Disallow line can hide you from ChatGPT and Perplexity entirely.
How: Explicitly Allow GPTBot, OAI-SearchBot, ClaudeBot, ... and link your sitemap.
...What it checks
The audit runs the checks that most often decide whether an AI assistant can quote you:
Scoring
Each check scores pass (1.0), warn (0.4), or fail (0.0), averaged to a 0–100 score, then placed in a band:
Some failures cap the score no matter what else passes, because they block retrieval entirely:
- Content invisible without JavaScript → capped at 25
- Bot blocked at the edge (4xx/403) → capped at 25
- robots.txt disallows AI bots → capped at 40
An honest low score you can act on beats a flattering one that hides the real problem.
Use it as a library
const { audit, remediationPlan } = require("openaeo-audit");Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
OpenAEO: common questions
- Is OpenAEO MCP server safe?
- Mostly: it is graded B (77/100). Read the OpenAEO safety report
- How do I install OpenAEO?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does OpenAEO need an API key?
- Yes. The registry entry asks for
OPENAEO_API_KEY. - Is OpenAEO maintained?
- The last commit was 81 days ago (2026-08-15). The latest release is v1.6.4.
- How does OpenAEO compare with other MCP servers?
- safety score 77/100 (higher than 50% of 48,255 servers); tools 15 (the typical server has 7); tools that change things 7% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.