MCP SERVER — HOSTING, TOOLS & LIMITS
The Grounded AEO
MCP server.
Connect it to any MCP-capable assistant and it will audit a website for AI citation, hand back the exact fixes, verify they landed, and produce the v=AEO1 record to publish.
Remote & hosted · nothing to install · free · no API key · rate-limited per caller
https://groundedaeo.com/api/mcp
Transport is streamable HTTP, and the server is stateless — every request is self-contained, so there are no sessions to manage. It is hosted on groundedaeo.com itself; there is no separate package to install and nothing runs on your machine.
Note: /mcp (this page) is documentation. The machine endpoint your client connects to is /api/mcp.
Most clients take a config block like this:
{
"mcpServers": {
"grounded-aeo": {
"type": "http",
"url": "https://groundedaeo.com/api/mcp"
}
}
}It is also listed in the official MCP registry as com.groundedaeo/grounded-aeo, and on Smithery (one-click install) and mcp.so.
run_auditWRITECrawls a domain, scores its AI-readability 0–10, lists the gaps, and returns the fix material: ready-to-paste <head> markup and a step-by-step plan (llms.txt, schema, AI-crawler access). Run it again after applying fixes to confirm the score moved.
generate_free_recordWRITEProduces a free, self-declared v=AEO1 DNS TXT record and .well-known/aeo.json for you to publish on your own domain.
check_aeo_recordREADChecks any domain (cataloged or not) for a v=AEO1 record and verifies its Ed25519 signature against the live catalog.
get_company_factsREADReturns the published, owner-attested facts for a cataloged domain, with verification state — the data to ground an answer on.
get_factREADReturns a single verified fact by domain and key.
get_llms_txtREADReturns the auto-generated llms.txt for a cataloged company.
search_catalogREADSearches the catalog by name or domain; up to 10 matches with tier and verification state.
Write actions are rate-limited per caller: 5 audits/hour, 10 free records/hour.
Worth stating plainly, because a tool that overstates itself is worse than one that does less.
It cannot change your site or your DNS.
It returns code and records for you to publish. It never touches your hosting, your repo, or your DNS provider — by design.
It cannot issue a signed or verified record.
generate_free_record produces a self-declared record only: unsigned, unverified. Signed records at listed/verified/grounded require proven domain control and are a paid product.
It cannot tell you a fact is true.
Verification asserts provenance, authenticity, and corroboration depth as of a date — never that a fact is true in the world or stays true afterwards.
It cannot return facts for domains that have not opted in.
Only claimed, consented domains are exposed. Everything else reports as not enrolled and leaks nothing.
It cannot make an AI engine cite you.
It makes you machine-readable and verifiable. No one can promise a citation, and anyone who does is selling something.
It has no memory of you.
The server is stateless and unauthenticated — no accounts, no history, no per-user state. Rate limits are per caller IP.
Where is the MCP server hosted?
On groundedaeo.com itself, at https://groundedaeo.com/api/mcp. It is a remote server using streamable HTTP transport, running stateless — every request is self-contained, there are no sessions. Because it is remote and hosted, there is nothing to install and no package to run locally.
Does it cost anything or need an API key?
No. There is no account, no API key and no signup. Write actions are rate-limited per caller IP (5 audits/hour, 10 free records/hour) — the same limits as the public web forms.
Can it change my website or my DNS for me?
No, and this is deliberate. The server returns code and records for you (or your AI assistant) to publish. It never touches your hosting, your repository or your DNS provider. Nothing it does can modify your infrastructure.
Can it issue a verified or signed record?
No. generate_free_record produces a self-declared record only — unsigned, no verification. Signed records at the listed, verified and grounded tiers are issued after domain control is proven, and are a paid product.
Will it return facts about any business?
No. Only domains whose owner has claimed them and consented are exposed. Anything else reports as not enrolled and leaks nothing. Owner consent is the whole premise of the standard.
Does a verified record mean the facts are true?
No. Verification asserts provenance, authenticity and corroboration depth as of a stated date — not that a fact is true in the world, or that it stays true afterwards. The full public methodology, including what a tier does NOT assert, is at aeorecord.org/methodology.
Building on it, or need a tool the server doesn't expose yet? Tell us — support@aeorecord.org. See also the one-call verification API.
The records this server produces follow v=AEO1, an open standard with a public verification methodology and an IETF Internet-Draft, draft-miller-aeo — a published, citable working document, not an endorsed standard. Records can be verified independently with the open-source aeo-record npm package, with no dependency on this server.