Connect AI Assistants to AEO Optima

Why Connect AI Assistants?

AEO Optima exposes a Model Context Protocol (MCP) server with 74 tools that let AI assistants directly access your brand visibility data, capture snapshots, run analyses, manage goals, and generate reports — all from within your AI tool of choice.

Instead of switching between your AI assistant and the AEO Optima dashboard, you can ask questions like:

• "How is my brand visibility trending this month?"
• "Which competitors are gaining on us?"
• "Run a comprehensive AI analysis on my latest snapshot data"
• "Create a goal to reach 60% visibility by Q3"
• "Generate a PDF report for the leadership team"

Your AI assistant handles the query using AEO Optima's data and intelligence engines.

Supported AI Assistants

Quick Setup (Any Client)

Step 1: Generate a Token

1. Log in to AEO Optima
2. Go to Settings → MCP / API
3. Click Generate New Token
4. Choose a role cap (viewer, member, or admin)
5. Copy the token — it starts with aeo_ and is shown only once

Step 2: Configure Your AI Client

Server URL: https://aeo-optima-mcp.onrender.com/mcp

Transport: Streamable HTTP (JSON-RPC over HTTP POST)

Add these to your AI client's MCP configuration:

{
  "mcpServers": {
    "aeo-optima": {
      "url": "https://aeo-optima-mcp.onrender.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer aeo_your_token_here"
      }
    }
  }
}

Step 3: Start Using It

Once connected, your AI assistant has access to 74 tools across these categories:

Client-Specific Setup Guides

Claude Desktop

The simplest setup — supports OAuth for click-to-connect:

1. Open Claude Desktop → Settings → MCP Servers
2. Click Add Server
3. Enter the URL: https://aeo-optima-mcp.onrender.com/mcp
4. Choose OAuth (recommended) or paste your Bearer token
5. Claude will show available tools — you're connected

Claude Code (CLI)

claude mcp add aeo-optima \
  --transport http \
  --url https://aeo-optima-mcp.onrender.com/mcp \
  --header "Authorization: Bearer aeo_your_token_here"

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "aeo-optima": {
      "url": "https://aeo-optima-mcp.onrender.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer aeo_your_token_here"
      }
    }
  }
}

ChatGPT

1. Go to Settings → Developer Mode → MCP Servers
2. Add a new server with the URL and Bearer token
3. ChatGPT will discover all 74 tools automatically

VS Code with Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "aeo-optima": {
      "type": "http",
      "url": "https://aeo-optima-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer aeo_your_token_here"
      }
    }
  }
}

What You Can Do

Monitor Mention Rate & Visibility Score

"What's my mention rate and visibility score, and how have they changed this week?"

The assistant calls get_dashboard_metrics and get_analytics to show your current Mention Rate, composite Visibility Score, sentiment, and week-over-week changes.

Track Competitors

"How does my Share of Voice compare to [competitor]?"

Uses get_analytics with competitor data to show relative positioning, trend direction, and market entropy.

Set and Track Goals

"Set a goal to reach 55% visibility for non-branded queries by September"

Calls create_goal with metric, segment, target, and date. Returns feasibility assessment and auto-computed milestones.

Run Deep Analysis

"Run a comprehensive AI analysis on my last 30 days of data"

Triggers run_analysis with type comprehensive. Returns sentiment drivers, content gaps, and scored opportunities.

Generate Reports

"Generate a standard monthly report as PDF"

Calls generate_report with project, type, format, and period. Returns a download URL and AI Brand Score.

Check Intelligence Scores

"What are my intelligence scores?"

Calls get_intelligence_scores to show all 6 proprietary metrics: Brand Narrative Coherence, Cross-Model Consistency, Market Entropy, Sentiment Drift, Citation Influence, and Entity Authority.

Rate Limits

Rate limits are per-token. If you hit a limit, the server returns HTTP 429 with a Retry-After header.

Security

• All tokens are encrypted at rest
• Tokens have role caps — a viewer token can read data but not modify anything
• OAuth 2.1 with PKCE is supported for browser-based flows
• All API calls are logged in the MCP audit log (viewable in Settings)
• HMAC-SHA256 webhook signatures for outbound events

Related

• MCP API Reference — complete list of 74 tools with parameters and roles
• Webhooks — 11 real-time event types for automation
• API Keys — manage tokens and permissions
• Plans — feature availability by plan tier