Hypertool-mcp centralizes and manages AI tools from multiple MCP servers by organizing them into focused 'toolsets' to enhance AI performance and overcome tool limits.
- Discover Available Tools: List all tools from connected MCP servers with metadata, namespaced names, and reference IDs
- Create & Manage Toolsets: Build custom toolsets by selecting specific tools, with options to auto-equip and save configurations
- Dynamic Tool Control: Equip/unequip toolsets to dynamically filter available tools, ensuring only relevant tools are exposed to the AI
- Toolset Operations: List, delete, and get detailed status of saved toolsets including tool counts and server information
- Tool Annotations: Add contextual notes and guidance to individual tools within toolsets to improve AI tool selection
- Server Organization: Group MCP servers logically by project or environment for easier management
- Enhanced AI Performance: Improve focus, decision-making speed, and accuracy by providing task-specific, curated tool contexts while bypassing typical AI tool limits
Distributed through npm, allowing easy installation and updates via the npm package registry.
Built with TypeScript, providing type safety and better developer experience for those extending or modifying the MCP server.
⚡ 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
Step 2: Point Your AI to HyperTool
Replace your .mcp.json
with:
Step 3: Create Your First Toolset
Restart your AI and try:
That's it! Your AI is now focused and effective. 🎉
💡 Want automated setup? Try our interactive setup
command - see Advanced Guide 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.
🎬 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
What's a "Toolset"? Think Playlists for Your AI
Just like Spotify playlists organize your music, toolsets organize your AI tools:
💼 Real-World Toolsets
Create focused toolsets for different workflows:
🔨 Development Mode
📝 Content Creation
📁 Server Groups (NEW!)
Organize your MCP servers into logical groups for easy management:
Server groups make it easy to:
- 🚀 Launch related servers together
- 📊 Organize servers by project or environment
- 🔄 Switch between different server configurations
- 🎯 Maintain focused tool contexts
🎬 Real Chat Example
💡 Pro tip: Start with 3-5 tools per toolset. Your AI will thank you!
❓ FAQ
General Questions
Q: How is this different from just using MCP servers directly? A: HyperTool lets you use unlimited MCP servers without hitting the 100-tool limit, and dynamically switches between focused toolsets for better AI performance.
Q: Can I use multiple toolsets at once?
A: In stdio mode (default), use --equip-toolset <name>
when launching. HTTP mode supports one active toolset but you can switch anytime.
Q: Where are my toolsets stored?
A: Locally in ~/.toolprint/hypertool-mcp/
. Explore the directory to see your configurations.
Setup & Compatibility
Q: Does this work with Claude Desktop / Cursor / Claude Code? A: Yes! Cursor has full hot-swapping support. Claude Desktop works with restart. Claude Code hot-swap coming soon.
Q: What if an MCP server goes down? A: HyperTool monitors health and automatically reconnects when servers come back. Your toolsets stay intact.
Q: Can I share toolsets with my team? A: Import/export is coming soon! For now, you can copy and share toolset files - they'll work if your team has the same MCP servers configured.
Technical Questions
Q: How do I add tools from a new MCP server?
A: Just add the server to your .mcp.hypertool.json
config. It's automatically available for toolsets.
Q: Can I use this in production? A: Yes! For enterprise support, contact us.
🎮 App Compatibility
Works with ANY MCP-compatible app! HyperTool is a standard MCP server, so if your app supports MCP, it supports HyperTool.
Hot-swap Toolsets Without Restarts
App | Status | How to Switch Toolsets |
---|---|---|
Cursor/VSCode | ✅ Full support | Switch toolsets instantly - no restart needed! |
Claude Code | ⏳ Coming soon | Use --equip-toolset <name> flag (track progress) |
Claude Desktop | ⏳ In progress | Restart app after switching toolsets |
📚 Learn More
- 🔬 Research & Performance - Why focused toolsets work
- 🚀 Advanced Features - Tool annotations, HTTP mode, CLI
- 🔧 Troubleshooting - Common issues and solutions
- 📖 Examples & Recipes - Toolset patterns for every workflow
🛠️ Development Setup
Prerequisites
- Node.js 18+
- Python 3.8+ (for pre-commit hooks)
Quick Setup
Pre-commit Hooks
This project uses pre-commit hooks to ensure code quality:
Available Commands
Service command
The hypertool-mcp service
subcommand is currently disabled and will exit with a
notification when invoked.
🤝 Contributing
Found a bug? Have an idea? We'd love your help!
📄 License
MIT License - see LICENSE file for details.
Built by developers who got tired of watching AI pick the wrong tools 🎯
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Proxies to all of a user's MCPs and allows them to expose dynamic toolsets of tools from those servers to improve context and tool-usage.
Related MCP Servers
- AsecurityAlicenseAqualityA proxy server that unifies multiple MCP servers, enabling seamless tool, prompt, and resource management via the MetaMCP App.Last updated -523143Apache 2.0
- -securityAlicense-qualityA proxy service that connects MCP clients to remote MCP servers, allowing users to use server keys from MCP.so to access remote resources without running their own server.Last updated -303MIT License
- -securityFlicense-qualityA flexible proxy that enables discovery and execution of tools across multiple Model Context Protocol (MCP) servers and JavaScript functions, reducing context size even when dealing with hundreds of tools.Last updated -25