Overview
HyperTool MCP is a tool that helps AI applications access and manage tools across multiple MCP (Model Context Protocol) servers while keeping the AI focused through curated toolsets. It enables connecting unlimited MCP servers and creating small, task-specific toolsets (personas) so an AI agent only sees the tools it needs for a given task.
Key capabilities:
- Combine tools from many MCP servers and present only relevant subsets to the AI.
- Define personas (pre-configured bundles) to quickly onboard common workflows (e.g., web-dev, data-scientist).
- Group servers for easier management and fast launch of related server sets.
- Smart tool descriptions and examples to improve tool selection accuracy.
Purpose
To simplify and scale how AI systems access heterogeneous tools across multiple MCP servers. HyperTool reduces tool noise, accelerates decision-making, and lets you manage large tool collections via focused toolsets and personas.
Quickstart (Essentials)
- Copy your existing configuration:
cp .mcp.json .mcp.hypertool.json - Configure HyperTool as an MCP server in your config (example):
{
"mcpServers": {
"hypertool": {
"command": "npx",
"args": ["-y", "@toolprint/hypertool-mcp", "mcp", "run", "--mcp-config", ".mcp.hypertool.json"]
}
}
} - Create or use a persona/toolset and run HyperTool via npx. Example persona install:
git clone https://github.com/toolprint/awesome-mcp-personas
hypertool-mcp persona add awesome-mcp-personas/personas/web-dev
npx -y @toolprint/hypertool-mcp mcp run --persona web-dev Notes:
- Personas are pre-built bundles of MCP servers + curated toolsets for common workflows.
- Use small toolsets (3–7 tools) for best AI performance.
Important files & project layout
(From repository README — confirm locally)
- README.md — Project overview and instructions
- guides/ — Detailed guides: PERSONAS.md, ADVANCED.md, CONFIGURATION_MODE.md, etc.
- demos/ — Demo assets and videos
- src/ — Source code (TypeScript)
- package.json, LICENSE, etc.