MCP Config Snippets

Use these snippets to connect Claude Desktop, Cursor, or VS Code to VaultCrux MCP.

Local binary mode

Use this when you run VaultCrux locally.

Required values:

• MCP_STDIO_API_KEY
• MCP_STDIO_TENANT_ID
• VAULTCRUX_API_BASE (for example http://localhost:14333)

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "vaultcrux": {
      "command": "pnpm",
      "args": ["--dir", "$VAULTCRUX_DIR", "--filter", "@vaultcrux/mcp", "stdio"],
      "env": {
        "MCP_STDIO_API_KEY": "<your-api-key>",
        "MCP_STDIO_TENANT_ID": "<your-tenant-id>",
        "VAULTCRUX_API_BASE": "http://localhost:14333"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "servers": {
    "vaultcrux": {
      "command": "pnpm",
      "args": ["--dir", "$VAULTCRUX_DIR", "--filter", "@vaultcrux/mcp", "stdio"],
      "env": {
        "MCP_STDIO_API_KEY": "<your-api-key>",
        "MCP_STDIO_TENANT_ID": "<your-tenant-id>",
        "VAULTCRUX_API_BASE": "http://localhost:14333"
      }
    }
  }
}

Remote HTTP mode

Use this when MCP is hosted and exposed via HTTP.

Required headers:

• x-tenant-id
• x-api-key
• x-idempotency-key for mutating methods
• x-shield-approval-token when approval is required

Example call:

curl -sS "$VAULTCRUX_API_URL/rpc" \
  -H 'content-type: application/json' \
  -H 'x-tenant-id: <tenant-id>' \
  -H 'x-api-key: <api-key>' \
  -d '{"jsonrpc":"2.0","id":"1","method":"get_credit_balance","params":{"agent_id":"agent-1"}}'

Validation

curl -fsS "$VAULTCRUX_API_URL/healthz"
curl -fsS "$VAULTCRUX_API_URL/readyz"