Give your AI the best tools from all your MCPs 🎯

[](https://npmjs.com/package/@toolprint/hypertool-mcp) [](https://npmjs.com/package/@toolprint/hypertool-mcp) [](https://discord.gg/MbvndnJ45W) [](https://www.typescriptlang.org/) [](https://modelcontextprotocol.io) [](LICENSE) ## ⚡ Features ### 🔓 **Break Free from Tool Limits** Connect unlimited MCP servers. Use 10, 50, or 500+ tools total - your AI only sees what it needs. ### 🎯 **Task-Specific Toolsets** Build "git-essentials" with 5 tools instead of drowning in 47 Git commands. Switch contexts instantly. ### 🧠 **Smart Tool Descriptions** Enhance tools with examples and context. Watch your AI pick the right tool 89% more often. ## 🚀 Quick Start ### Step 1: Copy Your Existing Config ```bash # In your project directory cp .mcp.json .mcp.hypertool.json ``` ### Step 2: Point Your AI to HyperTool Replace your `.mcp.json` with: ```json { "mcpServers": { "hypertool": { "command": "npx", "args": ["-y", "@toolprint/hypertool-mcp", "mcp", "run", "--mcp-config", ".mcp.hypertool.json"] } } } ``` ### Step 3: Create Your First Toolset Restart your AI and try: ``` You: "Create a toolset called 'coding' with git and docker tools" AI: "Created 'coding' toolset with 15 focused tools" You: "Switch to coding toolset" AI: "Equipped! I now have just the tools needed for development" ``` **That's it!** Your AI is now focused and effective. 🎉 💡 **Want automated setup?** Try our interactive `setup` command - see [Advanced Guide](guides/ADVANCED.md#setup-command) for details. 📚 **Configuration Mode:** HyperTool uses a smart Configuration Mode to keep toolset management separate from your operational tools. Learn more in the [Configuration Mode Guide](guides/CONFIGURATION_MODE.md). ## 🎭 Personas: Pre-configured Tool Bundles (NEW!) Don't want to configure from scratch? Use personas - ready-to-use MCP server bundles with pre-built toolsets. ### What are Personas? Think of personas as "app bundles" for your AI - they come with: - ✅ Pre-configured MCP servers - ✅ Curated toolsets for specific workflows - ✅ Everything you need to get started instantly ### Quick Start with Personas ```bash # 1. Clone the persona collection git clone https://github.com/toolprint/awesome-mcp-personas # 2. Add a persona (e.g., web-dev persona) hypertool-mcp persona add awesome-mcp-personas/personas/web-dev # 3. Run with the persona npx -y @toolprint/hypertool-mcp mcp run --persona web-dev ``` That's it! No server configuration needed. The persona brings its own servers and toolsets. 📦 **Browse all available personas**: [awesome-mcp-personas](https://github.com/toolprint/awesome-mcp-personas) ### Available Personas | Persona | Included Servers | Best For | |---------|-----------------|----------| | **web-dev** | Git, Docker, Filesystem, Browser, Testing | Full-stack web development | | **data-scientist** | Python, Jupyter, Database, Filesystem, Plotting | Data analysis & ML workflows | | **devops** | Docker, Kubernetes, AWS, Terraform, Monitoring | Infrastructure & deployment | | **content-creator** | Notion, Slack, Grammar, SEO, Social | Writing & content management | | **researcher** | Perplexity, Arxiv, Wikipedia, Filesystem | Research & knowledge work | ### Persona vs Standard Mode ```bash # Standard Mode (use your existing MCP servers): npx -y @toolprint/hypertool-mcp mcp run --mcp-config .mcp.hypertool.json # Persona Mode (bundled servers + pre-built toolsets): npx -y @toolprint/hypertool-mcp mcp run --persona web-dev # Persona Mode with specific toolset: npx -y @toolprint/hypertool-mcp mcp run --persona web-dev --equip-toolset frontend ``` 💡 **Pro tip**: Personas can be mixed with your existing servers! Add `--mcp-config` to include your custom servers alongside the persona's servers. 📚 **Learn more**: See the complete [Personas Guide](guides/PERSONAS.md) for detailed instructions, creating custom personas, and troubleshooting. ## 📊 Context Measurement (NEW!) See exactly how much context each tool consumes. Optimize your toolsets with token estimates for every tool. **Why it matters:** - 🎯 **Optimize context usage** - Identify heavyweight tools consuming your context window - 📉 **Make informed decisions** - See token costs before adding tools to toolsets - 🔍 **Compare alternatives** - Find lighter tools that do the same job - 💡 **Budget your context** - Understand exactly what you're exposing to your AI **How to use:** Ask your AI to use these MCP tools to see context information: - `list-available-tools` - Shows token estimates for all available tools - `get-active-toolset` - Shows token usage for your currently equipped toolset Each tool displays estimated tokens and percentage of total context consumed. Perfect for building lean, efficient toolsets! ## 🎬 Demo ### Hotswap toolsets across 100+ tools _Targeted toolsets across any number of MCPs. Swap to the best toolset for a goal with a tool call. Dynamic tool registration._ ## 🏗️ How It Works ``` Before: Tool Chaos 😵 ┌─────────────┐ ┌─────────────────────────────┐ │ Claude/ │──▶│ 50+ tools from 8 servers │ │ Cursor │ │ ❌ Wrong picks │ │ │ │ ❌ Slow decisions │ │ │ │ ❌ Confused context │ └─────────────┘ └─────────────────────────────┘ After: Expert Mode 🎯 ┌─────────────┐ ┌──────────────┐ ┌─────────────────┐ │ Claude/ │──▶│ HyperTool │──▶│ ALL Your Tools │ │ Cursor │ │ (Local) │ │ (Same servers) │ └─────────────┘ └──────────────┘ └─────────────────┘ │ ▼ ┌─────────────────┐ │ Smart Toolsets │ │ 🔨 coding (5) │ ← "I'm coding now" │ 📝 writing (3) │ ← "I'm writing now" │ 📊 analysis (4) │ ← "I'm analyzing now" └─────────────────┘ ✅ Expert picks every time ``` ### What's a "Toolset"? Think Playlists for Your AI Just like Spotify playlists organize your music, toolsets organize your AI tools: ``` ALL YOUR TOOLS (64 total) YOUR TOOLSETS ┌────────────────────────────┐ ┌──────────────────┐ │ 🐳 Docker (19 tools) │ │ 🔨 "coding" │ │ • build_image │ ┌───▶ │ • git.status │ │ • create_container │ │ │ • git.commit │ │ • run_container │ │ │ • docker.build │ │ • stop_container │ │ │ • docker.run │ │ • [... 15 more] │ │ │ • github.pr │ ├────────────────────────────┤ │ └──────────────────┘ │ 🔀 Git (12 tools) │───┤ │ • status │ │ ┌──────────────────┐ │ • commit │ │ │ 📝 "writing" │ │ • push │ └───▶ │ • notion.create │ │ • [... 9 more] │ │ • slack.send │ ├────────────────────────────┤ │ • grammarly.fix │ │ 📝 Notion (8 tools) │─────┐ └──────────────────┘ │ 💬 Slack (6 tools) │ │ │ 📊 Linear (10 tools) │ │ ┌──────────────────┐ │ 🧪 Testing (9 tools) │ └─▶ │ 🐛 "debugging" │ └────────────────────────────┘ │ • logs.search │ │ • docker.logs │ AI sees ALL 64 tools = confused 😵 │ • traces.view │ └──────────────────┘ AI sees 3-5 tools = focused 🎯 ``` ## 💼 Real-World Toolsets Create focused toolsets for different workflows: ### 🔨 Development Mode ``` "deep-coding": git + docker + filesystem (12 tools) → Everything you need for feature development "code-review": git + github + linear (10 tools) → Review PRs, update tickets, merge with confidence "debugging": logs + docker + traces + alerts (8 tools) → Find and fix issues fast ``` ### 📝 Content Creation ``` "writing": notion + grammarly + slack (6 tools) → Blog posts, docs, and team updates "research": perplexity + notion + filesystem (7 tools) → Deep dives with organized notes ``` ### 🎬 Real Chat Example ``` You: "I need to debug our API" AI: "I'll switch to the debugging toolset for better focus" [Now has: logs, traces, curl, docker] You: "Actually, let's write the incident report" AI: "Switching to writing toolset" [Now has: notion, slack, templates] ``` 💡 **Pro tip**: Start with 3-5 tools per toolset. Your AI will thank you! ## 📋 All Features Explore everything HyperTool can do: | Feature | Description | Guide | |---------|-------------|-------| | **🎭 Personas** | Pre-configured MCP server bundles with curated ---