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, Cursor, and Codex connect directly to AEKO's tools and data. Once installed, you can run visibility analysis, optimization suggestions, and content workflows from inside your IDE or desktop app.

Setup has two parts — the MCP connector (data access) and the aeko-plugin marketplace (13 skills). Verify the install at the end with /aeko-onboarding.

AEKO Agents connect through your AEKO account sign-in. Any active subscription plan (Starter / Pro / Enterprise) can use them. Adding the MCP connector opens your browser for a one-click OAuth sign-in — no tokens to copy or paste.

Claude Desktop Setup

Use AEKO as a remote connector in Claude Desktop.

Step 1. Open Claude Desktop and go to Settings → Connectors.

Step 2. Click Add custom connector and add this URL:

https://aeko-intelligence.com/mcp

Step 3. Save it, click Connect, sign in to AEKO in the browser, and approve access.

Step 4. Enable the connector in your chat and verify that AEKO tools appear.

Cursor Setup

Set up the AEKO Agent in Cursor IDE.

Setup Steps

Step 1. Open Cursor Settings → MCP → Add new MCP server
Step 2. Transport: http, URL: https://aeko-intelligence.com/mcp
Step 3. Save — your browser opens for AEKO sign-in + access approval
Step 4. Restart Cursor — AEKO tools become available in chat

Claude Code Setup

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

Step 1. Run in your terminal:

claude mcp add --transport http aeko https://aeko-intelligence.com/mcp

Step 2. Your browser opens for AEKO sign-in + access approval.

Step 3. In a Claude Code session, run /mcp to confirm the connection.

Codex CLI Setup

Step 1. Run in your terminal:

codex mcp add --transport http aeko https://aeko-intelligence.com/mcp

Step 2. One-click OAuth sign-in via your browser.

Step 3. Restart your Codex session.

Install the AEKO Plugin (13 Skills)

The MCP connector gives you data access; aeko-plugin gives you 13 workflow skills (slash-commands). Run inside a Claude Code or Codex session.

/plugin marketplace add AEKO-Intelligence/aeko-plugin
/plugin install aeko-plugin@AEKO-Intelligence/aeko-plugin

Source: github.com/AEKO-Intelligence/aeko-plugin

Verify the install

After the plugin install, run /aeko-onboarding. It tours the 13 skills, confirms your MCP is connected, and helps you customize the executor skills (aeko-create-content, aeko-update-pdp, aeko-fix-technical) with your brand voice.

Available MCP Tools

The MCP connector exposes 30+ tools. Skills call them automatically — you rarely need to invoke them by name.

Visibility & Data

Tool	Description
`aeko_list_domains`	List connected domains
`aeko_get_domain_info`	Domain metadata + status
`aeko_get_score`	AEKO Score (visibility metric)
`aeko_get_visibility_summary`	Mentions, citations, sentiment summary
`aeko_get_brand_kit`	Brand kit (tone, audience, forbidden)
`aeko_get_product_description`	Product description + meta
`aeko_list_store_integrations`	Connected stores (Shopify, Cafe24, etc.)

Prompt Tracking & Research

Tool	Description
`aeko_get_tracked_prompts`	List tracked prompts
`aeko_get_tracked_prompt`	Single prompt — responses + citation forensics
`aeko_search_research_prompts`	Search the prompt library
`aeko_track_prompt`	Start tracking a new prompt
`aeko_untrack_prompt`	Stop tracking

Action Plans

Tool	Description
`aeko_list_action_items`	PDP + content improvement guides
`aeko_list_technical_items`	Technical fix items
`aeko_get_action_plan`	Plan.md for a single action
`aeko_complete_action_item`	Mark an action complete

Writes (brand kit, product, store)

Tool	Description
`aeko_update_brand_kit`	Edit brand kit fields
`aeko_update_product_description`	Update product description
`aeko_update_product_meta`	Update product meta fields
`aeko_update_product_tags`	Update product tags
`aeko_list_store_writes`	Audit log of store writes
`aeko_revert_store_write`	Revert a store write

Available Skills (13)

Skills are slash-command workflows that combine multiple tools. Invoke them as /aeko-....

Group	Skill	Description
Start here	`/aeko-onboarding`	Verify install + tour skills + customize
Start here	`/aeko-action-center`	Router for all pending work
Visibility & research	`/aeko-visibility-report`	Score, mentions, citations, sentiment over a window
	`/aeko-prompt-deep-dive`	Per-platform forensics for one tracked prompt
	`/aeko-find-prompts-to-track`	Discover and track prompts
	`/aeko-brand-competitor-analysis`	Brand-level positioning vs. competitors
	`/aeko-product-competitor-analysis`	Product-level matrix (JSON-LD, FAQ, reviews, gaps)
Executors (customizable)	`/aeko-update-pdp`	PDP rewrite + JSON-LD + (shadow) store write
	`/aeko-create-content`	Multi-channel content from citation forensics
	`/aeko-fix-technical`	llms.txt, robots.txt, site JSON-LD
Maintenance	`/aeko-refresh-jsonld`	Periodic JSON-LD refresh (read-patch-write)
	`/aeko-brand-kit`	View and edit brand kit
	`/aeo-audit`	Generic AEO audit (no AEKO account required)

Example Workflow

A practical end-to-end example — the first 30 minutes after install.

From install to your first action

In Claude / Codex, run /aeko-onboarding → tours the 13 skills + verifies your MCP connection
/aeko-action-center mybrand.com → lists pending Technical / PDP / Content items grouped by category
Pick one item and run /aeko-update-pdp <item-id> → AEKO applies citation forensics + your brand kit, rewrites the PDP, and emits matching JSON-LD
After completion, run /aeko-visibility-report mybrand.com → track score changes
To find new prompts to monitor: /aeko-find-prompts-to-track mybrand.com → register them → data flows in from the next collection cycle

Improvement Guides

Subscription Plans