# vernam secrets broker

> vernam secrets broker is a freemium MCP server for security. Lets AI agents use your API keys through a local proxy without ever seeing them. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, macOS, Linux, Windows, API, Self-hosted
- **Website:** https://vernam.esrevi.nu
- **MCP Registry name:** io.github.universe-backwards/vernam
- **Categories:** [security](https://ai-powered.com/categories/security), [agent approvals](https://ai-powered.com/categories/agent-approvals)
- **Listing updated:** 2026-11-20

## About

Vernam keeps real API credentials away from the AI agents that need them. An agent receives a placeholder token, and a proxy on your own machine swaps in the real key only when the request is headed to the API that key belongs to. Requests to any other destination are refused before they leave your computer.

Keys are stored encrypted in a local vault and added with a command-line tool, which can be paired with presets for common services such as Stripe and GitHub. Running an agent through the vn wrapper sets the usual environment variables, so official SDKs keep working unchanged while only placeholders are visible to the agent.

It suits developers who run coding agents such as Claude Code or Codex against accounts with real spending or repository access. Teams can optionally connect to a shared dashboard that logs which agent used which key, what was blocked and the resulting status codes.

## Features

- **Placeholder tokens for agents:** Agents hold stand-in values instead of real keys, so printing or pasting them exposes nothing usable.
- **Per-API key routing:** Each stored key is tied to its own API host, and the proxy refuses to send it anywhere else.
- **Encrypted local vault:** Keys are kept encrypted on the user's machine and only held in memory while the vault is unlocked.
- **Request logging:** Every request an agent makes is recorded with the key name, host, path and status code.
- **Drop-in SDK compatibility:** The run command sets standard variables like OPENAI_API_KEY and base URLs so existing code needs no changes.
- **Optional team dashboard:** A shared live log shows requests from several machines, without sending key values off the machine.

## Good for

- Letting a coding agent call paid APIs without exposing the account credentials
- Preventing an agent that reads untrusted files from sending a secret to an unexpected host
- Keeping an audit trail of which agent called which API and what was blocked
- Sharing visibility of agent API activity across a small development team

## Install

### Claude Code (Terminal)

```sh
claude mcp add vernam -- npx -y @vernham/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vernam": {
      "command": "npx",
      "args": [
        "-y",
        "@vernham/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vernam": {
      "command": "npx",
      "args": [
        "-y",
        "@vernham/cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "vernam": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vernham/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vernam": {
      "command": "npx",
      "args": [
        "-y",
        "@vernham/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vernam": {
      "command": "npx",
      "args": [
        "-y",
        "@vernham/cli"
      ]
    }
  }
}
```

## FAQ

### Do you store my API keys?

No. Keys live in an encrypted vault on your machine and only exist in memory while the vault is unlocked. The team dashboard receives key names, hosts, paths and status codes.

### Do I have to change my code?

No. vn run sets the usual variables, like OPENAI_API_KEY and OPENAI_BASE_URL, so official SDKs pick up the placeholder and the proxy without changes.

### Which APIs work today?

28 have presets, including OpenAI, Anthropic, Gemini, OpenRouter, GitHub and Stripe. Any other HTTPS API works with a custom target, and tools that hardcode the API URL go through a local HTTPS proxy.

### Do I need the dashboard?

No. The CLI works on its own and sends nothing anywhere. Run vn login when you want your team's requests in one live log.

### Is vernam secrets broker free?

vernam secrets broker has a free plan, with paid plans for more usage or features.

### How do I add vernam secrets broker to Claude Code?

Run this command in your terminal: claude mcp add vernam -- npx -y @vernham/cli

### What are the best alternatives to vernam secrets broker?

The closest alternatives to vernam secrets broker are Phantom Secrets, keyward, Agentvault, API Locker and VibeDNA Vault.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Phantom Secrets](https://ai-powered.com/mcp/phantom-secrets): Phantom Secrets is an open-source MCP server for security.
- [keyward](https://ai-powered.com/mcp/keyward): keyward is an open-source MCP server for security.
- [Agentvault](https://ai-powered.com/mcp/agentvault-2): Agentvault is a freemium MCP server for security.
- [API Locker](https://ai-powered.com/mcp/api-locker): API Locker is a free MCP server for security.
- [VibeDNA Vault](https://ai-powered.com/mcp/vibedna-vault): VibeDNA Vault is a free MCP server for security.
- [API Key Case](https://ai-powered.com/mcp/api-key-case): API Key Case is a freemium MCP server for security.
- [Wundervault MCP](https://ai-powered.com/mcp/wundervault-mcp): Wundervault MCP is a free MCP server for security.
- [vaultguard](https://ai-powered.com/mcp/vaultguard-2): vaultguard is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/vernam-secrets-broker
