# hypertool-mcp

A local proxy in front of your MCP servers. It holds every tool you have and hands the model only the set a task needs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 155
- Author: toolprint
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/toolprint/hypertool-mcp
- Updated: 2025-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/hypertool-mcp

## What it does

hypertool-mcp installs as a regular MCP server and runs locally. You point it at a config of your existing servers, and it registers tools dynamically based on the active toolset or persona. The agent sees the five commands that matter instead of fifty.

Toolsets are built on the fly. Ask the agent to create one from git and docker, then switch to it with a single call. Personas go further: they bundle MCP servers with pre-built toolsets, added via `hypertool-mcp persona add` and launched with `--persona`. A persona can run alongside your own servers if you also pass `--mcp-config`.

Context measurement is built in. The `list-available-tools` and `get-active-toolset` tools show a token estimate per tool and its share of the context window, which is how you spot the heavy ones and drop them. Toolset management lives in a separate configuration mode, so it stays out of your working tools.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add hypertool-mcp -- npx -y @toolprint/hypertool-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add hypertool-mcp -- npx -y @toolprint/hypertool-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hypertool-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@toolprint/hypertool-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hypertool-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@toolprint/hypertool-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add hypertool-mcp npx -y @toolprint/hypertool-mcp
```

## When to use it
- keep unused MCP tools out of the context window
- build a toolset for one task and swap between toolsets
- connect many MCP servers without a bloated tool list
- estimate token cost per tool
- start from a ready-made server bundle instead of configuring one

## Example prompts
- Switch to the coding toolset
- Show the active toolset and token usage per tool

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md