mcptoon plugin
MCP tool-catalog compression for Claude Code. Compresses the tool discovery payload from 71,929 to 581 tokens (-99.2%). Auto-installs the zero-dependency mcptoon CLI (/mcptoon-setup), wires the serve bridge, and teaches the agent when to compress. MCP 2026-07-28 stateless-first bridge included.
How to install the mcptoon plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add activeing123/mcptoon
/plugin install mcptoon@mcptoonWhat's inside mcptoon
4 parts read from the plugin's own files.
Commands 1
Run as /mcptoon:name- /mcptoon:mcptoon-setup
Set up or repair the mcptoon CLI for this machine (install, verify, diagnose)
Skills 1
Claude loads it when the task matches- mcptoon
Compress MCP tool discovery with the mcptoon CLI. Trigger when a session has a large MCP tool catalog (many servers/tools), when the user mentions token cost, tool discovery, mcptoon, or asks to list/call MCP tools efficiently. Also route here when the user says the MCP tool list is too large, the agent context window is filling up with tool schemas, or they need the same MCP servers configured across Claude Code, Cursor, Codex, Cline, Windsurf and other agents. Also covers managing an agent's skill catalog with `mcptoon skills` (list / resolve / sync / doctor / add / remove, plus a version gate, a read-only health check, derived Roo/OpenCode views, tombstoned removals, and a gate that refuses to prune a view from an undecided removal). Also route here when a doc folder is too big to read — 文档太多、AGENTS.md / CONTEXT.md / docs/ 太大、不知道该读哪个文件、想省 token 读文档、整读一个目录太贵: `mcptoon docs index <dir>` then `mcptoon docs resolve "<question>"` returns the few files worth opening — read one chapter, not all — offline, no LLM,
Hooks 1
Runs on these events- SessionStartcommand
No description in the file.
MCP servers 1
Starts with the plugin- mcptoonstdio
mcptoon serve
Using mcptoon in Claude Code
Type a command in a Claude Code session:
/mcptoon:mcptoon-setupSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update mcptoon@mcptoon
- Refresh the marketplace
- /plugin marketplace update mcptoon
- Turn it off for now
- /plugin disable mcptoon@mcptoon
- Remove it
- /plugin uninstall mcptoon@mcptoon
Skills in mcptoon
- mcptoonactiveing123/mcptoon
Compress MCP tool discovery with the mcptoon CLI. Trigger when a session has a large MCP tool catalog (many servers/tools), when the user mentions token cost, tool discovery, mcptoon, or asks to list/call MCP tools efficiently. Also route here when the user says the MCP tool list is too large, the agent context window is filling up with tool schemas, or they need the same MCP servers configured across Claude Code, Cursor, Codex, Cline, Windsurf and other agents. Also covers managing an agent's skill catalog with `mcptoon skills` (list / resolve / sync / doctor / add / remove, plus a version gate, a read-only health check, derived Roo/OpenCode views, tombstoned removals, and a gate that refuses to prune a view from an undecided removal). Also route here when a doc folder is too big to read — 文档太多、AGENTS.md / CONTEXT.md / docs/ 太大、不知道该读哪个文件、想省 token 读文档、整读一个目录太贵: `mcptoon docs index <dir>` then `mcptoon docs resolve "<question>"` returns the few files worth opening — read one chapter, not all — offline, no LLM,
430stars
mcptoon plugin questions
How do I install the mcptoon plugin?
In Claude Code run /plugin marketplace add activeing123/mcptoon, then /plugin install mcptoon@mcptoon.
What does the mcptoon plugin include?
mcptoon bundles 1 command, 1 skill, hooks, MCP servers.
What commands does the mcptoon plugin add?
It adds /mcptoon:mcptoon-setup. Run them in Claude Code with the plugin prefix, for example /mcptoon:mcptoon-setup.
How do I update or remove the mcptoon plugin?
Update it with claude plugin update mcptoon@mcptoon in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall mcptoon@mcptoon.