# mcp-warden

> mcp-warden is an open-source MCP server for security. Local credential broker: agents call APIs and SSH via scoped presets, secrets stay put. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/ermoluk/mcp-warden
- **MCP Registry name:** io.github.ermoluk/mcp-warden
- **Categories:** [security](https://ai-powered.com/categories/security), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

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