CLI tool to test and validate WebMCP readiness of any website. Scans for tool definitions, runs validation and security checks, and assigns a readiness grade.
npm install -g @webmcpregistry/cli
# or run directly with npx
npx @webmcpregistry/cli --helpQuick scan that fetches the HTML and checks for WebMCP signals without launching a browser.
npx @webmcpregistry/cli scan https://yoursite.com
npx @webmcpregistry/cli scan https://yoursite.com -o jsonWhat it checks:
- Declarative
toolnameattributes in the HTML registerTool()calls in inline scripts/.well-known/webmcp.jsonmanifest presence- Tool definition validation (naming, descriptions, schemas, safety)
- Security scan (prompt injection, deceptive naming, unrestricted inputs)
Comprehensive 5-step test with validation, security scanning, and grade assignment.
npx @webmcpregistry/cli test https://yoursite.com
npx @webmcpregistry/cli test https://yoursite.com -o json
npx @webmcpregistry/cli test https://yoursite.com --no-security
npx @webmcpregistry/cli test https://yoursite.com --no-colorSteps:
- Fetch the page
- Detect WebMCP tools (declarative attributes,
registerToolcalls, forms) - Check
/.well-known/webmcp.jsonmanifest - Validate tool definitions
- Run security checks
Output includes a letter grade (A-F) based on tool count, description quality, schema completeness, naming conventions, manifest presence, and security score.
| Option | Description |
|---|---|
-o, --output <format> |
Output format: terminal (default), json, badge |
--no-security |
Skip security checks |
--no-color |
Disable color output |
Generate framework-specific boilerplate to add WebMCP to your project.
npx @webmcpregistry/cli init
npx @webmcpregistry/cli init --framework react
npx @webmcpregistry/cli init --framework nextjs
npx @webmcpregistry/cli init --framework vue
npx @webmcpregistry/cli init --framework angular
npx @webmcpregistry/cli init --framework svelte
npx @webmcpregistry/cli init --framework html| Framework | Package |
|---|---|
html (default) |
<script> tag with @webmcpregistry/browser |
react |
@webmcpregistry/react |
nextjs |
@webmcpregistry/nextjs |
vue |
@webmcpregistry/vue |
angular |
@webmcpregistry/angular |
svelte |
@webmcpregistry/svelte |
# Quick scan of an e-commerce site
$ npx @webmcpregistry/cli scan https://shop.example.com
WebMCP Quick Scan: https://shop.example.com
Tools found: 3
Validation: 92/100 (PASS)
Security: 100/100 (PASS)
Grade: A
# Get JSON output for CI pipelines
$ npx @webmcpregistry/cli test https://mysite.com -o json
# Scaffold React setup
$ npx @webmcpregistry/cli init --framework reactApache 2.0 -- RAPHATECH OU
Part of the WebMCP Registry SDK monorepo.