Hypertool
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.
What is Hypertool?
Hypertool is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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.
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.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Proxies to all of a user's MCPs and allows them to expose dy
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @toolprint/hypertool-mcpManual Installation
npx -y @toolprint/hypertool-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Hypertool
Hypertool MCP is a meta-layer server that proxies all of a user's other MCP servers through a single connection, solving the token and tool-count limits that arise when many MCP servers are active simultaneously. It lets you define named 'toolsets' — curated subsets of tools from any of your MCPs — and switch between them dynamically, so Claude only sees the relevant tools for the current task rather than hundreds of tool definitions eating context budget.
Prerequisites
- Node.js 18 or higher installed
- An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
- Existing MCP servers already configured (Hypertool proxies them, so at least one other MCP server should be set up)
- An .mcp.json or .mcp.hypertool.json config file listing your MCP servers
Create an MCP configuration file
Hypertool reads your existing MCP server definitions from a JSON config file. Copy your current .mcp.json and rename it .mcp.hypertool.json, or create a new one listing all the MCP servers you want Hypertool to proxy.
cp .mcp.json .mcp.hypertool.jsonTest Hypertool from the command line
Run Hypertool directly with npx to verify it starts and connects to your MCP servers defined in the config file.
npx -y @toolprint/hypertool-mcp mcp run --mcp-config .mcp.hypertool.jsonAdd Hypertool to your MCP client configuration
Replace your individual MCP server entries in claude_desktop_config.json with a single Hypertool entry. Hypertool will proxy all servers from the referenced config file.
Create and equip toolsets
Use Hypertool's CLI or its MCP tools to create named toolsets grouping tools from different servers. Equip a toolset at startup with --equip-toolset to pre-filter which tools Claude sees.
npx -y @toolprint/hypertool-mcp mcp run --mcp-config .mcp.hypertool.json --equip-toolset codingUse personas for common workflows
Hypertool supports persona packs — pre-built toolset collections for roles like web-dev, data-scientist, devops, researcher. Clone the awesome-mcp-personas repository and add a persona to get a curated tool experience.
git clone https://github.com/toolprint/awesome-mcp-personas
npx -y @toolprint/hypertool-mcp mcp run --persona web-devHypertool Examples
Client configuration
Single Hypertool entry in claude_desktop_config.json that replaces all individual MCP server entries. The --mcp-config flag points to a file listing your real MCP servers.
{
"mcpServers": {
"hypertool": {
"command": "npx",
"args": [
"-y",
"@toolprint/hypertool-mcp",
"mcp",
"run",
"--mcp-config",
".mcp.hypertool.json"
]
}
}
}Prompts to try
Interact with Hypertool's own MCP tools to manage context and toolsets during a session.
- "List all available tools and show me how many tokens each one costs."
- "Switch to the 'coding' toolset and show me the active tools."
- "Create a new toolset called 'research' that includes only the web search and file read tools."
- "What is the current token usage of my active toolset?"Troubleshooting Hypertool
Hypertool starts but shows no tools from proxied servers
Verify that .mcp.hypertool.json (or the file passed via --mcp-config) exists in the working directory and contains valid MCP server definitions with correct commands and args. Check the path is absolute if running from a config file.
Hypertool reports exceeding the 100-tool limit warning
This is expected when many MCP servers are proxied. Use --equip-toolset at startup or call get-active-toolset and list-available-tools inside Claude to select a focused toolset, reducing the tools visible to the model.
Persona or toolset files not found at startup
Toolsets and personas are stored in ~/.toolprint/hypertool-mcp/. Ensure you've either created toolsets via the CLI or cloned an awesome-mcp-personas pack into the correct directory before passing --persona.
Frequently Asked Questions about Hypertool
What is Hypertool?
Hypertool is a Model Context Protocol (MCP) server that 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. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Hypertool?
Install via npm with the command: npx -y @toolprint/hypertool-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Hypertool?
Hypertool works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Hypertool free to use?
Yes, Hypertool is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Hypertool Alternatives — Similar Developer Tools Servers
Looking for alternatives to Hypertool? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Hypertool in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Hypertool?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.