AgentAEO MCP Server

@agentaeo/mcp-server

MCP (Model Context Protocol) server for AgentAEO — run AEO (Answer Engine Optimization) audits across ChatGPT, Perplexity, Claude, and Google AI.

Source: `agentaeo/agentaeo-mcp-server` on GitHub (local folder name: agentaeo-mcp-server).

Installation

npm install -g @agentaeo/mcp-server
# or
npx @agentaeo/mcp-server

Configuration

Set your API key (get one at agentaeo.com/agents):

export AGENTAEO_API_KEY=your_api_key_here

Claude Desktop

Config file on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

After publishing to npm (recommended)

{
  "mcpServers": {
    "agentaeo": {
      "command": "npx",
      "args": ["-y", "@agentaeo/mcp-server"],
      "env": {
        "AGENTAEO_API_KEY": "your_api_key_here"
      }
    }
  }
}

-y skips npx’s “Ok to proceed?” prompt (important for GUI-launched processes).

Local dev (before publish)

Prefer node + dist/index.js — npx + a local .tgz often breaks in Claude Desktop (npm path bugs, “tarball corrupted”, or Permission denied when the shell mishandles the archive). Avoid .tgz in the MCP config unless you’ve verified it on your machine.

1. In the repo: npm install and npm run build (must produce dist/index.js).
2. Use your real AgentAEO key in AGENTAEO_API_KEY (not the literal text your_real_key_here).

Recommended — node + absolute path to dist/index.js:

{
  "mcpServers": {
    "agentaeo": {
      "command": "node",
      "args": ["/Users/aashishn/agents/agentaeo-mcp-server/dist/index.js"],
      "env": {
        "AGENTAEO_API_KEY": "paste_your_agentaeo_live_key_here"
      }
    }
  }
}

If node is not on Claude’s PATH (e.g. only nvm), use the full path to node, e.g. "/Users/aashishn/.nvm/versions/node/v22.16.0/bin/node" as command and the same args for dist/index.js.

Optional — tarball via npx (only if node works from Terminal but you prefer npx): some setups need file: prefix — ask in Terminal first:
npx -y file:/Users/aashishn/agents/agentaeo-mcp-server/agentaeo-mcp-server-0.1.0.tgz — if that fails, stick to node + dist.

After editing the config, fully quit Claude Desktop (Cmd+Q) and reopen. Check Settings → Developer → Local MCP servers for a green status.

Tools

Env (optional): AGENTAEO_MCP_INLINE_POLL=1 — long poll inside run_aeo_audit. AGENTAEO_MCP_INLINE_CONTENT_POLL=1 — long poll inside generate_aeo_content_suite (both can exceed Claude Desktop’s ~60s tool limit). AGENTAEO_MCP_DOWNLOAD_DIR — where to save Content Suite ZIPs from download_aeo_content_suite_zip.

Terminal: download-content.mjs — set ORDER_ID (completed content order UUID), AGENTAEO_API_KEY (or read from Claude Desktop config on Mac); optional OUT_FILE.

Why your agent can’t `curl` with `$AGENTAEO_API_KEY`

Sandbox VMs (e.g. Cowork) do not load claude_desktop_config.json and do not inherit your laptop’s shell export. Only processes started with that env (e.g. this MCP server) have the key. Use generate_aeo_content_suite from Claude Desktop with MCP enabled, or paste the key into the sandbox’s own secrets/env if the product supports it.

Example

Ask Claude: "Run a free AEO audit for agentaeo.com with keyword 'AI search visibility'"

Then: "Check the status of that audit" (Claude will use the returned auditId)

Requirements

• Node.js 18+
• AgentAEO API key from [agentaeo.com/agents](http