Bugmole MCP

To use Bugmole from ChatGPT, claude.ai or Claude Desktop without running anything yourself, connect the hosted server instead. See Use Bugmole from ChatGPT or Claude. This page covers the local server that runs next to your project.

Bugmole exposes repository exploration, planning, execution, diff proposal, review, and reporting through MCP tools. The MCP server is intended for an agent that needs an explicit QA workflow rather than a generic one-step login or test command.

Start the server

The default local endpoint is 127.0.0.1:3187:

npm run bugmole:mcp

Or run the project worker, which keeps the MCP service available while it executes dashboard-created runs:

bugmole serve

Workflow

The recommended sequence is:

bugmole_explore — inspect project structure, specifications, entrypoints, and available journeys. Follow up with bugmole_record_discovery and bugmole_journey_next until the journey is fully explored.
bugmole_plan — produce a concrete plan with an actor, preconditions, actions, assertions, and evidence.
bugmole_run — execute the approved plan in the configured environment.
bugmole_report — summarize outcomes and evidence.

The server's bugmole://guidance/agent-testing resource describes each step in detail. The Bugmole skill teaches Claude this workflow.

Safety and evidence

Plans must preserve explicit proof requirements and should include negative or blocked cases where the business rules require them. Destructive operations remain project-scoped and subject to environment and watermark gates. If verification is blocked, the report should say why and identify the missing evidence.