@tryaeos/mcp

MCP server for AEOS — analyze and improve AI discoverability (SEO/AEO/GEO) from Cursor, Claude Desktop, or any MCP host.

Agent mode: the MCP server never calls OpenAI/Anthropic/etc. Your host agent's LLM does the creative work; AEOS handles analysis, validation, file writes, and dashboard sync.

Setup

Add to ~/.cursor/mcp.json or Claude Desktop config:

{
  "mcpServers": {
    "discoverability": {
      "command": "npx",
      "args": ["-y", "@tryaeos/mcp"],
      "env": {
        "DISCOVERABILITY_API_KEY": "sk_live_…",
        "DISCOVERABILITY_API_URL": "https://api.tryaeos.com"
      }
    }
  }
}

Get DISCOVERABILITY_API_KEY from the AEOS dashboard (Project → API Keys).

Tools

| Tool | Provider key? | Purpose | | ------------------ | ------------- | ------------------------------------ | | analyze | No | Local repo audit (read-only) | | analyze_url | No | Live URL crawl + audit | | sync | No | Fetch cloud project context | | fix_plan | No | Next fix task + prompts for your LLM | | fix_apply_patch | No | Apply PatchPlan JSON from your LLM | | optimize_prepare | No | Optimization brief + JSON schema | | optimize_submit | No | Upload agent-produced suggestions | | generate_prepare | No | Content briefs per type | | generate_submit | No | Write agent-produced content files |

Agent playbook

Fix discoverability issues

1. Call fix_plan with { "dir": "/absolute/path/to/repo" }.
2. If done is false, use prompt.systemMessage + prompt.userMessage with your model. Produce JSON matching prompt.responseContract.
3. Call fix_apply_patch with { "dir": "…", "patch": { … } }.
4. Repeat from step 1 (or use next in the apply response) until done is true.

Content optimization (advisory)

1. optimize_prepare → run LLM with returned prompts → optimize_submit.

Generate content files

1. generate_prepare → run LLM per brief → generate_submit.

CLI vs MCP

| | CLI (@tryaeos/cli) | MCP (@tryaeos/mcp) | | -------- | -------------------------------------- | ------------------------------- | | LLM | Your ANTHROPIC_API_KEY / etc. | Host agent (Cursor/Claude plan) | | Fix flow | Fully autonomous discoverability fix | Prepare/submit loop | | Best for | Terminal, CI | IDE assistants |

Development

pnpm --filter @tryaeos/mcp dev
pnpm --filter @tryaeos/mcp test
pnpm --filter @tryaeos/mcp build