Why it is worth attention

It sharply reduces context bloat by giving agents only five tools and exposing tool/skill metadata only through explicit search, plus it can migrate Claude Code MCP servers, plugins, and skills into its registry with backups and restore.

Who it is for

Claude Code users who want to reduce context size
Developers managing many MCP servers or tools
Teams standardizing agent tool access
Users of MCP-compatible clients like Claude Desktop or Cursor

Use cases

Consolidate many MCP tools behind a single warden MCP server
Migrate existing Claude Code MCP servers, plugins, and skills into warden
Let an agent register or remove tools via the admin tool at runtime
Route a task to the best tool or skill based on rules and ranking

Strengths

Agent context contains only 5 tool definitions, not every downstream tool
Search covers tool and skill names, descriptions, and arguments using regex and keyword scoring
Migration is safe: dry-run by default, writes backups, and supports restore
Routing is configurable and applies immediately via CLI or admin tool

Considerations

Skills hidden behind warden are not auto-started by Claude Code; users need to instruct the model to call search first
call_tool opens a new downstream MCP connection per call, which may add overhead
Migration changes to Claude Code take effect only after restarting Claude Code

README quick start

warden

warden is one MCP server. It gives an agent access to many other MCP servers and Skills. The agent sees only 5 tools:

search(query, limit=5) — This tool does a regex or keyword search. It looks in the name, the description, and the arguments of each tool. It also looks in the name and the description of each Skill. No other data goes to the agent.
call_tool(server, name, arguments) — This tool sends a call to the MCP server that has the tool. Use a search result to find the server and the tool.
use_skill(name) — This tool returns the full instructions for a Skill. Use a search result to find the Skill.
admin(action, params) — This tool controls the registry. It can also move MCP servers and Skills out of Claude Code. The changes are immediate, and you do not restart the server. Refer to The admin tool.
route(task, context=None, mode=None) — This tool selects the best tool or Skill for a task. It ranks the candidates and returns the best one. It does not run the tool. Refer to Routing.

At start, warden connects one time to each MCP server in the configuration and gets its tools with list_tools. It also reads each Skill directory and finds the SKILL.md files. warden keeps this catalog on the server. The model does not get these definitions. The model gets only search results, and only when it asks.

How to use

The goal is to move your MCP servers and Skills behind warden. Then the Claude context has only the 5 tools. warden supplies the other data only when the agent asks for it.

Install.

pip install -r requirements.txt        # or: pip install .  (for the warden command)

Test first (the safe method). The dry run shows each change. Then apply the migration to a temporary Claude home. warden does not change your real ~/.claude.

warden migrate --all                                   # dry run: shows each change
warden migrate --all --apply --home /tmp/fake-claude   # apply to a temporary home
warden restore --id  --home /tmp/fake-claude

Do the real migration. Remove --home to change your real Claude configuration. warden adds the items to the registry. warden also disables the ite

Description

One MCP server that fronts many MCP servers + Skills behind a small tool set and routes to the best one, keeping an agent's context tiny. Migrate your Claude Code MCPs/skills behind it.

Related repositories

Similar projects matched by category, topics, and programming language.

0xwilliamortiz

Featured

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models

577

mereyabdenbekuly-ctrl

Featured

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents

859

makecindy

Featured

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models

958