mcp-warden
Local credential broker: agents call APIs and SSH via scoped presets, secrets stay put
- 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/cliAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-warden": {
"command": "npx",
"args": [
"-y",
"@mcp-warden/cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-warden": {
"command": "npx",
"args": [
"-y",
"@mcp-warden/cli"
]
}
}
}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.


