mcptoon es un cliente CLI (interfaz de línea de comandos) en Python, sin dependencias, que se conecta a cualquier servidor MCP (Model Context Protocol, el protocolo estándar para que los agentes de IA invoquen herramientas externas) por stdio o HTTP y devuelve los resultados en TOON, un formato compacto propio, en lugar de JSON (formato de intercambio de datos habitual pero verboso). Su objetivo es recortar el gasto de tokens —las unidades de texto que los modelos de IA procesan y por las que se factura— asociado al uso del protocolo MCP.
En la práctica, listar las herramientas de cinco servidores MCP puede costar alrededor de 10.000 tokens de JSON, y cada llamada a una herramienta añade entre 500 y 3.000 tokens más por el envoltorio {"content":[{"type":"text","text":"..."}]}. mcptoon reduce el descubrimiento de herramientas en un 97% (de unos 2.000 tokens a unos 60 para 96 herramientas) y los resultados entre un 40% y un 60% en datos estructurados. El paquete ocupa unos 50 KB, funciona en Windows, macOS y Linux, y se integra con cualquier agente capaz de ejecutar comandos de shell: Claude Code, Codex, OpenCode, Cursor o CatPaw, entre otros.
La herramienta ofrece varias banderas de salida (--toon, --compact, --json, --raw, --head, --max-chars), caché de esquemas con cinco minutos de vida, bloqueo de operaciones peligrosas (delete, drop, purge…) salvo confirmación explícita con --destructive, y registro local de uso sin telemetría. La configuración se guarda en ~/.mcptoon/config.json, con un override a nivel de proyecto en ./.mcptoon.json, y se comparte entre todos los agentes.
El repositorio, publicado bajo licencia Apache 2.0, incluye cerca de 1.700 líneas de código, una suite de 98 tests que se ejecuta en 0,09 segundos y documentación en inglés y chino. Sus autores subrayan que mcptoon es un cliente MCP independiente de terceros, sin relación con Anthropic.
