aeogeo.site

← Docs

This MCP setup doc explains how free scans finish 26 checks in under 10 seconds (ruleset v20).

MCP setup

Endpoint: https://mcp.aeogeo.site — MCP Streamable HTTP, stateless. One URL, three jobs. Tool listing is filtered by API key. /, a Bearer key, and /mcp (sign-in) are auth paths on that server.

Baseline a live page

No key. Call scan_url on a public URL. Free results are grades plus a fix for every failed fundamental (L0–L3). A Pro key returns rule IDs, severity, and evidence, and always fetches the page fresh.

Lint a draft before publish

Pro key, on the copy you are editing. lint_html for HTML, lint_text for markdown, audit_schema for JSON-LD. Each returns per-check results and a fix. get_insights searches the research trend ledger. After the page is deployed, scan_url again. fetch_rules (≤5 per call, daily cap) and search_rules (BM25, same cap) return the full rule when a fix is ambiguous. get_changelog lists rule ids that changed. Scan a whole site with scan_site (sitemap or same-host URL list) and read paged results back with get_site_scan.

Install the habit

No key. Call get_hook_snippet and paste the result into AGENTS.md, a Cursor rule, or a Claude skill.

Cursor

Add to .cursor/mcp.json (project) or user MCP settings:

{
  "mcpServers": {
    "aeogeo": {
      "url": "https://mcp.aeogeo.site"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "aeogeo": {
      "type": "http",
      "url": "https://mcp.aeogeo.site"
    }
  }
}

Also free

Pro key

Checkout emails an ag_live_ key once. /account confirms payment and does not show the key. Send it on every request as Authorization: Bearer plus the key. The environment variable is AEOGEO_API_KEY, the same name as the CI secret. Leave the header off for the free tools.

Cursor

Same .cursor/mcp.json entry, with headers. Cursor fills the token from the environment it was launched in.

{
  "mcpServers": {
    "aeogeo": {
      "url": "https://mcp.aeogeo.site",
      "headers": {
        "Authorization": "Bearer ${env:AEOGEO_API_KEY}"
      }
    }
  }
}

Claude Code

claude mcp add --transport http aeogeo https://mcp.aeogeo.site \
  --header "Authorization: Bearer $AEOGEO_API_KEY"

Claude Desktop

Same file as the free config, with headers. Claude Code fills the token from the environment.

{
  "mcpServers": {
    "aeogeo": {
      "type": "http",
      "url": "https://mcp.aeogeo.site",
      "headers": {
        "Authorization": "Bearer ${AEOGEO_API_KEY}"
      }
    }
  }
}

Updated