Skip to main content
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