# Warmplane

A local proxy that keeps MCP connections warm, hands the agent a compact tool catalog, and routes every call through policy checks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 5
- Author: Warmplane
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Warmplane/warmplane
- Updated: 2026-10-04
- HTML: https://affpapa.org/en/nevibecode/mcp/warmplane

## What it does

Warmplane sits between your AI client and a set of upstream MCP servers. Rather than shipping full JSON schemas for every tool on every turn, it exposes a small capability index and lets the agent pull a schema when it actually needs one. SHA-256 ETag caching stops the same payload from being sent twice.

Governance lives in the same process. Config keys `allow`, `deny`, `requireApproval` and `redactKeys` decide what runs and what gets masked, profiles group servers by task, and multi-tenant RBAC covers shared setups. Retries after a network hiccup are handled with exactly-once deduplication keyed by `idk_<sha256>`, plus `safe`, `idempotent` and `unsafe` classifications. A supervisor with circuit breakers restarts upstream processes that hang or die.

Three run modes are available: a child process via `warmplane mcp-server`, a background daemon with `warmplane daemon --port 9090` that also serves a REST API and web panel, or a shared instance over HTTP/SSE at `http://127.0.0.1:9191/sse`. Install through Homebrew (`brew tap warmplane/tap`) or `cargo install warmplane`; semantic search needs the extra `--features semantic-search` build. No Rust toolchain and no Homebrew means no install.

## Requirements
- Needs: a prebuilt binary from the repository releases

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- cut prompt tokens spent on tool schemas
- override a misleading tool description without touching upstream code
- avoid running the same mutation twice after a dropped connection
- gate risky calls behind human approval
- strip tokens and passwords out of responses and logs

## Example prompts
- Add the filesystem server: `warmplane server add filesystem --command npx --arg "-y" --arg "@modelcontextprotocol/server-filesystem" --arg "/tmp"`
- Pull in my existing servers with `warmplane config import`
- Start the daemon on port 9090 and list what's in the capability catalog

## Similar
- [cli-policy-audit](https://affpapa.org/en/nevibecode/skills/cli-policy-audit.md) — skill · 952 installs
- [MCP Hangar](https://affpapa.org/en/nevibecode/mcp/mcp-hangar.md) — MCP server · ★ 18
- [Laguarde](https://affpapa.org/en/nevibecode/mcp/laguarde.md) — MCP server · ★ 1
- [tf-best-practices](https://affpapa.org/en/nevibecode/skills/tf-best-practices.md) — skill · 323 installs
- [mcp-bastion](https://affpapa.org/en/nevibecode/mcp/mcp-bastion.md) — MCP server · ★ 7
- [masterhttprelayvpn-proxy](https://affpapa.org/en/nevibecode/skills/masterhttprelayvpn-proxy.md) — skill · 365 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md