Back to Browse

When MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (7 strong, 5 medium validity signals). No known CVEs in dependencies. ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. Trust signals: trusted author (3/3 approved). 1 finding(s) downgraded by scanner intelligence.

23 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

database

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-whenlabs-org-when": {
      "args": [
        "-y",
        "@whenlabs/when"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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.

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

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

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

For per-tool operations, use the tool directly:

npx @whenlabs/stale scan
npx @whenlabs/envalid validate
npx @whenlabs/berth check
npx @whenlabs/aware sync
npx @whenlabs/vow scan

Manual MCP configuration

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

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

License

MIT — see LICENSE


Built by Siddharth at WhenLabs

Reviews

No reviews yet

Be the first to review this server!