When

io.github.WhenLabs-orgPublished by GitHub account WhenLabs-orgv0.12.3Updated Oct 24, 2026

The WhenLabs developer toolkit — 6 tools, 7 MCP endpoints, one install.

VerifiedSTDIODesktop onlyDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

A local MCP server bundling six WhenLabs developer tools, letting an assistant scan projects for port conflicts, env schema issues, doc drift, license policy, a

What you can do
Detect the project stack and regenerate AI context files such as CLAUDE.md and .cursorrules, and scan for port conflicts before starting dev servers. Validate .env files against a schema and detect documentation drift between docs and code. Scan dependency licenses and check them against policy. Start and end timing for coding tasks and record results. Produce a unified rollup across the five scanners in one call.
When to use it
Useful for developers working in Claude Code who want project health checks — stack context files, port conflicts, env validation, doc drift, license policy and task timing — reachable from the assistant without leaving the editor.
Requirements
Runs locally over stdio with Node 20 or newer, installed via the npm package. The install command registers the server in the Claude Code configuration and injects a CLAUDE.md block; manual configuration is also documented. No accounts, API keys or environment variables are declared.
Before you install
The installer modifies your Claude Code configuration, adds a CLAUDE.md block and removes any legacy velocity-mcp registration. Several tools write files, such as regenerated AI context files, and scans read project files including .env contents. Review changes before committing.

Installation

In SourceWeft

  1. Open When in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
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

Eight endpoints across the six tools:

EndpointWhat it does
aware_syncDetect stack and regenerate AI context files
berth_checkScan project for port conflicts
envalid_validateValidate .env files against schema
stale_scanDetect documentation drift
vow_scanScan licenses and validate against policy
velocity_start_taskStart timing a coding task
velocity_end_taskEnd timing and record results
whenlabs_summaryUnified rollup across all five scanners in one call

All eight are served by the single whenlabs MCP server (stdio, Node 20+). Fix/init/auxiliary commands remain available via each tool's CLI (npx @whenlabs/<tool> --help).

CLI

bash
when init       # Onboard a project — detect stack, bootstrap configs, run all checkswhen doctor     # Run all six tools and show a unified health reportwhen install    # Register MCP server in Claude Codewhen uninstall  # Remove MCP server

For per-tool operations, use the tool directly:

bash
npx @whenlabs/stale scannpx @whenlabs/envalid validatenpx @whenlabs/berth checknpx @whenlabs/aware syncnpx @whenlabs/vow scan

Manual MCP configuration

If you're not using the install command, add this to your Claude Code MCP config:

json
{  "mcpServers": {    "whenlabs": {      "command": "npx",      "args": ["@whenlabs/when", "when-mcp"]    }  }}

License

MIT — see LICENSE

Built by Siddharth at WhenLabs

Source: README.md at commit c389d5f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.12.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts