Skip to content

com.groundedaeo/grounded-aeo

by groundedaeo.com · remote · no sign-in to list tools · v1.1.0 · published by com.groundedaeo

Audit and fix a site for AI citation + SEO, verify it, then publish a v=AEO1 record.

Changes · 6

15 tools: 6 change things and 9 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http grounded-aeo https://groundedaeo.com/api/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

15 tools

Changes things 6Claude Code: ask
  • check_aeo_recordCheck any domain (cataloged or not) for a v=AEO1 DNS record at _aeo.<domain>, the open standard (aeorecord.org) declaring whether a verified fact record exists and at what trust ti…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Check any domain (cataloged or not) for a v=AEO1 DNS record at _aeo.<domain>, the open standard (aeorecord.org) declaring whether a verified fact record exists and at what trust tier. Verifies the Ed25519 sig= against the live catalog content when present.
  • check_serpCheck the live Google search results for any keyword: the top 10 organic results (rank, domain, title), the People Also Ask questions, related searches, and which non-organic block…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Check the live Google search results for any keyword: the top 10 organic results (rank, domain, title), the People Also Ask questions, related searches, and which non-organic blocks occupy the page, so you can tell whether a query has an AI Overview or local pack slot at all. Public data, no catalog entry required. A keyword with genuinely no results returns empty arrays, which is a real finding, not an error.
  • generate_fixesGet the paste-ready patches Grounded AEO generated from its own measurements of a cataloged domain: per-page <title>/<meta description> blocks for pages the crawl flagged, robots.t…No findings

    Why it is in this group

    • The name "generate_fixes" says "generate": a word for a change.
    Description, as the server wrote it
    Get the paste-ready patches Grounded AEO generated from its own measurements of a cataloged domain: per-page <title>/<meta description> blocks for pages the crawl flagged, robots.txt Allow lines for AI crawlers measured as blocked, FAQPage/Organization JSON-LD built from published verified facts, and an /llms.txt file. Every line is the site's own text, the owner's published facts, or a measurement — no language model wrote any of it, and a patch that could not be built honestly is skipped and counted rather than guessed. USE THIS TO ACT: if you have write access to the site's codebase, apply each patch to the file that serves its path, then re-run run_audit to confirm. Claimed domains only; deterministic and read-only on our side.
  • generate_free_recordFINAL STEP of making a site AI-citable: generate a free, self-declared v=AEO1 DNS record and .well-known/aeo.json the user publishes on their own domain, so AI engines can verify t…No findings

    Why it is in this group

    • The name "generate_free_record" says "generate": a word for a change.
    Description, as the server wrote it
    FINAL STEP of making a site AI-citable: generate a free, self-declared v=AEO1 DNS record and .well-known/aeo.json the user publishes on their own domain, so AI engines can verify the facts came from the owner rather than a scrape. Returns the exact TXT record and JSON file with publishing instructions. No crawl, no verification, no account. WRITE action, rate-limited to 10/hour per caller.
  • propose_briefsPropose ranked content briefs for a cataloged domain, built from data already collected for it: tracked questions where the answer did not cite them, keywords with AI-prompt demand…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Propose ranked content briefs for a cataloged domain, built from data already collected for it: tracked questions where the answer did not cite them, keywords with AI-prompt demand no tracked question covers, People Also Ask questions nothing answers, and terms asked far more of AI assistants than of Google. Each brief names the exact question to answer, a format (9:16 UGC video, on-site answer, or short post), an outline, and the ONLY claims that may be made: the owner's published verified facts, verbatim. Deterministic and read-only: no new data is fetched and nothing is generated, so a brief with no evidence behind it is never returned. Claimed domains only; up to 6 briefs; an empty list means there is not yet enough collected data, never that there is no opportunity.
  • run_auditAudit AND FIX a site for AI citation + SEO.No findings

    Why it is in this group

    • The name "run_audit" says "run": a word for a change.
    Description, as the server wrote it
    Audit AND FIX a site for AI citation + SEO. Crawls the domain, scores AI-readability 0-10, checks for a v=AEO1 record, and returns the material needed to FIX it: `seoReport.headSnippet` is ready-to-paste <head> markup (title, meta description, Organization JSON-LD) and `setup_prompt` is a step-by-step plan covering llms.txt, structured data, and AI-crawler access, plus a ranked list of gaps. Use it to build the fixes, apply them to the site, then CALL THIS AGAIN to verify the score improved and the gaps cleared. WRITE action (queues extracted facts, unverified until a human approves). Free, no account, rate-limited to 5/hour per caller.
