How activeing123/mcptoon works
mcptoon is a local-first MCP and skills hub for agent workflows. A user invokes its CLI to discover installed servers, find tools, and call them; it can also expose configured tools through an MCP gateway, compress schemas for on-demand retrieval, and synchronize servers and skills across agents. The map includes documented OpenAPI/GraphQL, OAuth, resources/prompts, sandbox, and token-usage capabilities. The README establishes these product branches; source excerpts and the index support several internal relationships, but unsampled implementation details are not inferred as call edges.
Main entry points: serve.py MCP gateway · cli.py Command interface · sync.py Agent sync · compressor.py Schema compression
Components 26
CLI and configuration
- Command interface
src/mcptoon/cli.py - Local configuration
src/mcptoon/config.py - Server discovery
src/mcptoon/discover.py - Tool installation
src/mcptoon/installer.py
MCP gateway
- MCP gateway
src/mcptoon/serve.py - Tool routing
src/mcptoon/router.py - MCP client
src/mcptoon/client.py - Tool manifest
src/mcptoon/manifest.py - Native tools
src/mcptoon/native_tools.py - Resources and prompts
src/mcptoon/mcp_extras.py - OpenAPI passthrough
src/mcptoon/openapi.py - GraphQL passthrough
src/mcptoon/graphql.py - OAuth
src/mcptoon/oauth.py - Code sandbox
src/mcptoon/exec_sandbox.py
Agents and skills
- Agent sync
src/mcptoon/sync.py - Skills catalog
src/mcptoon/skills.py - Agent plugin
src/mcptoon/plugin.py
Context and usage
- Schema compression
src/mcptoon/compressor.py - Schema simplifier
src/mcptoon/schema_simplifier.py - TOON encoding
src/mcptoon/_toon/encoders.py - Tool cache
src/mcptoon/cache.py - Usage tracking
src/mcptoon/usage.py - Session history
src/mcptoon/session_log.py
Other components
- Agent user
- MCP servers
- Agent clients
Connections 32
- Agent user → Command interface: runs commands
README.md - Command interface → Server discovery: discovers tools
README.md - Command interface → Tool installation: installs tools
README.md - Command interface → MCP gateway: starts gateway
src/mcptoon/cli.py - Server discovery → MCP servers: scans installed
README.md - Command interface → Tool routing: calls tools
README.md - Tool routing → MCP client: dispatches calls
src/mcptoon/router.py - MCP client → MCP servers: sends MCP requests
- MCP gateway → Tool manifest: indexes tools
src/mcptoon/serve.py - MCP gateway → Tool routing: dispatches tools
src/mcptoon/serve.py - MCP gateway → Native tools: exposes native tools
src/mcptoon/serve.py - MCP gateway → Agent plugin: serves skill prompts
src/mcptoon/serve.py - MCP gateway → Tool cache: uses cached schemas
src/mcptoon/serve.py - MCP gateway → Usage tracking: records usage
src/mcptoon/serve.py - Command interface → Agent sync: syncs clients
README.md - Agent sync → Agent clients: configures clients
README.md - Command interface → Skills catalog: manages skills
README.md - Skills catalog → Agent clients: shares skills
README.md - Command interface → Schema compression: compresses schemas
README.md - Schema compression → Schema simplifier: simplifies schemas
src/mcptoon/compressor.py - Schema simplifier → Usage tracking: uses token estimates
src/mcptoon/schema_simplifier.py - Schema compression → Tool cache: reads cached tools
- Command interface → TOON encoding: formats compact output
- Command interface → Usage tracking: reports savings
src/mcptoon/cli.py - MCP gateway → Session history: logs tool activity
src/mcptoon/serve.py - MCP gateway → OpenAPI passthrough: supports passthrough
README.md - MCP gateway → GraphQL passthrough: supports passthrough
README.md - MCP gateway → OAuth: supports authorization
README.md - MCP gateway → Code sandbox: supports execution
README.md - MCP gateway → Resources and prompts: supports resources
README.md - Tool installation → Local configuration: updates configuration
src/mcptoon/installer.py - Agent sync → Local configuration: reads settings
src/mcptoon/sync.py