cleanroom-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLEANROOM_PORT | No | Port for the dashboard (default: 7391) | |
| CLEANROOM_ROLE | Yes | Role for the agent (analyst, implementer, monitor, or lead) | |
| CLEANROOM_SOLO | No | Enable solo mode (set to 'true' to enable) | |
| CLEANROOM_USER | Yes | Username for the agent | |
| CLEANROOM_PROJECT | No | Path to the project directory (default: current directory) | |
| CLEANROOM_DASHBOARD | No | Enable web dashboard (set to 'true' to enable) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| cleanroom_initA | Create a new clean-room reimplementation project with the standard directory structure, config file, and audit trail. This sets up the analysis/, implementation/, and verification/ directories with proper separation. Use this at the start of a new clean-room project. |
| cleanroom_statusA | Get the current status of the clean-room project including spec progress, team members, and audit trail integrity. Shows a summary of all specifications by status, team composition, and whether the audit chain is intact. |
| cleanroom_spec_createA | Create a new behavioral specification for a component of the target software. Uses a structured template to guide the analyst through documenting observable behavior without including implementation details. The spec will be in 'draft' status. Available templates: api-endpoint, file-format, protocol, behavior, data-structure, algorithm. |
| cleanroom_spec_readA | Read the contents of a specification. Analysts can read any spec. Implementers can only read specs that have been handed off (status: 'handed-off'). Monitors can read any spec for review purposes. |
| cleanroom_spec_listA | List all specifications in the project. Supports filtering by status. Implementers will only see specs with status 'handed-off'. Returns a summary of each spec with name, status, template, and target component. |
| cleanroom_spec_submitA | Submit a draft specification for contamination review by the monitor. The monitor will check that the spec contains no implementation details, source code, or internal architecture from the original. Only draft or rejected specs can be submitted. |
| cleanroom_spec_reviewA | Review a submitted specification for contamination. Check that it contains only observable behavior descriptions and no implementation details from the original software. Approve it for handoff or reject it with specific feedback about which sections need revision. |
| cleanroom_spec_handoffA | Release an approved specification to the implementation team. This copies the spec to the handoff directory, makes it available as an MCP Resource for implementer agents, and creates a signed audit record of the handoff. This action is IRREVERSIBLE — once handed off, the spec cannot be modified. |
| cleanroom_team_addA | Add a team member (human or AI agent) to the clean-room project. Each member is assigned a role that determines their tool access. Only the lead role can add team members. |
| cleanroom_team_listA | List all team members in the clean-room project with their roles, types (human/AI), and any associated metadata. |
| cleanroom_attestA | Record a formal attestation for the clean-room process. For human team members, this confirms they have not accessed restricted materials. For AI agents, this records what data the agent had access to, including training data disclosures. Attestations are permanently recorded in the audit trail. |
| cleanroom_ai_logA | Log AI agent activity to the audit trail. Call this to record significant actions taken by AI agents, including session starts, model identifiers, and context that was provided to the agent. |
| cleanroom_audit_logA | View the project's tamper-evident audit trail. Every tool call, spec handoff, review decision, access denial, and attestation is logged with timestamps and hash-chained entries. Supports filtering by type and date. |
| cleanroom_audit_verifyA | Verify the integrity of the project's audit trail by checking the SHA-256 hash chain. If any entry has been modified, added, or removed, this will detect the break point. All roles can verify the audit trail. |
| cleanroom_audit_exportA | Export the complete audit trail as JSON or CSV for compliance records and legal documentation. The export includes all entries with their hash chain, timestamps, and actor information. |
| cleanroom_impl_read_specA | Read a specification that has been handed off to the implementation team. Returns the full spec content along with extracted acceptance criteria that the implementation must satisfy. Only handed-off specs are accessible through this tool. |
| cleanroom_impl_run_testsA | Run the test suite for the reimplementation. Executes the test command in the implementation directory and returns results. Optionally filter to tests for a specific spec. |
| cleanroom_verify_runA | Compare the reimplementation's behavior against the original software using black-box testing. Feeds identical inputs to both commands and compares outputs. Does NOT access or analyze source code of either — both are treated as opaque executables. Comparison modes: exact (byte-for-byte), fuzzy (whitespace-normalized), semantic (JSON-aware). |
| cleanroom_verify_reportA | Generate a report from the most recent verification run, or a summary of all verification runs. Includes match rates, mismatched cases, and spec coverage. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyst-session | Start an analysis session to study the original software and write behavioral specifications. |
| implementer-session | Start an implementation session to build from handed-off specifications. |
| monitor-session | Start a monitoring session to review specs for contamination and oversee the clean-room process. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| project-status | Current clean-room project status including spec progress, team members, and audit trail integrity. |
TDQS
Scored across 19 tools
Most tools have clearly distinct purposes, but cleanroom_spec_read and cleanroom_impl_read_spec overlap in that both read specs, though the former has role-based restrictions and the latter is specifically for handed-off specs. Overall, the separation is clear enough.
All tools share the cleanroom_ prefix and use snake_case, but the pattern varies between domain_verb (cleanroom_init, cleanroom_status) and domain_object_verb (cleanroom_spec_create, cleanroom_audit_log). This is mostly consistent but not perfectly uniform.
19 tools is on the higher side but reasonable for a full clean-room workflow covering setup, team management, specs, audit, implementation, and verification. Each tool serves a distinct function in the process.
The core lifecycle is covered (init, spec creation/review/handoff, audit, verification), but there is no tool to edit or delete a draft spec, and no way to remove team members. These gaps could hinder workflow efficiency but are not fatal.