Skip to content

Add mcptoon: cross-agent MCP management CLI #299

Description

@activeing123

mcptoon — Cross-Agent MCP Management CLI

Repository: https://github.com/activeing123/mcptoon
Category: Developer Tools / MCP Management
Transport: stdio (built-in mcptoon serve)

Description

mcptoon is a zero-dependency CLI that discovers, manages, and syncs MCP server configurations across Claude Code, Cursor, OpenCode, and other AI coding agents. It reduces token overhead by 99.8% via Zero-Token name-only manifests.

Key Features

  • Token Optimization: Slim tool manifests cut 71,929 tokens → 123 tokens (99.8% savings)
  • Cross-Agent Sync: mcptoon sync writes configs to all IDE clients simultaneously
  • Continuous Watch: mcptoon sync --watch monitors config files for real-time sync
  • Health Check: mcptoon health detects zombie/dead MCP servers
  • Built-in Serve Bridge: mcptoon serve acts as a unified MCP server for all your tools
  • Token Dashboard: mcptoon stats shows token savings per server
  • Per-Tool Toggle: mcptoon toggle enables/disables individual tools

Installation

pip install mcptoon
# or
uv tool install mcptoon

Usage

mcptoon discover          # auto-discover all MCP servers
mcptoon manifest --slim   # ultra-compact tool listing
mcptoon serve             # run as unified MCP bridge
mcptoon stats             # token savings dashboard
mcptoon toggle exa search # toggle a tool off

Docker

docker run activeing123/mcptoon manifest --slim

Academic Validation

  • Cites SEP-1576 (official MCP optimization proposal)
  • Firecrawl benchmark: CLI = ~200 tokens vs MCP = ~44K tokens
  • Anthropic code-execution-with-MCP: 98.7% context reduction

License

Apache 2.0

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions