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

# Client Setup

> Configure the Pacifica MCP server in Claude Desktop, Claude Code, OpenAI Codex, Factory, Hermes, and Crush.

Every MCP client runs the server the same way - the command is `npx -y @pacifica-fi/mcp-server` with the environment variables from [Configuration](/api-documentation/api/mcp/configuration) (`ADDRESS` plus `AGENT_PRIVATE_KEY` or `PRIVATE_KEY`; omit the key for read-only).
Only the config format differs per client.

The examples below use agent-key mode; swap in `PRIVATE_KEY`, or drop the key entirely for read-only.

## Claude Desktop

Go to **Settings → Developer → Edit Config** to open `claude_desktop_config.json`, then add the `pacifica` server:

```json theme={null}
{
  "mcpServers": {
    "pacifica": {
      "command": "npx",
      "args": ["-y", "@pacifica-fi/mcp-server"],
      "env": {
        "ADDRESS": "<your account address>",
        "AGENT_PRIVATE_KEY": "<your agent wallet secret key>"
      }
    }
  }
}
```

Restart Claude Desktop after saving. On startup the server logs the active account and auth mode to the MCP logs, e.g. `[pacifica-mcp] account=<address> mode=agent-key`.

## Claude Code

Add it with the CLI:

```bash theme={null}
claude mcp add pacifica \
  --transport stdio \
  --env ADDRESS=<your account address> \
  --env AGENT_PRIVATE_KEY=<your agent wallet secret key> \
  -- npx -y @pacifica-fi/mcp-server
```

Or create `.mcp.json` in your project root (commit it to share with your team):

```json theme={null}
{
  "mcpServers": {
    "pacifica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@pacifica-fi/mcp-server"],
      "env": {
        "ADDRESS": "<your account address>",
        "AGENT_PRIVATE_KEY": "<your agent wallet secret key>"
      }
    }
  }
}
```

Verify with `claude mcp list`. Docs: [code.claude.com/docs/en/mcp](https://code.claude.com/docs/en/mcp)

## OpenAI Codex

Add it with the CLI:

```bash theme={null}
codex mcp add pacifica \
  --env ADDRESS=<your account address> \
  --env AGENT_PRIVATE_KEY=<your agent wallet secret key> \
  -- npx -y @pacifica-fi/mcp-server
```

Or edit `~/.codex/config.toml` (note the nested `.env` table):

```toml theme={null}
[mcp_servers.pacifica]
command = "npx"
args = ["-y", "@pacifica-fi/mcp-server"]

[mcp_servers.pacifica.env]
ADDRESS = "<your account address>"
AGENT_PRIVATE_KEY = "<your agent wallet secret key>"
```

Docs: [developers.openai.com/codex/mcp](https://developers.openai.com/codex/mcp)

## Factory (droid)

Add it with the CLI:

```bash theme={null}
droid mcp add pacifica "npx -y @pacifica-fi/mcp-server" \
  --env ADDRESS=<your account address> \
  --env AGENT_PRIVATE_KEY=<your agent wallet secret key>
```

Or edit `~/.factory/mcp.json` (user-level) or `.factory/mcp.json` (project-level):

```json theme={null}
{
  "mcpServers": {
    "pacifica": {
      "command": "npx",
      "args": ["-y", "@pacifica-fi/mcp-server"],
      "env": {
        "ADDRESS": "<your account address>",
        "AGENT_PRIVATE_KEY": "<your agent wallet secret key>"
      }
    }
  }
}
```

Docs: [docs.factory.ai/cli/configuration/mcp](https://docs.factory.ai/cli/configuration/mcp)

## Hermes Agent

Edit `~/.hermes/config.yaml` (YAML, top-level `mcp_servers` key):

```yaml theme={null}
mcp_servers:
  pacifica:
    command: "npx"
    args: ["-y", "@pacifica-fi/mcp-server"]
    env:
      ADDRESS: "<your account address>"
      AGENT_PRIVATE_KEY: "<your agent wallet secret key>"
```

Reload with `/reload-mcp` inside Hermes, or restart it.
Docs: [hermes-agent.nousresearch.com/docs/user-guide/features/mcp](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp)

## Crush

Edit `crush.json` in your project root (or `~/.config/crush/crush.json` for all projects).
The top-level key is `mcp` (not `mcpServers`), and Crush expands `$VAR` shell references in values - so keep secrets in your environment rather than in the file:

```json theme={null}
{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "pacifica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@pacifica-fi/mcp-server"],
      "env": {
        "ADDRESS": "$PACIFICA_ADDRESS",
        "AGENT_PRIVATE_KEY": "$PACIFICA_AGENT_PRIVATE_KEY"
      }
    }
  }
}
```

Docs: [github.com/charmbracelet/crush](https://github.com/charmbracelet/crush)