> For the complete documentation index, see [llms.txt](https://docs.seaart.ai/guide-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.seaart.ai/guide-1/cli-mcp-skills.md).

# CLI/MCP/Skills

Use SeaArt from your terminal or connect it to AI assistants such as Claude, Cursor, Claude Code, OpenClaw, and Hermes.

Choose CLI for terminal commands, MCP to access SeaArt tools through an assistant, or Skills to help prepare prompts and plan video shots. You can combine them when your workflow requires it.

## Choose Your Workflow

**CLI (Command-Line Interface)**

Run supported SeaArt commands from a terminal or script. Use CLI when you want direct control over tasks, account resources, and repeatable workflows.

**MCP (Model Context Protocol)**

Connect SeaArt tools to a compatible AI assistant. MCP supports image and video generation tasks and task-status checks, letting you work through a conversation instead of entering every command manually.

**Skills**

Use reusable instructions to help compatible assistants prepare image prompts, review ideas, and plan video shots. Skills help with prompt preparation; a CLI or MCP connection, or the SeaArt website, is still needed to submit generation tasks.

## Which One Should You Start With?

| Option | What it does                                                | Best for                                             |
| ------ | ----------------------------------------------------------- | ---------------------------------------------------- |
| CLI    | Runs supported SeaArt commands in a terminal                | Direct control and repeatable tasks                  |
| MCP    | Makes SeaArt tools available through a compatible assistant | Submitting and tracking tasks through a conversation |
| Skills | Helps prepare prompts and plan video shots                  | Turning ideas into prompts or storyboards            |

You don't need all three to get started. Choose the option that fits your workflow and add others later if needed.

### Set Up SeaArt CLI

#### 1. Install the CLI

Open the [official CLI page](https://www.seaart.ai/cli) for installation instructions, or run:

```
curl -fsSL https://public.cdn.seaspark.ai/ai-tool/release/latest/install.sh | bash
```

Run the command in a Bash environment with `curl` installed. On Windows, use a supported Bash environment or follow the official installation instructions.

#### 2. Sign In and Check Your Account

Sign in to your SeaArt account, then check your available assets:

```
seaart login
seaart account assets
```

Follow the sign-in instructions in your terminal. Confirm that the account command returns your available assets before proceeding.

#### 3. Find Available Commands

```
seaart --help
```

Use the help output to find the command and options for your task. Check the required parameters and available account resources before submitting a generation task. Keep the returned task ID if you need to check its progress later.

### Connect SeaArt MCP

#### 1. Install the MCP Server

Install SeaArt CLI and complete the login check above. Then open the [official MCP page](https://www.seaart.ai/mcp) for setup instructions, or install the MCP server with:

```
curl -fsSL https://public.cdn.seaspark.ai/ai-tool/release/latest/install.sh | bash -s -- mcp
```

#### 2. Configure Your MCP Client

For clients that support a local **stdio** connection, use the following configuration:

```
{
  "mcpServers": {
    "seaart": {
      "command": "seaart-mcp",
      "args": ["serve"]
    }
  }
}
```

Add this entry to your client's MCP configuration. The configuration file and setup process vary by client. If the client cannot find `seaart-mcp`, try specifying the full executable path.

This example is for stdio. Make sure your client supports the selected transport before using the configuration.

#### 3. Verify the Connection

After configuring the server, reload your MCP client and check that the SeaArt tools are available.

You can ask your assistant to list the available SeaArt tools or check your login status before submitting a task. For long-running tasks, keep the task ID and use the available status-checking tool to follow progress. Where supported, you can use `no_wait=true` and query `get_task_status` until the task finishes.

SeaArt also documents a local HTTP endpoint at `http://127.0.0.1:8787/mcp`. Use this endpoint only after following the official startup instructions and confirming that your client supports local HTTP transport.

### Add SeaArt Skills

#### 1. Install the Skills Package

Open the [official Skills page](https://www.seaart.ai/skills) for setup instructions, or run:

```
npx skills add seaartpublic/skills
```

This command requires Node.js and `npx`. Follow the prompts to select a supported client, such as Claude Code, Cursor, or Codex, and choose where to install the skills. Reload the client if needed.

#### 2. Prepare a Prompt or Storyboard

Once installed, use the relevant skill to help organize your idea.

For image generation, ask the assistant to turn your description into a clear image prompt. For video creation, ask it to outline the shots, framing, actions, lighting, and a prompt for each shot.

Review the result and edit it to match your creative direction before generating.

#### 3. Generate with SeaArt

The public Skills package provides prompt-planning instructions; it does not independently submit generation tasks.

When your prompt or storyboard is ready, use a connected CLI or MCP tool to submit the task, or copy the prompt into the SeaArt website.

## Troubleshooting

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td>Issue</td><td>What to check</td></tr><tr><td><code>seaart</code> or <code>seaart-mcp</code> is not found</td><td>Reopen the terminal or client after installation. Check your PATH or configure the full executable path.</td></tr><tr><td>The assistant cannot see SeaArt tools</td><td>Check the MCP server entry, command, and transport. Reload the client and review its server status.</td></tr><tr><td>Login or account checks fail</td><td>Run <code>seaart login</code> again locally, then retry <code>seaart account assets</code>.</td></tr><tr><td><code>npx</code> is not found</td><td>Install Node.js with npm, reopen the terminal, and retry the Skills installation.</td></tr><tr><td>A skill creates a prompt but does not generate an image</td><td>This is expected for prompt-planning skills. Use CLI, MCP, or the SeaArt website to submit the task.</td></tr><tr><td>A generation task is still running</td><td>Keep its task ID and check its status. Avoid submitting the same request again just because it has not finished.</td></tr></tbody></table>

<a href="https://www.seaart.ai/cli" class="button primary">SeaArt CLI</a><a href="https://www.seaart.ai/mcp" class="button primary">SeaArt MCP</a><a href="https://www.seaart.ai/skills" class="button primary">SeaArt Skills</a>
