MCP tools

Choosing a domain

Every domain-scoped tool takes an optional domainId. It accepts a domain ID, a host (brand.com, https://www.brand.com/) or a brand name. When it is omitted, Aeolo uses the account’s only domain, or the domain your last MCP call used. If neither applies, the tool answers with a plain-text list of domains to choose from. You do not need to call aeo_list_domains to look up an ID.

One tool per operation

The public endpoint https://mcp.aeolo.io/mcp exposes one tool for each thing you do in a conversation. Each has its own input schema and annotations.

Tool	What it does	Annotations
`aeo_get_brand_context`	Brand identity, offering, audience, competitors, voice and content strategy	read-only
`aeo_get_content`	One article with its full body as Markdown	read-only
`aeo_get_article_performance`	Search and site analytics for one article	read-only
`aeo_suggest_next_topic`	The next article angle to write	read-only
`aeo_import_article`	Save a finished article as a review draft (`article` input)	write
`aeo_update_article`	Change an article’s fields or replace its body (`changes` input)	write, destructive
`aeo_deploy_article`	Publish or republish to Shopify, WordPress, Cafe24, Pangolingo or the hosted blog; needs `confirmed: true`	write, open world, destructive
`aeo_run_visibility_check`	Start a credit-metered visibility measurement; preview first, then `confirmed: true` with the `approvalFingerprint`	write, open world

Full command surface

https://mcp.aeolo.io/mcp?surface=full adds two command gateways for power users and coding agents: aeo_read (any read-only registry command, as text) and aeo_execute_command (any write, job or publish command). Same OAuth and tokens as the public endpoint.

`aeo_read`

Runs a read-only command through the Aeolo command registry and returns text. It never spends credits or changes data, so clients do not ask for approval, and it draws no widget. Use it to gather facts before answering.

{
  "name": "aeo_read",
  "arguments": {
    "command": "agent context",
    "domainId": "brand.com"
  }
}

Field	Required	Notes
`command`	Yes	Read command without the `aeo` prefix. Example: `diagnose visibility`.
`domainId`	No	ID, host or brand name. See Choosing a domain.

A write command sent to aeo_read is refused with a pointer to aeo_execute_command. Good first reads:

agent context
diagnose visibility
diagnose audit
strategy show
content list
content get <id>
measure overview

`aeo_execute_command`

Runs a command that writes, starts a job, spends credits or publishes. Clients treat it as destructive and ask the user before each call.

{
  "name": "aeo_execute_command",
  "arguments": {
    "command": "content import",
    "domainId": "brand.com",
    "contentImport": {
      "title": "Runner sunscreen guide",
      "content": "# Runner sunscreen guide\n...",
      "articleType": "guide",
      "language": "en"
    }
  }
}

Field	Required	Notes
`command`	Yes	Command without the `aeo` prefix. Never include an article body.
`domainId`	No	ID, host or brand name.
`contentImport`	With `content import`	Structured draft.
`contentUpdate`	With `content update <id>`	Structured changes, including a full replacement body.
`confirmed`	For gated commands	Set `true` only after the user approves the exact action.

A read_write token is required.

View tools

aeo_list_domains, aeo_get_visibility, aeo_get_performance, aeo_get_audit, aeo_get_traffic, aeo_get_content_list, aeo_get_image_gallery, aeo_get_prompts, aeo_get_channels and aeo_get_automation render an interactive Aeolo view in clients that support MCP Apps. Call them when the user asks to see that data. The text result carries the same data, so the model can reason over it too.

Poor MCP fits

auth login
auth logout
update
drive download
image upload --file

Those depend on local OS behavior or local files.

Start here

Connect your website

Write and review

CLI and MCP setup

Brand context and access

Measure and distribute

Reference

Choosing a domain

One tool per operation

Full command surface

`aeo_read`

`aeo_execute_command`

View tools

Poor MCP fits

​Choosing a domain

​One tool per operation

​Full command surface

​aeo_read

​aeo_execute_command

​View tools

​Poor MCP fits

Choosing a domain

One tool per operation

Full command surface

`aeo_read`

`aeo_execute_command`

View tools

Poor MCP fits