← Docs

Connect an MCP client to aeogeo: the free address, a Pro key in a header, or Pro sign-in (OAuth) at /mcp. Streamable HTTP, stateless.

MCP setup

MCP Streamable HTTP, stateless. One server, three jobs, and two addresses. Which one you add decides what you get:

If your client says "connects without auth", or you see only six tools, you added the bare address, which is the free tier. Switch the entry to /mcp to sign in, or add the key header. Clients decide this by probing the address: / answers without a key, /mcp answers with a sign-in challenge.

Listed in the official MCP Registry as site.aeogeo/aeogeo, with both addresses (registry entry, JSON). The name is tied to the aeogeo.site domain, so a server listed under it is ours.

New here? plan_audit is free: give it your goal, target and limits and it returns the ordered tool calls for your plan, with the quota each costs. Prompts (audit_page, audit_site, pre_publish, research_topic) and resources (aeogeo://playbook/audit, semantic-rubric, limits) ship in the server for clients that surface them.

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, split into advice, source and format-only changes; re-check pages only for the advice changes. 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 Code

Add to .mcp.json in the project, or run claude mcp add --transport http aeogeo https://mcp.aeogeo.site:

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

Claude Desktop

Claude Desktop adds remote servers as connectors, not in claude_desktop_config.json (that file is for local servers). Open Settings → Connectors → Add custom connector, name it aeogeo, and paste https://mcp.aeogeo.site/mcp. Click Connect and sign in with the email you used at checkout. For the free tools only, paste https://mcp.aeogeo.site and skip the sign-in.

Toolport and other OAuth clients

Any client that discovers OAuth from the server works the same way: add https://mcp.aeogeo.site/mcp and follow its sign-in prompt. The server publishes standard OAuth discovery metadata and dynamic client registration. If the client reports "no token needed", it was given the bare address; use /mcp.

Codex

Run codex mcp add aeogeo --url https://mcp.aeogeo.site/mcp. Codex opens your browser to sign in with the email you used at checkout, and codex mcp login aeogeo signs in again later. With an API key instead, export it as AEOGEO_API_KEY and run:

codex mcp add aeogeo --url https://mcp.aeogeo.site \
  --bearer-token-env-var AEOGEO_API_KEY

For the free tools only, use --url https://mcp.aeogeo.site with no key. Each command writes an [mcp_servers.aeogeo] entry to ~/.codex/config.toml; codex mcp list shows how it signs in. Codex availability depends on your OpenAI plan. In the ChatGPT app, pasting instructions into a custom GPT does not connect any tools.

Also free

• list_categories — category counts, before you fetch rules
• fetch_sample_rules — up to 20 teaser rules, no evidence or remediation

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. Clients that sign in with OAuth at /mcp need no key.

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

Connectors sign in with OAuth instead of a pasted key. Add the connector with https://mcp.aeogeo.site/mcp, click Connect, and sign in with the email you used at checkout. The connector gets your plan's tools; no key is pasted anywhere.