Grounded AEO — Claude Code MCP server: what it does, how to install
Grounded AEO audits a site for AI citation, hands back paste-ready markup and a v=AEO1 DNS record, and returns owner-verified company facts.
no license 571 installs updated 2026-07-19
claude mcp add --transport http grounded-aeo https://grounded-aeo--garrett-miller.run.toolsWhat Grounded AEO does
This one runs remotely over HTTP at https://grounded-aeo--garrett-miller.run.tools, so there is nothing to host yourself. The run_audit tool fetches a domain, scores it from 0 to 10 on how easily AI answer engines can read it, and names the gaps. You get the fix material in the same reply: a <head> block with title, meta description and Organization JSON-LD, plus a plan covering llms.txt, structured data and crawler access.
Edit, then audit again. generate_free_record produces a v=AEO1 TXT record and a .well-known/aeo.json file for you to publish on your own domain. check_aeo_record looks for that record under _aeo.<domain> on any site and, when the domain sits in the catalog, matches the Ed25519 signature against the stored content. A score on its own says little, so budget two runs: the second one is where the number starts to mean something.
The other half is facts. get_company_facts, get_fact, get_llms_txt and search_catalog return what the business itself approved, which beats values scraped off a page. No API key is involved, and calls are rate-limited per caller.
What it helps with
- score a site from 0 to 10 for AI readability
- drop in a prepared
<head>block with Organization JSON-LD - publish a
v=AEO1DNS record and.well-known/aeo.json - check any domain for an
_aeorecord - ground an answer in owner-verified company facts
Example prompts for the agent
- Run
run_auditon my domain and tell me which gaps to fix first. - Generate the record with
generate_free_recordand show me where the.well-known/aeo.jsonfile goes. - Pull
get_company_factsfor the domain and write the company blurb from those facts only.
How to install Grounded AEO
Platform CLI: remote server
claude mcp add --transport http grounded-aeo https://grounded-aeo--garrett-miller.run.toolsPlatform CLI: remote server
codex mcp add grounded-aeo --url https://grounded-aeo--garrett-miller.run.toolsConfig file
{
"mcpServers": {
"grounded-aeo": {
"url": "https://grounded-aeo--garrett-miller.run.tools"
}
}
}Config file
{
"servers": {
"grounded-aeo": {
"type": "http",
"url": "https://grounded-aeo--garrett-miller.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http grounded-aeo https://grounded-aeo--garrett-miller.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Grounded AEO
How do I install Grounded AEO in Claude Code?
Run claude mcp add --transport http grounded-aeo https://grounded-aeo--garrett-miller.run.tools. That registers the hosted server over HTTP.
What does Grounded AEO do?
It scores a site for AI citation readiness, returns the markup and the plan to close the gaps, generates the v=AEO1 record, and serves verified company facts from its catalog.
What is v=AEO1?
An open standard documented at aeorecord.org. A TXT record under _aeo.<domain> states whether a verified fact record exists and at which trust tier, and the server can check any domain for one.