MCP Setup

Step 1: Install

The MCP server is distributed as an npm package. Install it globally or as a project dependency.

npm install -g @aeo/mcp

Step 2: Configure Claude Code

Add the server to your Claude Code MCP configuration. Create or edit the .mcp.json file in your project root:

{
  class="code-string">"mcpServers": {
    class="code-string">"aeo": {
      class="code-string">"command": class="code-string">"npx",
      class="code-string">"args": [class="code-string">"-y", class="code-string">"@aeo/mcp"],
      class="code-string">"env": {
        class="code-string">"AEO_API_KEY": class="code-string">"aeo_live_your_key_here"
      }
    }
  }
}

Step 2 (alt): Configure Cursor

For Cursor, add the same configuration to your project or global MCP settings file.

{
  class="code-string">"mcpServers": {
    class="code-string">"aeo": {
      class="code-string">"command": class="code-string">"npx",
      class="code-string">"args": [class="code-string">"-y", class="code-string">"@aeo/mcp"],
      class="code-string">"env": {
        class="code-string">"AEO_API_KEY": class="code-string">"aeo_live_your_key_here"
      }
    }
  }
}

Step 3: First Tool Call

With the server configured, you can use AEO tools directly in your AI agent conversation. Try these prompts:

Available Tools

The MCP server exposes 48 tools across 10 categories. See the full reference for schemas and parameters:

• Audit Tools (6) - get, list, submit, status, opportunities, benchmarks
• Visibility Tools (2) - search reports, timeline tracking
• Content Tools (5) - topics, articles, benchmarks, pipelines
• Client Tools (7) - profiles, articles, CMS publishing
• Article Pipeline (7) - create, write, rewrite, review blocks
• Cluster Tools (7) - create, manage, suggest content clusters
• Organization Tools (8) - projects, groups, folders, move articles
• WordPress Tools (2) - list and import WordPress content
• Template Tools (2) - save and list article templates
• Media Tools (1) - generate images for articles