Agents Setup

Connect AEKO Agents to Claude Desktop, Cursor, or Claude Code via MCP.

8 min read

What Are AEKO Agents

AEKO Agents use MCP (Model Context Protocol) to let AI assistants like Claude connect to AEKO's tools and data. Once installed, Claude gets direct access to your visibility data, optimization suggestions, and content generation tools.

This means Claude can analyze your AEO data, generate optimized content, and help implement suggestions — all within Claude Desktop, Cursor, or Claude Code.

AEKO Agents connect through your AEKO account sign-in. Starter users can authenticate, but AEKO Agents require Growth or above to use.

Status

This setup guide now reflects the login-based flow. Growth+ users can mint a short-lived agent token from the AEKO app and connect directly in Codex or Claude.

Claude Desktop Setup

Connect the AEKO Agent to Claude Desktop in four steps.

Step 1. Install the plugin:

pip install aeko-mcp

Step 2. The AEKO connection flow is being updated to account sign-in. Install the package now, then follow the latest guide on the Agents page:

# Install the package
pip install aeko-mcp

# Then use the updated sign-in flow described at
# https://aeko-intelligence.com/agents

Step 3. Restart Claude Desktop.

Step 4. Verify that AEKO tools appear in the tool list.

Config File Location

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor Setup

Set up the AEKO Agent in Cursor IDE.

Setup Steps

Step 1. Install: pip install aeko-mcp
Step 2. Open Cursor Settings → MCP → Add new MCP server
Step 3. Sign in with your AEKO account when the updated connection prompt appears
Step 4. Restart Cursor

Claude Code Setup

Set up the AEKO Agent in Claude Code (CLI).

Step 1. Install:

pip install aeko-mcp

Step 2. Authenticate with your AEKO account once the updated Claude Code connection flow is available:

# Install
pip install aeko-mcp

# Then sign in with your AEKO account when prompted by the updated MCP flow

Step 3. Restart your Claude Code session.

Available Tools

The AEKO Agent provides 16 tools organized in 3 groups.

Data Tools (8)

Tool	Description
`get_domain_overview`	Domain visibility summary
`get_prompts`	List tracked prompts
`get_prompt_results`	Results for a specific prompt
`get_suggestions`	Optimization suggestions
`get_sources`	Cited source URLs
`get_competitors`	Competitor analysis
`get_product_analyses`	Product visibility data
`get_drift_events`	Mention changes over time

Generation Tools (3)

Tool	Description
`prepare_llms_txt`	Generate llms.txt content
`prepare_robots_txt_fix`	Suggest robots.txt improvements
`prepare_json_ld`	Generate JSON-LD structured data

File Tools (5)

Tool	Description
`list_product_images`	List available product images
`read_product_image`	Read a product image
`save_content`	Save generated content to file
`read_file`	Read a file from the output directory
`list_files`	List files in the output directory

Available Skills

Skills are high-level workflows that combine multiple tools. Mention a skill name to Claude and it runs automatically.

Skill	Description
`aeo-audit`	Comprehensive AEO audit of your domain
`aeo-optimize`	Generate optimization plan
`generate-faq`	Create FAQ content from prompt data
`generate-jsonld`	Generate JSON-LD structured data
`create-blog-article`	Write blog articles using visibility insights
`create-social-content`	Create social media content
`create-marketing-materials`	Generate marketing materials

Example Workflow

A practical example of using AEKO Agents end-to-end.

Example: AEO Audit and Blog Writing

Ask Claude: "Run an AEO audit for my domain"
Claude runs get_domain_overview and get_suggestions
Claude analyzes and reports improvements by priority
Ask Claude: "Write a blog article about [topic] based on my competitive gaps"
Claude uses get_competitors, get_prompt_results, and save_content
Review the generated content and publish

Optimization Suggestions

Subscription Plans