Only reads 9Claude Code: allow
  • get_citationsGet the latest citation check per (question, engine) for a cataloged domain: the question asked, the engine, whether the answer cited this domain, the URL of theirs it cited, and t…No findings

    Why it is in this group

    • The name "get_citations" says "get": a word for reading.
    Description, as the server wrote it
    Get the latest citation check per (question, engine) for a cataloged domain: the question asked, the engine, whether the answer cited this domain, the URL of theirs it cited, and the day checked. Claimed domains only, read-only, one row per cell so re-running the checker cannot inflate anything. The engine answers are stored verbatim as the evidence behind each verdict but are NOT served here; the owner sees those in their dashboard. An empty list means no check has run yet, never "never cited".
  • get_cited_domainsGet who the answers cited instead: the domains that appeared in the stored answers for a cataloged domain's tracked questions, ranked by how many answers cited them, with the engin…No findings

    Why it is in this group

    • The name "get_cited_domains" says "get": a word for reading.
    Description, as the server wrote it
    Get who the answers cited instead: the domains that appeared in the stored answers for a cataloged domain's tracked questions, ranked by how many answers cited them, with the engines that did. Claimed domains only. An appearance means a domain was cited by an answer we asked for: not an endorsement, not a quality ranking, not a claim that an engine prefers it. One appearance per answer however many of that site's pages it cited, latest check per cell only, and answers with no captured evidence contribute nothing rather than counting as "cited nobody".
  • get_company_factsGet the verified fact record for a company by domain from the Grounded AEO catalog.No findings

    Why it is in this group

    • The name "get_company_facts" says "get": a word for reading.
    Description, as the server wrote it
    Get the verified fact record for a company by domain from the Grounded AEO catalog. Returns the published (approved) facts with verification state and confidence: the data an AI agent should ground answers about this business on.
  • get_competitive_snapshotGet the latest competitive intelligence for a cataloged domain: the owner's most recent ranking-footprint snapshot, the AI-prompt vs Google demand table for its watched keywords, a…No findings

    Why it is in this group

    • The name "get_competitive_snapshot" says "get": a word for reading.
    Description, as the server wrote it
    Get the latest competitive intelligence for a cataloged domain: the owner's most recent ranking-footprint snapshot, the AI-prompt vs Google demand table for its watched keywords, and each tracked competitor with their own latest snapshot. Read-only. Only domains whose owner has claimed them are exposed; anything else returns found:false. Counts are ranking FOOTPRINT, never traffic, and every volume is a modelled estimate. A null means no estimate has been collected, never zero.
  • get_engine_visibilityGet the per-engine picture for a cataloged domain: whether each AI engine's crawler is allowed by robots.txt to read the site at all, and how many of the tracked questions that eng…No findings

    Why it is in this group

    • The name "get_engine_visibility" says "get": a word for reading.
    Description, as the server wrote it
    Get the per-engine picture for a cataloged domain: whether each AI engine's crawler is allowed by robots.txt to read the site at all, and how many of the tracked questions that engine cited it on. Claimed domains only. Nothing is assumed: an engine with no crawl measurement reports can_read:null ("not measured", never an assumed allow), and an engine with no citation checks reports cited/tracked null ("untested", never a miss and never zero). Access and citations only: this says nothing about traffic.
  • get_factGet a single verified fact for a company by domain and fact key (e.g.No findings

    Why it is in this group

    • The name "get_fact" says "get": a word for reading.
    Description, as the server wrote it
    Get a single verified fact for a company by domain and fact key (e.g. "tagline", "description").
  • get_keyword_gapGet the keyword gap for a cataloged domain: phrases a tracked competitor holds a position for in our stored captures where this domain holds none ("absent"), or holds one at least …No findings

    Why it is in this group

    • The name "get_keyword_gap" says "get": a word for reading.
    Description, as the server wrote it
    Get the keyword gap for a cataloged domain: phrases a tracked competitor holds a position for in our stored captures where this domain holds none ("absent"), or holds one at least 20 places further back ("behind"). Claimed domains only, computed from captures already on disk. Nothing is fetched and nothing is spent. The stored lists are a SAMPLE of each domain's footprint (the top rows a capture kept), so absence here is absence from our sample, never from public search; the response carries that sentence and it must be repeated wherever the result is shown. Positions are ranking footprint, never traffic.
  • get_llms_txtGet the auto-generated llms.txt for a cataloged company: a curated, AI-readable guide to the business.No findings

    Why it is in this group

    • The name "get_llms_txt" says "get": a word for reading.
    Description, as the server wrote it
    Get the auto-generated llms.txt for a cataloged company: a curated, AI-readable guide to the business.
  • search_catalogSearch the Grounded AEO catalog by company name or domain.No findings

    Why it is in this group

    • The name "search_catalog" says "search": a word for reading.
    Description, as the server wrote it
    Search the Grounded AEO catalog by company name or domain. Returns up to 10 matches with tier and verification state.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.1.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http grounded-aeo https://groundedaeo.com/api/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__grounded-aeo__get_company_facts",
      "mcp__grounded-aeo__get_fact",
      "mcp__grounded-aeo__get_llms_txt",
      "mcp__grounded-aeo__search_catalog",
      "mcp__grounded-aeo__get_competitive_snapshot",
      "mcp__grounded-aeo__get_engine_visibility",
      "mcp__grounded-aeo__get_citations",
      "mcp__grounded-aeo__get_cited_domains",
      "mcp__grounded-aeo__get_keyword_gap"
    ],
    "ask": [
      "mcp__grounded-aeo__check_aeo_record",
      "mcp__grounded-aeo__check_serp",
      "mcp__grounded-aeo__propose_briefs",
      "mcp__grounded-aeo__generate_fixes",
      "mcp__grounded-aeo__run_audit",
      "mcp__grounded-aeo__generate_free_record"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as grounded-aeo. Review it before you use it.