Skip to content
MCP server

mcp-warden

Local credential broker: agents call APIs and SSH via scoped presets, secrets stay put

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.6.1
Listing updated
today

Similar MCP servers

About mcp-warden

mcp-warden is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

Keys pasted into MCP client configs sit on disk in plaintext. mcp-warden keeps them in the operating system keychain and lets an agent act through named presets instead, so the secret never enters the model's context or a leaked transcript. A binary runs locally with no background service, auto-updater or telemetry, according to the README.

You define a preset such as a read-only GitHub token limited to GET on /user/repos. The agent calls list_presets and then proxy_http; mcp-warden checks the request against the preset's allow-list, injects the credential, runs the call and returns only the response. Sensitive presets ask for approval through a native dialog, a desktop notification or Telegram, which also offers a /lock kill switch. Every action goes to a hash-chained local audit log you can verify with mcp-warden audit verify.

The scan and import commands find plaintext keys in client configs for Claude Code, Cursor, Windsurf, VS Code and Codex and move them into the keychain. It is Apache-2.0 licensed.

Install

Run in a terminal

claude mcp add mcp-warden -- npx -y @mcp-warden/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-warden": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-warden/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-warden": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-warden/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-warden": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mcp-warden/cli"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mcp-warden": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-warden/cli"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mcp-warden": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-warden/cli"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

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

list_presets
Lists the configured presets.
proxy_http
Calls an HTTP API through a named preset with credentials injected server-side.

What it does

Keychain-held secrets
Credentials stay in the OS keychain, never in agent context.
Scoped presets
Allow-lists restrict methods and paths per named action.
Approval prompts
Native dialogs, notifications or Telegram, with time-boxed approvals.
Tamper-evident audit log
Hash-chained SQLite log with a verify command.
Plaintext key scan
Finds and imports keys from MCP client configs.
Many install routes
Homebrew, Scoop, npm, cargo, Nix, a script or .mcpb bundles.

Good for

  • Let an agent read GitHub repos without exposing a token
  • Move API keys out of MCP config files
  • Require approval before sensitive calls
  • Review exactly what an agent did

Pricing

Open source

Free, Apache-2.0

mcp-warden FAQ

Where are secrets stored?

In the OS keychain; the README says it never falls back to a file.

Is there a Docker image?

No, on purpose, since the keychain is not reachable from a container.

What licence?

Apache-2.0.

Does it phone home?

The README says there is no telemetry.

Is mcp-warden free?

Yes. mcp-warden is open source, so you can use and self-host it for free.

How do I add mcp-warden to Claude Code?

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

What are the best alternatives to mcp-warden?

The closest alternatives to mcp-warden are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers