Client Setup - Pacifica

Every MCP client runs the server the same way - the command is npx -y @pacifica-fi/mcp-server with the environment variables from 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:

{
  "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:

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):

{
  "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

OpenAI Codex

Add it with the CLI:

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):

[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

Factory (droid)

Add it with the CLI:

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):

{
  "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

Hermes Agent

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

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

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:

{
  "$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

​Claude Desktop

​Claude Code

​OpenAI Codex

​Factory (droid)

​Hermes Agent

​Crush

Claude Desktop

Claude Code

OpenAI Codex

Factory (droid)

Hermes Agent

Crush