Skip to content
MCP server

Wundervault MCP

Agents use your API keys, SSH keys and wallets via a local broker and never hold them

Runs locallyStatus and history
Pricing
Free
Platforms
macOS, Linux, CLI
Runs
Locally
Version
2.5.0
Listing updated
3 days ago

About Wundervault MCP

Wundervault MCP is a free MCP server for security. It runs locally on your machine and is started by your AI client.

Wundervault splits an agent from its credentials. The MCP server runs as you and holds nothing; a separate broker on your computer, under its own OS account, keeps the secrets, makes the call and returns the answer with the secret removed. No tool returns a secret's value, and the README says the older hand-over tools from version 1 were removed.

The tools cover calling web services with a key attached, creating a new key at a service straight into the vault, saving a secret without reading it into chat, pushing secrets to a Cloudflare Worker, running commands and git over SSH with a vaulted key, supplying authenticator codes, signing data and paying x402 requests in USDC on Base or Solana. Secrets you mark ask me first wait for approval with a passkey on a phone or computer.

The vault is encrypted in your browser before it reaches the vendor's server, every use is written to a signed log on your machine, and payments obey a daily limit that starts at zero. The site invites you to check the encryption claims yourself.

Install

Run in a terminal

claude mcp add wundervault-mcp --env WUNDERVAULT_AGENT_NAME='<WUNDERVAULT_AGENT_NAME>' --env WUNDERVAULT_AGENT_TOKEN='<WUNDERVAULT_AGENT_TOKEN>' -- npx -y @wundervault/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "wundervault-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wundervault/mcp-server"
      ],
      "env": {
        "WUNDERVAULT_AGENT_NAME": "<WUNDERVAULT_AGENT_NAME>",
        "WUNDERVAULT_AGENT_TOKEN": "<WUNDERVAULT_AGENT_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "wundervault-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wundervault/mcp-server"
      ],
      "env": {
        "WUNDERVAULT_AGENT_NAME": "<WUNDERVAULT_AGENT_NAME>",
        "WUNDERVAULT_AGENT_TOKEN": "<WUNDERVAULT_AGENT_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "wundervault-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wundervault/mcp-server"
      ],
      "env": {
        "WUNDERVAULT_AGENT_NAME": "<WUNDERVAULT_AGENT_NAME>",
        "WUNDERVAULT_AGENT_TOKEN": "<WUNDERVAULT_AGENT_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wundervault-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wundervault/mcp-server"
      ],
      "env": {
        "WUNDERVAULT_AGENT_NAME": "<WUNDERVAULT_AGENT_NAME>",
        "WUNDERVAULT_AGENT_TOKEN": "<WUNDERVAULT_AGENT_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "wundervault-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wundervault/mcp-server"
      ],
      "env": {
        "WUNDERVAULT_AGENT_NAME": "<WUNDERVAULT_AGENT_NAME>",
        "WUNDERVAULT_AGENT_TOKEN": "<WUNDERVAULT_AGENT_TOKEN>"
      }
    }
  }
}

Configuration

  • WUNDERVAULT_AGENT_NAMEThe agent's name, as added in your vault and enrolled on this computer with wundervault-agent --enrol.Required
  • WUNDERVAULT_AGENT_TOKENOptional. Overrides the token that wundervault-agent --enrol saved for this agent.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

vault_call
Calls a web service with a secret attached and returns the answer with it removed.
vault_new_key
Creates a new key at a service and stores it in the vault.
vault_save_secret
Saves a secret into the vault without reading it into chat.
vault_send_secret
Puts vault secrets into a Cloudflare Worker's settings.
vault_ssh_exec
Runs a command on an approved server over SSH.
vault_git
Runs git operations over SSH with a vaulted key.
vault_2fa_code
Gives the current authenticator-app code.
vault_pay
Pays an x402 request in USDC within set limits.
vault_sign
Signs data with a signing key after approval.
vault_entries_list
Lists which secrets the agent may use, without values.

What it does

Local broker
A helper on your computer holds secrets, so the agent never receives them.
Approval on demand
Secrets set to ask first wait for passkey approval.
SSH and git signing
Commands and git run with a vaulted key that stays in the broker.
Authenticator codes
Supplies the current 2FA code, never the setup key.
Agent payments
Pays x402 requests in USDC on Base or Solana within a daily limit.
Signed use log
Each use is recorded on your own computer.

Good for

  • Have an agent list Cloudflare sites without pasting a token
  • Let an agent push to a git remote using a protected SSH key
  • Approve a sensitive API call from your phone
  • Cap what an agent can spend on paid APIs
  • Rotate a key without it appearing in chat history

Pricing

Free

Described as free to use

Prices change. Check wundervault.com before you buy.

Wundervault MCP FAQ

Can the vendor read my vault?

The site says it is encrypted on your device before upload, so the server cannot read it.

Does any tool return a secret?

No. The README says no tool returns a secret's value.

Which clients work?

Claude Code, Codex, Cursor, Cline, OpenClaw and other MCP clients.

How do payments work?

Within a daily limit you set, starting at $0, to payees you trust.

Is Wundervault MCP free?

Yes. Wundervault MCP is free to use.

How do I add Wundervault MCP to Claude Code?

Run this command in your terminal: claude mcp add wundervault-mcp --env WUNDERVAULT_AGENT_NAME='<WUNDERVAULT_AGENT_NAME>' --env WUNDERVAULT_AGENT_TOKEN='<WUNDERVAULT_AGENT_TOKEN>' -- npx -y @wundervault/mcp-server

What are the best alternatives to Wundervault MCP?

The closest alternatives to Wundervault MCP are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

Alternatives to Wundervault MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security