MCPBeginner

MCP Setup

Install the AEO Content AI MCP server and configure Claude Code or Cursor to use AEO tools directly.

Step 1: Install

The MCP server (@aeo/mcp-server) ships with the AEO Content AI platform; npm publication is pending. Once available on npm, install it globally or as a project dependency.

bash

npm install -g @aeo/mcp-server

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:

.mcp.json

{
  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-server"],
      class="code-string">"env": {
        class="code-string">"AEO_API_KEY": class="code-string">"aeo_live_your_key_here"
      }
    }
  }
}

Store your API key in an environment variable instead of hardcoding it. Use AEO_API_KEY from your shell environment and omit the env block.

Step 2 (alt): Configure Cursor

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

Cursor MCP settings

{
  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-server"],
      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:

"Get the AEO audit for stripe.com"aeo_get_audit

"List all available audits"aeo_list_audits

"Check the visibility report for notion.com"aeo_search_visibility

"What are the benchmark rankings for developer tools?"aeo_get_benchmarks

Available Tools

The MCP server exposes 59 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