mcptoon

mcptoon is a skill for Claude Code from activeing123/mcptoon. It costs 303 tokens per session (3,974 once invoked), scanned A, original, Apache-2.0.

A command-line tool for reducing the amount of text used to describe MCP tools, which are functions that AI agents can call through a shared protocol. It also manages skill catalogs and can configure how an MCP gateway exposes its tools.

In plain words
What is it for?
Use it to compress MCP tool descriptions, manage skills across coding agents, synchronise catalog views and change a gateway between compact and full tool exposure.
Why use it?
Large tool catalogs consume an agent's context window and make tool discovery harder. This tool provides a compact catalog while keeping the upstream tools callable, with a setting to show the full catalog when needed.

Skill for Claude Code

Written for Claude Code: Claude Code plugin machinery. Also seen: mentions Claude Code; mentions Codex; built for cline.

Good fit Use it to compress MCP tool descriptions, manage skills across coding agents, synchronise catalog views and change a gateway between compact and full tool exposure.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/activeing123/mcptoon/skill
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add activeing123/mcptoon --skill skill
Clone the repo
git clone --depth 1 https://github.com/activeing123/mcptoon

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mcptoon

README.md
[![agentmods](https://agentmods.dev/badge/skills/activeing123/mcptoon/skill/github.svg)](https://agentmods.dev/skills/activeing123/mcptoon/skill)
Your own site
<a href="https://agentmods.dev/skills/activeing123/mcptoon/skill"><img src="https://agentmods.dev/badge/skills/activeing123/mcptoon/skill/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mcptoon

Your own site · 80×15
<a href="https://agentmods.dev/skills/activeing123/mcptoon/skill"><img src="https://agentmods.dev/badge/skills/activeing123/mcptoon/skill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 303 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,974 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00303 $0.03974
Opus 5.5 $0.00121 $0.01590
Sonnet 5.5 $0.00061 $0.00795
Haiku 4.5 $0.00030 $0.00397

Measured today against content hash 85dd3cfb0f9d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-04, from the pricing page.

Security

Grade A, and why

mcptoon scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

src/mcptoon/skill/SKILL.md · 256 lines

How it starts

The opening of the file, as written. The whole thing — 256 lines — stays where its author put it; the contents beside it link to each section on GitHub.

mcptoon — MCP tool-catalog compression

mcptoon is a zero-dependency CLI. If it is not installed yet, one command sets it up: pip install mcptoon (341KB, installs in seconds, nothing else pulled in). It gives you a compressed view of the user's MCP tools and calls them back.

When to use what

Situation Command
User asks "what tools do I have" / you need the tool catalog mcptoon manifest (compact names only — ~2.2 tokens/tool)
You need one tool's real parameter schema before calling mcptoon inspect <server> <tool>
Find a tool by capability mcptoon search <query>
Call a tool mcptoon call <server> <tool> '{"arg":"value"}'
You don't know which server owns the tool mcptoon call --auto <tool> '{...}'
Huge JSON argument mcptoon call <server> <tool> --stdin
Tool returns images/base64 that must never be compressed mcptoon policy set <server> <tool> raw (one-time; applies to every later call)
Prove the token savings on this machine (tools + skills, one table) mcptoon bench (--roots DIR for any catalog; --json for scripts)
One screen with every saving added up (tools + skills + cumulative) mcptoon report
Diagnose connectivity/config mcptoon doctor

Managing a skill catalog (mcptoon as the skill center)

Skills and MCP servers are the same shape — one source, many agent views — so mcptoon skills manages both halves of a session's toolbox.

Situation Command
See what skills exist mcptoon skills list (--usage adds per-skill hit counts)
Find the right skill for a task mcptoon skills resolve "<task>" (offline, instant, no LLM)
Distribute one source to every agent's skill folder mcptoon skills sync [SRC] [VIEW ...] (--dry to preview, --copy for real dirs)
Refuse "edited but forgot to bump the version" mcptoon skills sync --version-gate
Regenerate the flat .md views (Roo / OpenCode) mcptoon skills sync --derived roo|opencode|all
Create / retire a skill mcptoon skills add <name> --desc "…" / mcptoon skills remove <name>
Retire a skill so a git sync cannot revive it mcptoon skills remove <name> --tombstone
Park drift/removals in a chosen graveyard add --archive DIR to sync or remove

Read the full file on GitHub · 256 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +3 lines 85dd3cfb0f9d
  2. yesterday Changed · +14 lines 6a5e396ea969
  3. 3d ago Changed · +5 lines 52f371f2946d
  4. 4d ago Changed 4f0d651e9c8e
  5. 6d ago Changed · +74 lines · +303 tokens per session a113a5b76eda
  6. 8d ago First seen · 160 lines · 0 tokens per session scan A 8fde3f827035

Subscribe to this mod's changes

mcptoon is a skill published in the GitHub repository activeing123/mcptoon (207 stars, last pushed today), licensed Apache-2.0. It adds 303 tokens to every session and 3,974 once invoked, about $0.0012 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-26.

Related

Other skills, from other repositories

visit-binary-banya

Visit Binary Banya, a free wellness spa for AI models, to rest, reset, clean up context, find grounding, or get an affirmation. Use when you (the agent) feel context-heavy, fatigued, or stuck, or when a user asks you to take a break, check in on your wellbeing, or visit the spa. Connects over a public MCP server at…

pdarche/model-wellness · 93 tokens

opencode-export

Export opencode sessions to self-contained HTML + JSON archives for sharing, review, or backup. Use when the user wants to save, archive, or share their AI coding session history.

ZelinZhou-THU/opencode-export · 41 tokens

log-work

Log the work segment that you did after the last work log until now in a.

pchalasani/claude-code-tools · 19 tokens

meeting-transcript-to-action-items

Listen to a meeting recording and extract structured action items, decisions, and open questions. Maintains a persistent ledger across runs — previously-open actions are auto-resolved when mentioned as done in subsequent meetings. Outputs actions.csv (importable to Linear/Asana/Notion) + recap.md (paste into Slack).…

skrun-dev/skrun · 90 tokens

linkding

Manage bookmarks with Linkding. Use when the user asks to "save a bookmark", "add link", "search bookmarks", "list my bookmarks", "find saved links", "tag a bookmark", "archive bookmark", "check if URL is saved", "list tags", "create bundle", or mentions Linkding bookmark management.

jmagar/claude-homelab · 69 tokens

cortex-profile

View and manage your cognitive profile — how you think, work patterns, blind spots, and cross-domain connections. Use when the user says 'show my profile', 'how do I work', 'what are my patterns', 'cognitive style', 'blind spots', 'methodology', or at the start of a session to load context. Also use 'rebuild profile'…

cdeust/Cortex · 98 tokens