# Wundervault MCP

> Wundervault MCP is a free MCP server for security. Agents use your API keys, SSH keys and wallets via a local broker and never hold them. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Website:** https://wundervault.com
- **Repository:** https://github.com/wundervault/wundervault-mcp
- **MCP Registry name:** io.github.wundervault/wundervault-mcp
- **Categories:** security
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/wundervault-mcp
