mcp-probe-kit — Claude Code MCP server: what it does, how to install
Coordinates spec-driven engineering workflows with resumable plans, local session history, and quality gates. Helpful when tracking progress across deep coding tasks.
claude mcp add mcp-probe-kit -- npx -y mcp-probe-kitWhat mcp-probe-kit 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.
What it helps with
- 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 for the agent
- 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
How to install mcp-probe-kit
Platform CLI
claude mcp add mcp-probe-kit -- npx -y mcp-probe-kitPlatform CLI
codex mcp add mcp-probe-kit -- npx -y mcp-probe-kitConfig file
{
"mcpServers": {
"mcp-probe-kit": {
"command": "npx",
"args": [
"-y",
"mcp-probe-kit"
]
}
}
}Config file
{
"servers": {
"mcp-probe-kit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-probe-kit"
]
}
}
}Platform CLI
gemini mcp add mcp-probe-kit npx -y mcp-probe-kitStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-probe-kit
How to install mcp-probe-kit in Claude Code?
Run claude mcp add mcp-probe-kit -- npx -y mcp-probe-kit. The CLI registers the server directly using npx.
What is the main purpose of mcp-probe-kit?
It guides model workflows through explicit plans, preserves task state during interruptions, and enforces verification gates before code release.
What runtime requirements are needed to run the server?
It requires Node.js 20 or newer. You can also set MCP_HISTORY_SESSION=0 if you want to disable local session logging.
