> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aeolo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Aeolo CLI and MCP

> Use Aeolo from terminals, coding agents, and MCP clients without drifting from the dashboard product surface.

<img src="https://mintcdn.com/aeolo/THonMDCsHeovYjxA/logo/mark.svg?fit=max&auto=format&n=THonMDCsHeovYjxA&q=85&s=22cef9aa6b10727b0d97ba1a25d540dc" alt="Aeolo" width="72" data-path="logo/mark.svg" />

Aeolo exposes the same brand operating context, content lifecycle, visibility checks, and reference analysis system through the dashboard, CLI, and MCP.

These docs are written for external agents and integration engineers. They focus on the dashboard-aligned command surface.

<Info>
  The default writing path for external agents is to read context, draft locally, then import the finished draft with `aeo content import`. Server-side generation is still available, but it is an explicit paid job.
</Info>

<CardGroup cols={2}>
  <Card title="CLI" icon="terminal" href="/cli/overview">
    Run `aeo` from a terminal or coding agent.
  </Card>

  <Card title="MCP" icon="plug" href="/mcp/overview">
    Connect remote agents through Streamable HTTP.
  </Card>
</CardGroup>

## The shortest path

```bash theme={null}
curl -fsSL https://skills.aeolo.io | sh
aeo auth login
aeo domain list
aeo domain switch <domain_id>
aeo agent context
```

Then choose the task path:

<CardGroup cols={2}>
  <Card title="External-agent writing" icon="pen-line" href="/guides/external-agent-writing">
    Draft locally, import, review, and publish only after approval.
  </Card>

  <Card title="MCP setup" icon="network" href="/quickstart/connect-mcp">
    Use an Aeolo token, list domains, then execute safe commands.
  </Card>

  <Card title="Command reference" icon="list-tree" href="/cli/command-reference">
    Find the current command, flags, and risk level.
  </Card>
</CardGroup>

```bash theme={null}
# External-agent writing
aeo content import --title "..." --body-file ./draft.md
aeo content review <content_id>

# Visibility measurement
aeo visibility show
aeo visibility check run
aeo visibility check poll <job_id>

# Reference style analysis
aeo reference analyze --url "https://www.instagram.com/p/..." --media visual_asset
aeo reference poll <job_id>
aeo reference style --url "https://www.instagram.com/p/..."
```

<Warning>
  `visibility check run`, `reference analyze`, `post analyze`, `content generate`, `image swap`, and video generation start production, credit-metered work. `content preview` and `post preview` create public, unauthenticated share-token URLs. Agents should ask before running paid jobs, publishing, or generating public preview links.
</Warning>

## Canonical surfaces

| Need                                            | Use                                                         |
| ----------------------------------------------- | ----------------------------------------------------------- |
| See what the dashboard agent sees               | `aeo agent context`                                         |
| Import externally written content               | `aeo content import`                                        |
| Start Aeolo server-side writing                 | `aeo content generate`                                      |
| Analyze tone, hook, format, or visual reference | `aeo reference analyze` and `aeo reference style`           |
| Analyze or generate short-form video            | `aeo video analyze`, `aeo video generate`, `aeo video poll` |
| Read connected research sources                 | `aeo drive list`, `aeo drive read`                          |
| Connect an MCP client                           | `POST /mcp` with bearer auth                                |

## Safe defaults

| Default                              | Why                                                                             |
| ------------------------------------ | ------------------------------------------------------------------------------- |
| Read first with `aeo agent context`  | Matches the dashboard-visible context surface.                                  |
| Draft locally, then `content import` | Keeps external-agent writing explicit and reviewable.                           |
| Use `read` tokens for discovery      | Reduces blast radius for MCP and CI clients.                                    |
| Ask before paid jobs                 | Visibility checks, reference analysis, and generation spend production credits. |
| Ask before preview or publish        | Preview links are public; deploy/publish writes to external channels.           |