Log inSubmit server
Mcptoon logo

Mcptoon

Reduces MCP tool context, discovers and routes tools, and synchronizes configurations across supported AI clients.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget

Install Mcptoon

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcptoon": {
      "command": "uvx",
      "args": [
        "mcptoon"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx mcptoon

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1d ago.

Overview

mcptoon compresses MCP tool catalogs and results so agents can access more tools with less context usage. It discovers servers from existing client configurations, searches a registry, and routes calls through a command-line interface. Use it when large tool catalogs, skills, or documentation consume too much context, or when several agents need a shared setup. Installation uses pip, with `quickstart` handling discovery and agent configuration.

Use cases

  • Reduce context consumed by large MCP tool catalogs
  • Discover MCP servers already configured in local agents
  • Search for and call tools from the command line
  • Synchronize MCP configuration across multiple clients
  • Resolve skills or documentation chapters on demand

Key features

  • Compact tool manifests with on-demand schemas
  • Lossless result compression and retrieval
  • MCP server discovery and plain-language search
  • Automatic tool routing with `call --auto`
  • Agent configuration synchronization
  • Skill and documentation resolution

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

14/14 checks healthy over the last 51d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · mcptoon (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars397Stargazers on the source repository.
Last commit3d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity1 upvotesConfig copies, upvotes, and views on AllMCPs.

How Mcptoon works

What mcptoon does

mcptoon acts as a local catalog, router, and context-reduction layer for MCP tools and agent skills. It can find MCP servers already configured in supported clients, expose a compact tool index, retrieve full schemas only when needed, and route calls from the command line. It also supports compact handling of tool results, with a retrieval mechanism for the original output.

The same approach applies to skills and documentation. Skills can be represented by a small pointer and resolved when required, while documentation can be selected by chapter rather than loaded in full. The project also includes OpenAPI and GraphQL passthrough, OAuth support, MCP resources and prompts, saved connections, and a code sandbox.

How it works

After installation, mcptoon quickstart detects available MCP servers, configures supported agents, and installs the /mcptoon skill into detected agents. The native CLI can be invoked by any agent that can run shell commands, without adding an MCP server entry or editing client JSON files. For GUI clients, sync writes the required configuration.

A typical workflow is:

  1. Run mcptoon discover to inspect servers already present in client configurations.
  2. Use mcptoon search to find servers by plain-language terms.
  3. Call a matching tool with mcptoon call, or use mcptoon call --auto to find the server automatically.
  4. Run mcptoon inspect when a full tool schema is needed.

mcptoon manifest displays the compact catalog. mcptoon bench measures token usage with tiktoken, and retrieve can recover original content from a compressed result handle.

Setup and configuration

Install the package with:

Terminal
pip install mcptoon

Then run:

bash
mcptoon quickstart

This setup is described as zero-dependency and zero-configuration, and the package uses Python's standard library. The CLI can also be installed without immediately wiring it into an agent; use mcptoon mode to check the operating mode. mcptoon upgrade updates the installation when a newer release is available.

For client configuration, mcptoon sync supports configuration generation for Claude, Cursor, Cline, Windsurf, VS Code, and Claude Code. The toggle command enables or disables the integration, while policy sets an output tier for individual tools. Skills can be distributed to agent folders with skills sync.

Tools and capabilities

  • Compact MCP tool manifests with on-demand schema lookup.
  • Lossless result compression with retrieval of the original content.
  • Session-level deduplication for identical output in one turn.
  • Discovery of servers from existing client configurations.
  • Plain-language server search and automatic call routing.
  • Resolution of skills and documentation chapters.
  • Synchronization across supported agent configurations.
  • Benchmarking through mcptoon bench.
  • OpenAPI and GraphQL passthrough, OAuth, MCP resources, and prompts.

Limitations and notes

The token-reduction figures depend on the tool catalog and workload. The project reports benchmark results for synthetic and real-world catalogs, but those measurements should be treated as examples rather than a guarantee for every setup. Direct mode leaves mcptoon installed without wiring it into an agent, so it will not reduce context until the integration is configured. Client behavior also depends on whether the client runs the CLI directly or receives a generated configuration entry.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Mcptoon

mcptoon is an MCP server that connects agents to locally configured MCP servers and agent clients through a compact catalog and routing layer. Its main tools and commands include manifest, discover, search, inspect, call, retrieve, skills resolve, and docs resolve, reducing context use while keeping full schemas and results available on demand.

Install it with `pip install mcptoon`, then run `mcptoon quickstart`. The quickstart detects MCP servers, configures supported agents, and installs the `/mcptoon` skill into detected agents. The package uses Python's standard library and is described as having zero dependencies.

Run `mcptoon manifest` to view the compact catalog and let full schemas load only when needed. mcptoon also compresses results, deduplicates identical output within a turn, and provides `retrieve` for the original content. Use `mcptoon bench` to measure token usage for your catalog.

Yes. Cursor is one of the supported clients. mcptoon can import existing server configurations and use `sync` to write client configuration. Cursor users can also invoke the installed `/mcptoon` skill where agent skill support is available.

Use `mcptoon search` to find servers with plain-language terms, then call a tool with `mcptoon call`. To combine discovery and invocation, use `mcptoon call --auto`. Run `mcptoon inspect` when you need the complete schema for a specific tool.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMcptoon AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcptoon?style=directory)](https://allmcps.com/mcp/mcptoon)
HTML Embed
<a href="https://allmcps.com/mcp/mcptoon"><img src="https://allmcps.com/api/badge/mcptoon?style=directory" alt="Mcptoon on AllMCPs" /></a>