# aeogeo.site — llms.txt

> The living rulebook for being cited by AI. One MCP URL, deterministic AEO/GEO checks, evidence-linked rules.

## When to use

Use aeogeo.site when your agent needs to:

- **Lint before publish** — run deterministic AEO/GEO checks on HTML or markdown before shipping a page or PR (keyed `lint_html` / `lint_text` via MCP, or `scan_url` without a key for grades plus fixes to failed fundamentals).
- **Fetch current AEO/GEO rules** — pull the live ruleset (teaser samples free; JIT full rules with a Pro key) instead of guessing from stale blog posts.
- **Gate CI** — add the GitHub Action or MCP `scan_url` step so merges fail when structure, answerability, or schema checks regress.

Connect MCP at **https://mcp.aeogeo.site** (Streamable HTTP). One URL, three jobs: baseline a live page with no key (`scan_url`), lint a draft before publish with a Bearer key (`lint_html`, `lint_text`, `audit_schema`), install the habit with `get_hook_snippet`. `/`, Bearer, and `/mcp` are auth paths for that same server.

## Discovery URLs

- [Docs](https://aeogeo.site/docs/): Agent-first setup (MCP, AGENTS.md, CI)
- [Sitemap](https://aeogeo.site/sitemap.xml): All public routes
- [MCP endpoint](https://mcp.aeogeo.site): Streamable HTTP server
- [MCP well-known](https://aeogeo.site/.well-known/mcp.json): Machine-readable MCP card (apex)
- [REST OpenAPI](https://aeogeo.site/openapi.json): Public OpenAPI 3 spec for `POST /api/scan`, `GET /api/checks`, `GET /api/rules` (also at https://aeogeo.site/api/openapi.json)
- [Rules](https://aeogeo.site/rules/): Teaser rule pages from the live ruleset export
- [Privacy](https://aeogeo.site/privacy/): Waitlist data handling

## Product

- [Home](https://aeogeo.site/): Waitlist and overview
- [Pricing](https://aeogeo.site/pricing/): Flat subscription (coming soon)

## Markdown

Docs, rules, and trust pages negotiate content: send `Accept: text/markdown` and you get the same article as clean `.md` (no nav/footer chrome) with `Vary: Accept` — e.g. `curl -sI -H "Accept: text/markdown" https://aeogeo.site/docs/mcp` returns `Content-Type: text/markdown; charset=utf-8`.

## For agents

- MCP endpoint: https://mcp.aeogeo.site (Streamable HTTP)
- Free tools: scan_url (grades + L0-L3 fixes), list_categories, fetch_sample_rules, get_hook_snippet, export_report (shareable report link)
- Keyed tools: lint_html, lint_text, audit_schema, fetch_rules (JIT, capped), search_rules, get_insights, get_changelog, set_retention_webhook, scan_site + get_site_scan (whole-site scans, paged results)