hypertool

HyperTool is an MCP server that helps you orchestrate and optimize access to tools from many MCP servers. It enables you to create focused toolsets (tool subsets) that your AI can use, switch between toolsets quickly, and manage pre-configured bundles called personas for rapid startup. With HyperTool, you can inspect context usage per tool, see token estimates, and tailor tool access to the task at hand. You can run HyperTool locally via npx, then connect your existing MCP servers or use one of the bundled personas to get started fast. The system also supports a smart Configuration Mode to keep toolset management separate from the operational tools, making it easier to evolve your tool landscape without affecting runtime tooling.

To use HyperTool, point your MCP configuration to HyperTool and let it handle toolset registration, smart tool selection, and context budgeting. You can create toolsets like coding, writing, or data analysis, each with a curated mix of tools from different MCP servers. You can also leverage Pre-configured Tool Bundles called personas to boot quickly with ready-made servers and toolsets. If you prefer a fully automated startup, you can use the interactive setup flow and combine personas with your own servers as needed.

Prerequisites:

• Node.js (recommended: LTS, 18+)
• npm or yarn
• Basic knowledge of MCP config files (.mcp.json)

Installation steps:

1. Ensure Node.js and npm are installed

   • Check versions: node -v and npm -v

2. Install HyperTool MCP via npx (no global install required)

   • Create or navigate to your project directory
   • Use HyperTool to run with your mcp config:

   cp .mcp.json .mcp.hypertool.json # optional step to copy an existing config

   npx -y @toolprint/hypertool-mcp mcp run --mcp-config .mcp.hypertool.json

3. If you want to use Personas for rapid startup:

   • Clone a persona collection and add a persona: git clone https://github.com/toolprint/awesome-mcp-personas hypertool-mcp persona add awesome-mcp-personas/personas/web-dev
   • Run with the persona: npx -y @toolprint/hypertool-mcp mcp run --persona web-dev

4. Optional: customize configuration

   • Edit .mcp.hypertool.json to point to your MCP servers and toolsets
   • Use HyperTool’s configuration mode guides for best practices

Tips and notes:

• HyperTool supports both standard mode (your existing MCP servers) and persona mode (bundled servers with pre-built toolsets).
• You can mix personas with your own servers by including --mcp-config in the run command to combine servers.
• Use the Context Measurement features to see token estimates for each tool and optimize your toolsets for leaner context usage.
• The Configuration Mode helps keep toolset management separate from the tools themselves, which is useful for large tool inventories.
• If you’re integrating with many MCPs, consider starting with a small toolset (e.g., coding) and gradually expanding.
• For troubleshooting, verify that the .mcp.hypertool.json file is correctly formatted and that all referenced MCP servers are reachable.