Skip to main content
Glama

hypertool-mcp

Version Downloads Discord TypeScript MCP Compatible License: MIT

โšก 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

Included Servers

Best For

web-dev

Git, Docker, Filesystem, Browser, Testing

Full-stack web development

data-scientist

Python, Jupyter, Database, Filesystem, Plotting

Data analysis & ML workflows

devops

Docker, Kubernetes, AWS, Terraform, Monitoring

Infrastructure & deployment

content-creator

Notion, Slack, Grammar, SEO, Social

Writing & content management

researcher

Perplexity, Arxiv, Wikipedia, Filesystem

Research & knowledge work

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.

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:

Feature

Description

Guide

๐ŸŽญ Personas

Pre-configured MCP server bundles with curated toolsets. Get started instantly with ready-to-use workflows for web-dev, data science, DevOps, and more.

Personas Guide

๐Ÿ“ Server Groups

Organize MCP servers into logical groups. Launch related servers together, switch between projects, and maintain focused contexts.

Advanced Guide

๐Ÿ“Š Context Measurement

See token estimates for every tool. Optimize your toolsets by understanding exactly how much context each tool consumes.

Context Measurement

๐Ÿ”ง Configuration Mode

Smart separation of toolset management from operational tools. Keep your AI focused on work, not configuration.

Configuration Mode Guide

๐ŸŽฏ Dynamic Toolsets

Build, modify, and switch between toolsets on the fly. Adapt your AI's capabilities to match your current task.

Examples & Recipes

๐Ÿง  Tool Annotations

Enhance tools with custom descriptions, examples, and context. Improve your AI's tool selection accuracy by 89%.

Advanced Guide

๐Ÿš€ HTTP Mode

Run HyperTool as a long-lived HTTP server for persistent connections and faster response times.

Advanced Guide

๐Ÿ”Œ Unlimited Servers

Connect as many MCP servers as you need. Break free from the 100-tool limit without sacrificing performance.

Quick Start

โ“ 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.

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 and configurations stored? A: Everything is stored locally in ~/.toolprint/hypertool-mcp/:

  • Personas: ~/.toolprint/hypertool-mcp/personas/

  • Toolsets: ~/.toolprint/hypertool-mcp/toolsets/

  • Preferences: ~/.toolprint/hypertool-mcp/config/ You can directly edit these files when HyperTool is not running.

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.

Q: How accurate are the token estimates in context measurement? A: The estimates use BPE-based approximation for consistent relative comparisons between tools. They're perfect for understanding which tools consume more context, but not exact counts since different LLMs use different tokenizers.

Q: Does context measurement slow down my toolsets? A: No! Token counts are cached and add less than 10ms overhead. You won't notice any performance impact.

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

๐Ÿ› ๏ธ Development Setup

Prerequisites

  • Node.js 18+

  • Python 3.8+ (for pre-commit hooks)

Quick Setup

# Clone and install git clone https://github.com/toolprint/hypertool-mcp.git cd hypertool-mcp just setup-dev # Installs dependencies and pre-commit hooks

Pre-commit Hooks

This project uses pre-commit hooks to ensure code quality:

# Install pre-commit hooks (included in setup-dev) just setup-pre-commit # Run hooks manually just pre-commit-check # On staged files just pre-commit-check-all # On all files # Skip hooks for emergency commits (use sparingly) SKIP=eslint,typescript git commit -m "emergency fix"

Available Commands

just build # Build the project just test # Run tests just lint # Run linting just format # Format code just typecheck # Check types just pre-publish-checks # Run all quality checks

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 ๐ŸŽฏ

Related MCP Servers

  • A
    security
    A
    license
    A
    quality
    A proxy server that unifies multiple MCP servers, enabling seamless tool, prompt, and resource management via the MetaMCP App.
    Last updated -
    26
    146
    Apache 2.0
  • -
    security
    A
    license
    -
    quality
    A 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 -
    20
    3
    MIT License
    • Apple
  • -
    security
    F
    license
    -
    quality
    Proxy that aggregates multiple MCP servers and presents them as a unified interface, allowing clients to access resources from multiple servers transparently.
    Last updated -
    5
  • -
    security
    F
    license
    -
    quality
    A 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 -
    11
    6
    • Apple

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/toolprint/hypertool-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server