MCP Tools

59 Model Context Protocol tools for auditing, content creation, and publishing - accessible from Claude Code, Cursor, or any MCP-compatible client.

What is MCP

The Model Context Protocol (MCP) lets AI agents call tools directly. The AEO Content AI MCP server exposes 59 tools for auditing, content creation, and publishing - all accessible from Claude Code, Cursor, or any MCP-compatible client.

Installation

The @aeo/mcp-server package ships with the AEO Content AI platform (npm publication pending).

For Claude Code, add to your project's .claude/settings.json:

.claude/settings.json

{
  class="code-string">"mcpServers": {
    class="code-string">"aeo-content": {
      class="code-string">"command": class="code-string">"npx",
      class="code-string">"args": [class="code-string">"-y", class="code-string">"@aeo/mcp-server@latest"],
      class="code-string">"env": {
        class="code-string">"AEO_API_KEY": class="code-string">"aeo_live_your_key_here",
        class="code-string">"SUPABASE_URL": class="code-string">"https:class="code-commentclass="code-string">">//your-project.supabase.co",
        class="code-string">"SUPABASE_SERVICE_ROLE_KEY": class="code-string">"your_service_role_key"
      }
    }
  }
}

For Cursor, add to .cursor/mcp.json:

.cursor/mcp.json

{
  class="code-string">"mcpServers": {
    class="code-string">"aeo-content": {
      class="code-string">"command": class="code-string">"npx",
      class="code-string">"args": [class="code-string">"-y", class="code-string">"@aeo/mcp-server@latest"],
      class="code-string">"env": {
        class="code-string">"AEO_API_KEY": class="code-string">"aeo_live_your_key_here",
        class="code-string">"SUPABASE_URL": class="code-string">"https:class="code-commentclass="code-string">">//your-project.supabase.co",
        class="code-string">"SUPABASE_SERVICE_ROLE_KEY": class="code-string">"your_service_role_key"
      }
    }
  }
}

The MCP server connects directly to Supabase for real-time data access. You need both an API key and Supabase credentials.

Available Tools

All 59 tools are grouped into ten categories. Click a tool name to see full parameter documentation and usage examples.

Audit Tools(6)

Tool	Description
`aeo_search_audits`	Search published audits by domain, sector, or score range
`aeo_get_audit`	Get full audit with scorecard, findings, and fix prompts
`aeo_get_audit_status`	Check audit job status (pending through completed)
`aeo_request_reaudit`	Queue a fresh re-audit after making fixes
`aeo_get_opportunities`	Get prioritized opportunities and fix items for a domain
`aeo_get_benchmarks`	Get sector/category benchmark averages

Visibility Tools(2)

Tool	Description
`aeo_search_visibility`	Search visibility reports by domain or engine
`aeo_get_visibility_timeline`	Get version history and per-query deltas for visibility over time

Content Tools(7)

Tool	Description
`aeo_list_topics`	List content topics with status filter
`aeo_create_topic`	Create new content topic
`aeo_update_topic_status`	Approve, reject, or archive a topic
`aeo_get_previous_topic_ideas`	Pull prior topic-ideas batches grouped by status for cross-batch dedup
`aeo_get_topic_signals`	Per-ICP-segment research signals: cached PAA, search volume, MISS and GSC gap queries
`aeo_save_article`	Save article draft to pipeline
`aeo_publish_article`	Publish article and update status

Client Tools(9)

Tool	Description
`aeo_get_client_profile`	Get client audit data, voice profile, CMS connection
`aeo_upsert_client_author`	Create/update domain voice profile
`aeo_save_client_article`	Save client article with domain tracking
`aeo_update_client_article`	Update existing client article HTML
`aeo_open_article`	Find and open article by fuzzy title/slug match
`aeo_publish_to_cms`	Publish article to client CMS (Webflow, etc.)
`aeo_cms_list_content`	List existing CMS content for deduplication
`aeo_wp_import_content`	Import WordPress posts/pages with incremental sync
`aeo_wp_list_content`	Browse WordPress content read-only via the WP API

Article Pipeline(18)

Tool	Description
`aeo_create_article`	Create a new article in the pipeline
`aeo_write_block`	Write a content block for an article
`aeo_write_article_batch`	Save a consolidated set of generated blocks in one call
`aeo_prepare_evidence_ledger`	Build a compact evidence ledger for phased generation
`aeo_prepare_article_brief`	Build the global article brief for phased generation
`aeo_prepare_section_batch`	Prepare the next pending block with a lean section brief
`aeo_get_article_blocks`	Get all blocks for an article
`aeo_list_corpus`	List the hydrated evidence library as a lean index
`aeo_list_internal_links`	List audited same-domain internal link targets
`aeo_get_corpus_item`	Load hydrated evidence-library items with full content
`aeo_get_block_briefing`	Read the per-block evidence briefing (Fast pipeline)
`aeo_rewrite_block`	Rewrite an existing content block
`aeo_regenerate_block`	Build a fresh section contract for one block (no DB mutation)
`aeo_decode_apply_improvements`	Decode the base64 argument passed to /apply-improvements
`aeo_add_block`	Add a new block to an article
`aeo_remove_block`	Remove a block from an article
`aeo_review_article`	Review article quality and AEO compliance
`aeo_generate_image`	Generate an AI image for a media block

Cluster Tools(7)

Tool	Description
`aeo_get_cluster_context`	Get audit gaps, MISS queries, existing content for cluster design
`aeo_create_cluster`	Create hub + child articles targeting audit gaps
`aeo_get_cluster`	Get full cluster details with execution status and progress
`aeo_list_clusters`	List all content clusters for a domain
`aeo_suggest_clusters`	Analyze gaps and suggest cluster opportunities
`aeo_start_cluster_article`	Start writing a planned or approved cluster article
`aeo_update_cluster_status`	Manage cluster lifecycle (start, sync, complete)

Organization Tools(8)

Tool	Description
`aeo_list_projects`	List projects and their structure
`aeo_create_project`	Create a new project
`aeo_create_group`	Create a group within a project
`aeo_create_folder`	Create a folder within a group
`aeo_update_project`	Update project metadata
`aeo_update_group`	Update group metadata
`aeo_update_folder`	Update folder metadata
`aeo_move_article`	Move an article to a different folder

WordPress Tools(2)

Tool	Description
`aeo_wp_list_content`	List WordPress posts and pages
`aeo_wp_import_content`	Import content from WordPress

Template Tools(2)

Tool	Description
`aeo_save_as_template`	Save an article as a reusable template
`aeo_list_templates`	List available article templates

Media Tools(1)

Tool	Description
`aeo_generate_image`	Generate an image for article content

Server Info

Server name	`aeo-content`
Version	`0.1.0`
Transport	`stdio (standard input/output)`