# toolmenu

> toolmenu is an open-source MCP server for developer tools. Test harness that checks an MCP server's tool menu, calls and releases like a client would. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Linux, macOS, Windows
- **Repository:** https://github.com/niksa90/toolmenu
- **MCP Registry name:** io.github.niksa90/toolmenu
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says toolmenu walks through a server the way an MCP client does: it reads the tool list, makes calls, inspects results and OAuth sign-in, and compares each release against the previous one. Checks are tied to the MCP spec, the tool's own schemas and documented client limits, and a finding comes with a rule id and a suggested fix.

The project positions itself as deterministic: no LLM runs during checks, so the same server should produce the same findings on each run, which suits CI. It reports how many prompt tokens the menu costs, flags menus that change mid-conversation, and can post a single pull request comment with a pass or fail verdict.

It is aimed at MCP server authors and maintainers who want to catch breaking changes, schema problems and token bloat before clients or agents do. It does not judge whether an agent chooses the right tool.

## Features

- **Menu and schema checks:** Validates the tool list and results against the MCP spec and the tool's declared output schemas.
- **Release diffing:** Compares two menus and classifies changes as breaking, minor or notice, with the semver bump needed.
- **Scenario sessions:** Plays a scenario or auto-generates one, calling tools and listing the menu after each step.
- **OAuth discovery check:** Walks an HTTP server's OAuth discovery as a spec-following client would, without logging in.
- **Token cost estimates:** Estimates how many tokens each tool's name, description and schema add to the model's context.
- **CI pull request comment:** Generates a GitHub workflow that posts one updating comment with a verdict on each pull request.

## Good for

- Catch breaking changes to tool names or required parameters before a release ships
- Check that an MCP server's tool list is accepted by a strict client SDK
- Keep prompt caching effective by spotting menus that change between runs
- Gate pull requests on a deterministic MCP server review in CI

## Install

### Claude Code (Terminal)

```sh
claude mcp add toolmenu -- npx -y toolmenu
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "toolmenu": {
      "command": "npx",
      "args": [
        "-y",
        "toolmenu"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "toolmenu": {
      "command": "npx",
      "args": [
        "-y",
        "toolmenu"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "toolmenu": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "toolmenu"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "toolmenu": {
      "command": "npx",
      "args": [
        "-y",
        "toolmenu"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "toolmenu": {
      "command": "npx",
      "args": [
        "-y",
        "toolmenu"
      ]
    }
  }
}
```

## FAQ

### Does it use an LLM?

No. The README says no LLM is involved, so the same server gives the same findings on every run.

### How is it installed?

The README shows running it with npx toolmenu, and it needs Node 22 or later.

### Does it test whether an agent picks the right tool?

No. The README says that needs evals with a model, which toolmenu does not run.

### Which transports does it support?

The README says it starts stdio servers or connects to HTTP servers.

### Is toolmenu free?

Yes. toolmenu is open source, so you can use and self-host it for free.

### How do I add toolmenu to Claude Code?

Run this command in your terminal: claude mcp add toolmenu -- npx -y toolmenu

### What are the best alternatives to toolmenu?

The closest alternatives to toolmenu are ToolFit + MCPCheck, Api Test MCP, Toolkien, Toolmesh and MCP Tool Poisoning Scanner.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [ToolFit + MCPCheck](https://ai-powered.com/mcp/toolfit-mcpcheck): ToolFit + MCPCheck is a freemium MCP server for developer tools.
- [Api Test MCP](https://ai-powered.com/mcp/api-test-mcp): Api Test MCP is an open-source MCP server for developer tools.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Toolmesh](https://ai-powered.com/mcp/toolmesh): Toolmesh is an MCP server for developer tools.
- [MCP Tool Poisoning Scanner](https://ai-powered.com/mcp/mcp-tool-poisoning-scanner): MCP Tool Poisoning Scanner is a paid MCP server for security.
- [Toolbox](https://ai-powered.com/mcp/toolbox): Toolbox is a freemium MCP server for developer tools.
- [MCP Canary](https://ai-powered.com/mcp/mcp-canary): MCP Canary is an MCP server for developer tools.
- [Toolshed](https://ai-powered.com/mcp/toolshed-2): Toolshed is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/toolmenu
