# com.groundedaeo/grounded-aeo (remote · groundedaeo.com)

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

- Trust score: 63/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `groundedaeo.com`: 63/100 (this document), [markdown](https://verifymcp.io/servers/com-groundedaeo-grounded-aeo/api-mcp.md), [page](https://verifymcp.io/servers/com-groundedaeo-grounded-aeo/api-mcp)

## Channel facts

- Endpoint: `https://groundedaeo.com/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.1.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 14 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 62/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2270 tokens (~162/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 87/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 60% of tool parameters carry a description.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### Claude

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

### Codex

```toml
[mcp_servers.com-groundedaeo-grounded-aeo]
url = "https://groundedaeo.com/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-groundedaeo-grounded-aeo": {
      "type": "remote",
      "url": "https://groundedaeo.com/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-groundedaeo-grounded-aeo --url https://groundedaeo.com/api/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-groundedaeo-grounded-aeo:
    url: "https://groundedaeo.com/api/mcp"
```

### Other

```json
{
  "mcpServers": {
    "com-groundedaeo-grounded-aeo": {
      "type": "http",
      "url": "https://groundedaeo.com/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 63, +1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “check_aeo_record” rewrote its description, which is the text the model reads
- [security] Tool “check_serp” rewrote its description, which is the text the model reads
- [security] Tool “get_company_facts” rewrote its description, which is the text the model reads
- [security] Tool “get_competitive_snapshot” rewrote its description, which is the text the model reads
- [security] Tool “get_llms_txt” rewrote its description, which is the text the model reads
- [security] Tool “propose_briefs” rewrote its description, which is the text the model reads
- [security] Tool “run_audit” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 1532 → 2270
- [functional improvement] Tool coverage: 50% → 60%
- [functional] New tool “get_citations”
- [functional] New tool “get_cited_domains”
- [functional] New tool “get_engine_visibility”
- [functional] New tool “get_keyword_gap”

### 2026-08-02 (score 62, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional regression] Schema quality: 125 → 153
- [functional improvement] Tool coverage: 38% → 50%
- [functional] New tool “propose_briefs”
- [functional] New tool “check_serp”
- [functional] New tool “get_competitive_snapshot”

### 2026-08-01 (score 62, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 61, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 59, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 60, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 59, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 58)

First indexed and scored.

## MCP tools (14)

### `get_company_facts` (~70 tokens)

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.

Input parameters:

- `domain` (string, required): Company domain, e.g. acme.com

### `get_fact` (~55 tokens)

Get a single verified fact for a company by domain and fact key (e.g. "tagline", "description").

Input parameters:

- `domain` (string, required)
- `key` (string, required): Fact key, e.g. "tagline"

### `get_llms_txt` (~40 tokens)

Get the auto-generated llms.txt for a cataloged company: a curated, AI-readable guide to the business.

Input parameters:

- `domain` (string, required)

### `check_aeo_record` (~80 tokens)

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.

Input parameters:

- `domain` (string, required)

### `check_serp` (~115 tokens)

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.

Input parameters:

- `keyword` (string, required): Search query, e.g. "roof repair denver"

### `search_catalog` (~44 tokens)

Search the Grounded AEO catalog by company name or domain. Returns up to 10 matches with tier and verification state.

Input parameters:

- `query` (string, required): Name or domain fragment

### `get_competitive_snapshot` (~119 tokens)

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.

Input parameters:

- `domain` (string, required): Company domain, e.g. acme.com

### `propose_briefs` (~191 tokens)

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.

Input parameters:

- `domain` (string, required): Company domain, e.g. acme.com

### `get_engine_visibility` (~129 tokens)

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.

Input parameters:

- `domain` (string, required): Company domain, e.g. acme.com

### `get_citations` (~131 tokens)

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".

Input parameters:

- `domain` (string, required): Company domain, e.g. acme.com

### `get_cited_domains` (~137 tokens)

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".

Input parameters:

- `domain` (string, required): Company domain, e.g. acme.com

### `get_keyword_gap` (~146 tokens)

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.

Input parameters:

- `domain` (string, required): Company domain, e.g. acme.com

### `run_audit` (~183 tokens)

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.

Input parameters:

- `domain` (string, required): Domain to audit, e.g. acme.com

### `generate_free_record` (~142 tokens)

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.

Input parameters:

- `address` (string)
- `category` (string)
- `domain` (string, required)
- `hours` (string)
- `name` (string, required): Business name
- `services` (array)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-groundedaeo-grounded-aeo/api-mcp#diagnostics

## Score history

- 2026-08-03: 63
- 2026-08-02: 62
- 2026-08-01: 62
- 2026-07-31: 61
- 2026-07-30: 59
- 2026-07-29: 60
- 2026-07-28: 60
- 2026-07-27: 59
- 2026-07-26: 58

## Links

- Remote endpoint: https://groundedaeo.com/api/mcp
- Changelog RSS feed: https://verifymcp.io/servers/com-groundedaeo-grounded-aeo/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-groundedaeo-grounded-aeo/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-groundedaeo-grounded-aeo/api-mcp