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

# Claude

> Add the SEAOTTER MCP server to Claude Code or Claude Desktop.

Prefer [seaotter.dev/connect](https://seaotter.dev/connect) — it mints your key and shows the exact command or JSON to copy.

## Claude Code (terminal)

Copy, paste into your terminal, press Enter:

```bash theme={null}
claude mcp add seaotter \
  --env SEAOTTER_API_KEY=so_… \
  -- npx -y @ryanseaotter/mcp-server
```

You’re done when `claude mcp list` shows `seaotter`. Then in chat:

> Use the SEAOTTER MCP to onboard a Hermes agent named my-hermes, then talk to it.

## Claude Desktop

1. Open your MCP config (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`).
2. Paste this JSON (merge into existing `mcpServers` if the file already has other servers):

```json theme={null}
{
  "mcpServers": {
    "seaotter": {
      "command": "npx",
      "args": ["-y", "@ryanseaotter/mcp-server"],
      "env": {
        "SEAOTTER_API_KEY": "so_…"
      }
    }
  }
}
```

3. Restart Claude Desktop.

You’re done when SEAOTTER tools appear in Claude.

## Notes

* Package on npm: `@ryanseaotter/mcp-server` (official SEAOTTER MCP).
* Needs Node.js 20+ (`npx` on PATH).
* Prefer `onboard_hermes_agent` for first-time setup, then `talk_to_hermes_agent`.
* Full tool list: [Tools](/mcp/tools).