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.

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

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.