MCP Tools | AEO Content Docs

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 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)`