Hypertool MCP

Give your AI the best tools from all your MCPs 🎯

⚡ 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

# In your project directory

cp .mcp.json .mcp.hypertool.json

Step 2: Point Your AI to HyperTool

Replace your .mcp.json with:

{

"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 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.

🎭 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

# 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

Available Personas

Persona vs Standard Mode

# 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 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.

Active toolset showing token usage per 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:

❓ 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: What's the difference between Personas and Standard Mode? A: Standard Mode uses your existing MCP server configurations. Personas are pre-packaged bundles that include both MCP servers AND curated toolsets - perfect for getting started quickly or trying new workflows.

*