
When
Bundles six WhenLabs developer tools behind a single MCP server with eight endpoints. You get aware for generating AI context files, berth for port conflict detection, envalid for .env validation, stale for documentation drift scanning, vow for license checking, and velocity for task timing. The whenlabs_summary endpoint runs all five scanners in one call and returns a unified health report. Claude calls these automatically when you're debugging port conflicts, validating environment configs, or checking for stale docs. One npx install registers everything in Claude Code and injects a CLAUDE.md block so the assistant knows when to reach for each tool.
- GitHub stars
- 2
- tools
- 8
- transport
- STDIO
- last updated
- Apr 21, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
aware_syncDetect stack and regenerate AI context files
Detect stack and regenerate AI context files
No parameter schema in public metadata yet.
berth_checkScan project for port conflicts
Scan project for port conflicts
No parameter schema in public metadata yet.
envalid_validateValidate .env files against schema
Validate .env files against schema
No parameter schema in public metadata yet.
stale_scanDetect documentation drift
Detect documentation drift
No parameter schema in public metadata yet.
vow_scanScan licenses and validate against policy
Scan licenses and validate against policy
No parameter schema in public metadata yet.
velocity_start_taskStart timing a coding task
Start timing a coding task
No parameter schema in public metadata yet.
velocity_end_taskEnd timing and record results
End timing and record results
No parameter schema in public metadata yet.
whenlabs_summaryUnified rollup across all five scanners in one call
Unified rollup across all five scanners in one call
No parameter schema in public metadata yet.
Sponsors
Readme
@whenlabs/when
Six tools. One install.
A single installable toolkit that brings six WhenLabs developer tools into your Claude Code workflow. After install, the tools are exposed over a single MCP server and Claude calls them automatically when relevant.
when doctor — six tools, one unified health report
Install
npx @whenlabs/when install
One-time setup. The installer:
- Registers a single MCP server (
whenlabs) in your Claude Code configuration - Injects a CLAUDE.md block so Claude knows when to use each tool
- Cleans up any legacy
velocity-mcpregistration (velocity is now bundled)
The six tools
| Tool | Purpose |
|---|---|
| aware | Auto-detect stack and generate AI context files (CLAUDE.md, .cursorrules, …) |
| berth | Detect port conflicts before starting dev servers |
| envalid | Validate .env files against a schema |
| stale | Detect documentation drift between docs and code |
| vow | Scan dependency licenses and validate against policy |
| velocity | Time coding tasks and learn from historical data |
MCP tools
Details
- Repository
- github.com/whenlabs-org/when
- Package
@whenlabs/when- Transport
- STDIO
- Registry
- MCP registry, active