Content Tools

Create topics, save articles, get benchmarks, and manage the content pipeline with MCP tools.

aeo_list_topics

List content topics with optional status filter. Shows title, keywords, priority, and status. Results are ordered by priority (highest first), then by creation date.

Parameters

Name	Type	Required	Description
`status`	string	Optional	Filter by status: suggested, approved, in_progress, in_review, published, rejected, archived
`limit`	number	Optional	Max results to returnDefault: `50`

Example

json

aeo_list_topics({ status: class="code-string">"approved", limit: 10 })

aeo_create_topic

Create a new content topic for tracking. Sets status to approved and source to manual. Priority defaults to 50.

Parameters

Name	Type	Required	Description
`title`	string	Required	Topic title
`keywords`	string[]	Optional	Target keywords
`description`	string	Optional	Additional context or notes

Example

json

aeo_create_topic({
  title: class="code-string">"How to Add Schema.org Markup for AI Visibility",
  keywords: [class="code-string">"schema.org", class="code-string">"structured data", class="code-string">"AEO"]
})

aeo_update_topic_status

Approve, reject, or archive a content topic. Use after reviewing topics from aeo_list_topics. Rejection requires a reason and increments the topic's rejection count.

Parameters

Name	Type	Required	Description
`topic_id`	string	Required	Topic UUID
`status`	string	Required	"approved", "rejected", or "archived"
`rejection_reason`	string	Optional	Required when status is "rejected"

Examples

json

class=class="code-string">"code-comment">// Approve a topic
aeo_update_topic_status({ topic_id: class="code-string">"abc-123", status: class="code-string">"approved" })

class=class="code-string">"code-comment">// Reject with reason
aeo_update_topic_status({
  topic_id: class="code-string">"abc-123",
  status: class="code-string">"rejected",
  rejection_reason: class="code-string">"Too similar to existing article on Schema.org"
})

Typical workflow: aeo_list_topics (browse suggested) → aeo_update_topic_status (approve best ones) → write article → aeo_save_article.

aeo_save_article

Save a completed article to pipeline executions as a draft. Stores TypeScript source code and metadata. The article enters the review workflow with draft status.

Parameters

Name	Type	Required	Description
`topic_title`	string	Required	Article topic title
`content_ts`	string	Required	Full article as TypeScript KnowledgeTopic source code
`word_count`	number	Required	Total word count
`slug`	string	Required	URL slug for the article

aeo_publish_article

Publish an article by updating its review status to published and creating a published articles record. Optionally link to a CMS connection for Webflow publishing.

Parameters

Name	Type	Required	Description
`execution_id`	string	Required	Pipeline execution ID to publish
`connection_id`	string	Optional	CMS connection ID (optional, for Webflow etc.)

aeo_get_benchmarks

Get sector and category benchmark averages, score ranges, and domain counts. Returns data for each category in the benchmark taxonomy, including average score, min/max range, and the number of audited domains.

Parameters

Name	Type	Required	Description
`sector_slug`	string	Optional	Sector slug (e.g., "saas-productivity", "healthcare")
`category_name`	string	Optional	Category name (e.g., "Project Management")

Example

json

aeo_get_benchmarks({ sector_slug: class="code-string">"saas-productivity" })

Example Response

response

[
  {
    class="code-string">"sector_slug": class="code-string">"saas-productivity",
    class="code-string">"sector_name": class="code-string">"SaaS & Productivity",
    class="code-string">"category_name": class="code-string">"Project Management",
    class="code-string">"domain_count": 18,
    class="code-string">"average_score": 58,
    class="code-string">"min_score": 31,
    class="code-string">"max_score": 82,
    class="code-string">"score_range": class="code-string">"31-82"
  }
]

Use aeo_get_benchmarks to pull real sector averages and score ranges when writing articles. This provides concrete data points that make content more authoritative.