Skip to main content
MCP server CX Codex

mcp-warden — Claude Code MCP server: what it does, how to install

mcp-warden is an MCP server for Claude Code that stores keys in OS keychains and proxies HTTP requests through presets without exposing tokens to prompt context.

Apache-2.0 ★ 14 updated 2026-10-29

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add mcp-warden -- npx -y @mcp-warden/cli
Open on GitHub

What mcp-warden does

Coding assistants execute actions via proxy_http rather than handling raw API tokens directly. The server matches incoming requests against an allow-list of HTTP paths and verbs, injects credentials inside the local runtime, and returns stripped responses. Transcripts remain free of credentials.

Approval mechanisms keep sensitive operations guarded. Prompts can display native desktop dialogs or alert you in a Telegram chat equipped with an emergency /lock command. Every call attempt is recorded inside a local SQLite audit database, detailing accepted and rejected requests.

Running this service inside Docker is not supported. Key stores like Windows Credential Manager or macOS Keychain cannot be reached from inside containers, and falling back to unencrypted files is prohibited.

What it helps with

  • Prevent credentials from leaking into agent transcripts and LLM prompts
  • Restrict API calls using strict path and method allow-lists
  • Approve sensitive outgoing requests via desktop prompts or Telegram
  • Maintain a local SQLite audit trail for all approved and denied actions

Example prompts for the agent

  • List my GitHub repositories using the github-read preset in mcp-warden
  • Execute a GET request against the billing API via the stripe-read preset
  • Show available execution profiles configured in mcp-warden

How to install mcp-warden

Platform CLI

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

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about mcp-warden

How do I install mcp-warden in Claude Code?

Run claude mcp add mcp-warden -- npx -y @mcp-warden/cli in your terminal. You can then configure secrets and presets using the mcp-warden CLI.

What does mcp-warden do?

It proxies agent requests to external services without exposing secrets. The tool injects authorization credentials server-side directly from your OS keychain and returns only payload data.

Can mcp-warden run in Docker?

No, Docker containers lack access to native OS keyrings. The project refuses to store credentials in plain configuration files on disk, making container deployment impractical.

Similar MCP servers

All MCP servers for Security →

Project sponsors

Companies that keep this analytics open