# Grounded AEO

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 571 installs
- Author: garrett-miller
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/garrett-miller/grounded-aeo
- Updated: 2026-07-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/grounded-aeo

## What it 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.

## Requirements
- Remote server: `https://grounded-aeo--garrett-miller.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http grounded-aeo https://grounded-aeo--garrett-miller.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add grounded-aeo --url https://grounded-aeo--garrett-miller.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "grounded-aeo": {
            "url": "https://grounded-aeo--garrett-miller.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "grounded-aeo": {
            "type": "http",
            "url": "https://grounded-aeo--garrett-miller.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http grounded-aeo https://grounded-aeo--garrett-miller.run.tools
```

## When to use it
- score a site from 0 to 10 for AI readability
- drop in a prepared `<head>` block with Organization JSON-LD
- publish a `v=AEO1` DNS record and `.well-known/aeo.json`
- check any domain for an `_aeo` record
- ground an answer in owner-verified company facts

## Example prompts
- Run `run_audit` on my domain and tell me which gaps to fix first.
- Generate the record with `generate_free_record` and show me where the `.well-known/aeo.json` file goes.
- Pull `get_company_facts` for the domain and write the company blurb from those facts only.

## Similar
- [seo-aeo-geo](https://affpapa.org/en/nevibecode/skills/seo-aeo-geo.md) — skill · 381 installs
- [revnu-ai-readiness-audit](https://affpapa.org/en/nevibecode/skills/revnu-ai-readiness-audit.md) — skill · 3500 installs
- [seo-aeo-best-practices](https://affpapa.org/en/nevibecode/skills/seo-aeo-best-practices.md) — skill · 7900 installs
- [bencium-aeo](https://affpapa.org/en/nevibecode/skills/bencium-aeo.md) — skill · 3600 installs
- [schema](https://affpapa.org/en/nevibecode/skills/schema.md) — skill · 91700 installs
- [seo-schema](https://affpapa.org/en/nevibecode/skills/seo-schema.md) — skill · 8200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
