whenlabs-org avatar

When

whenlabs-org/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 tools

Public 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:

  1. Registers a single MCP server (whenlabs) in your Claude Code configuration
  2. Injects a CLAUDE.md block so Claude knows when to use each tool
  3. Cleans up any legacy velocity-mcp registration (velocity is now bundled)

The six tools

ToolPurpose
awareAuto-detect stack and generate AI context files (CLAUDE.md, .cursorrules, …)
berthDetect port conflicts before starting dev servers
envalidValidate .env files against a schema
staleDetect documentation drift between docs and code
vowScan dependency licenses and validate against policy
velocityTime coding tasks and learn from historical data

MCP tools


View the full README on GitHub

Details

Repository
github.com/whenlabs-org/when
Package
@whenlabs/when
Transport
STDIO
Registry
MCP registry, active