# mcp-probe-kit

Coordinates spec-driven engineering workflows with resumable plans, local session history, and quality gates. Helpful when tracking progress across deep coding tasks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 39
- Author: mybolide
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mybolide/mcp-probe-kit
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-probe-kit

## What it does

The server turns unstructured assistant prompts into verifiable delivery cycles driven by specs. By default, it exposes 29 tools covering architecture exploration, test drafting, spec validation, and review gates. Tasks start through targeted handlers for bugs, new features, or codebase onboarding.

Execution stays recoverable. The `plan_heartbeat` tool records ongoing progress, while `resume_plan` picks up the next pending action. Before finishing work, `converge` ensures implementation and test evidence are verified. Chat handoffs persist locally in `docs/history-session/` without requiring vector databases.

Node.js 20 or newer is mandatory for the runtime. Adding the optional memory stack dynamically raises the active tool count from 29 to 35.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-probe-kit -- npx -y mcp-probe-kit
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp-probe-kit -- npx -y mcp-probe-kit
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-probe-kit npx -y mcp-probe-kit
```

## When to use it
- Restore interrupted agent execution steps via resume_plan
- Prevent pull request handoff without passing verification gates
- Decompose complex releases into parent-child specifications
- Persist local session handoffs under docs/history-session

## Example prompts
- Initialize a new task using start_feature and break down the specifications
- Check current execution status with resume_plan and proceed to the pending step
- Run converge to verify tests and reviews before completing the release

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