Nodebench

NodeBench MCP

Investigate a topic and return a sourced report fast. The NodeBench MCP architecture is now split into three install lanes that share one runtime.

Default install: 9 visible tools total, including 7 core workflow tools: investigate, compare, track, summarize, search, report, and ask_context.

# Core workflow lane

claude mcp add nodebench -- npx -y nodebench-mcp

Power lane

claude mcp add nodebench-power -- npx -y nodebench-mcp-power

Admin lane

claude mcp add nodebench-admin -- npx -y nodebench-mcp-admin

What's New

• v3 default surface - the default preset is now a workflow-first facade instead of a tool warehouse.
• Admin-only runtime gates - dashboards and the observability watchdog no longer start on the default hot path. Use --admin, --dashboards, or --watchdog explicitly.
• Faster health path - --health now loads only the active preset instead of eagerly loading every domain.
• Separate install lanes - nodebench-mcp-power and nodebench-mcp-admin are now published companion packages, while --preset power and --preset admin remain compatible paths on the core package.

New here? Read [AGENT_LOGIC.md](./AGENT_LOGIC.md) for the complete guide to how NodeBench thinks.

---

RETHINK REDESIGN APR 2026

This section records a repo-grounded reexamination of NodeBench MCP as of April 2026. It is intentionally blunt. The goal is to shrink the product to clear, measurable workflows and make the runtime and claims trustworthy.

Repo-grounded findings

• Surface area and messaging were out of sync
• At the time of this audit, the README marketed 350+ tools, founder under 50 tools, and full as 338.
• The audit that drove this section measured roughly 28 tools in the starter tools/list payload, roughly 186 in founder, and roughly 546 in full, before counting the extra dynamic-loading helpers separately.
• The core executable is overloaded
• packages/mcp-local/src/index.ts currently combines MCP serving, analytics tracking, embedding bootstrapping, profiling hooks, A/B instrumentation, dynamic tool loading, dashboard startup, and engine hosting in one runtime path.
• Performance is not yet credibly measured
• During this audit, node packages/mcp-local/dist/index.js --health took about 2.9s locally because CLI mode eagerly loaded all toolsets before exit.
• The main performance comparison in the package measures local toolchain overhead, not end-user outcome quality, startup SLOs, workflow completion, or real provider spend.
• Cost reporting is not yet auditable
• The current profiler relies on heuristic per-tool cost estimates, not authoritative provider billing or exact token accounting.
• Workflow clarity is weak
• The product currently explains presets, domains, discovery engines, and meta-systems before it proves one concrete job to be done.

Redesign principles

1. One dominant workflow per persona

• A founder should land on one obvious path.
• A banker should land on one obvious path.
• The MCP should prove value before it explains its architecture.

1. Truthful counts and truthful claims

• Preset docs, README counts, and tools/list output must agree.

1. Speed is a product behavior

• Measure startup time, tools/list payload size, per-tool latency, and workflow time-to-first-value.

1. Keep optional systems out of the hot path

• Embeddings, dashboards, profilers, and engine surfaces should not make the default MCP startup slower.

1. Prefer workflows over catalogs

• Opinionated, repeatable outcomes are more valuable than an oversized flat tool inventory.

1. Ship process, not prose

• The right mental model is a small number of strong workflows with evidence and verification, not a giant capabilities brochure.

Execution board

Reference models

