WebMCP CLI

Validate manifests, publish origins, and check status — from your terminal.

Install

Run commands directly with npx — no install needed:

npx webmcpreg --help

Or install globally:

npm install -g webmcpreg

Install via Homebrew

On macOS (or Linux with Homebrew), you can install with brew:

brew tap nichochar/toolindex https://github.com/nichochar/toolindex
brew install webmcpreg

Validate a manifest

Validate a local file or a remote URL. Defaults to .well-known/webmcp.json in the current directory.

# Validate a local file
webmcpreg validate .well-known/webmcp.json

# Validate from a URL
webmcpreg validate https://example.com/.well-known/webmcp.json

# Default: validates .well-known/webmcp.json in cwd
webmcpreg validate

Exit code 0 on success, 1 on failure — CI-friendly.

Publish to registry

Submit your origin to the Web MCP Registry. The registry will fetch and validate your manifest automatically.

webmcpreg publish https://example.com

Check status

Check whether an origin is registered and its current verification status.

webmcpreg check https://example.com

CI Integration

Add manifest validation to your CI pipeline to catch issues before deploying:

# GitHub Actions example
- name: Validate WebMCP manifest
  run: npx webmcpreg validate .well-known/webmcp.json

The CLI returns a non-zero exit code on validation failure, so your CI pipeline will fail if the manifest is invalid.