• [agent-skills](https://github.com/addyosmani/agent-skills): process, not prose. Strong lifecycle commands, checkpoints, and evidence requirements.
• [GitHub MCP Server](https://github.com/github/github-mcp-server): narrower toolsets improve tool choice and reduce context size. The server also exposes a simple tool-search utility.
• [Google MCP Toolbox](https://github.com/googleapis/mcp-toolbox): performance and operability are anchored in concrete runtime primitives such as connection pooling and OpenTelemetry, not only internal heuristics.

Bottom line

NodeBench MCP should evolve from a monolithic "hundreds of tools" surface into a smaller number of opinionated workflow products backed by a measurable, trustworthy runtime.

Unified cross-surface spec: docs/architecture/UNIFIED_WORKFLOW_SPEC.md

Production companion spec: docs/architecture/UNIFIED_WEB_MCP_PRODUCTION_SPEC.md

Founder MCP flow spec: docs/architecture/FOUNDER_MCP_FLOW_SPEC.md

---

What You Get

NodeBench is now a workflow-first MCP. The default install proves one concrete job quickly, and the heavier surfaces are still available when you explicitly ask for them.

Install Lanes And Presets

Default workflow

ASK -> CHECK -> WRITE -> SAVE

The default preset is optimized for that loop. It does not start local dashboards or the observability watchdog unless you pass admin flags explicitly.

# Claude Code core lane

claude mcp add nodebench -- npx -y nodebench-mcp

Claude Code power lane

claude mcp add nodebench-power -- npx -y nodebench-mcp-power

Claude Code admin lane

claude mcp add nodebench-admin -- npx -y nodebench-mcp-admin

Windsurf / Cursor - add --preset to args only when you want a compatibility preset on the core package

---

Quick Start

Claude Code (CLI)

claude mcp add nodebench -- npx -y nodebench-mcp

claude mcp add nodebench-power -- npx -y nodebench-mcp-power claude mcp add nodebench-admin -- npx -y nodebench-mcp-admin

Or add to ~/.claude/settings.json or .mcp.json in your project root:

{

"mcpServers": { "nodebench": { "command": "npx", "args": ["-y", "nodebench-mcp"] } } }

Cursor

Add to .cursor/mcp.json (or Settings > MCP). Use the cursor preset to stay within Cursor's tool limit:

{

"mcpServers": { "nodebench": { "command": "npx", "args": ["-y", "nodebench-mcp", "--preset", "cursor"] } } }

Windsurf

Add to .windsurf/mcp.json (or Settings > MCP > View raw config):

{

"mcpServers": { "nodebench-power": { "command": "npx", "args": ["-y", "nodebench-mcp-power"] } } }

Other MCP Clients

Any MCP-compatible client works. Point command to npx and choose the package that matches the lane you want:

• ["-y", "nodebench-mcp"] for the tiny default workflow lane
• ["-y", "nodebench-mcp-power"] for the expanded founder/research lane
• ["-y", "nodebench-mcp-admin"] for the operator lane

Add "--preset", " " only when you want a compatibility preset on the core package.

First Prompts to Try

# Research a topic

Use investigate with topic="Anthropic" to produce a sourced report

Compare two entities

Use compare with entities=["Anthropic","OpenAI"] to get a side-by-side brief

Turn rough notes into a report

Use report with topic="AI agent infrastructure" and context="..." to produce a decision memo

Search live web + saved knowledge

Use search with query="MCP server best practices 2026"

Track an entity

Use track with action="add" and entity="Anthropic"

Expand only when you need more

Use discover_tools("visual QA for a Vite app"), then load_toolset("ui_ux_dive")

Optional: API Keys

export GEMINI_API_KEY="your-key"        # Web search + vision (recommended)

export GITHUB_TOKEN="your-token" # GitHub (higher rate limits)

Set these as environment variables, or add them to the env block in your MCP config:

{

"mcpServers": { "nodebench": { "command": "npx", "args": ["-y", "nodebench-mcp"], "env": { "GEMINI_API_KEY": "your-key", "GITHUB_TOKEN": "your-token" } } } }

---

Progressive Discovery — How Optional Toolsets Stay Off the Hot Path

The default preset exposes 9 tools. Everything else stays off the hot path until you deliberately load a specific toolset.

How it works

1. discover_tools("your task description")    → ranked results from the full registry

1. load_toolset("ui_ux_dive") → a specific toolset activates in your session
2. Use the newly loaded tools directly → no proxy, native binding
3. Keep the default surface small → only load what the workflow needs

Multi-modal search engine

discover_tools scores tools using 14 parallel strategies: