mcpcert-cli
v0.1.6
Published
Official mcpcert.org CLI: provision a hosted dev MCP client identity (CIMD) and run an end-to-end OAuth 2.0 + PKCE conformance check, no account required.
Maintainers
Readme
mcpcert (Node)
mcpcert.org is a free registry and conformance service for MCP (Model
Context Protocol) clients: it hosts your client's metadata document (CIMD) at a stable URL (your
permanent client_id) and runs a conformance sandbox for an end-to-end OAuth 2.0 + PKCE conformance
check. Development identities are free and need no account; within 60 days, claim one into an
account and promote it to production.
This is the TypeScript/Node build of the official mcpcert CLI (a Python build is also published
to PyPI). It installs an executable named mcpcert and is a thin HTTP client over the public
mcpcert.org API.
Install
npx mcpcert-cli init # run without installing, or:
npm install -g mcpcert-cliThe npm package is mcpcert-cli; it installs a command named mcpcert. Requires Node.js >= 22.
Quick start
mcpcert init --accept-tos # provision a hosted dev identity (no account)
mcpcert info # show it (offline)
mcpcert conformance run # end-to-end OAuth 2.0 + PKCE conformance check
mcpcert update --redirect-uri http://127.0.0.1:8080/callbackCommands
| Command | Purpose |
| --- | --- |
| mcpcert init | Provision an anonymous development identity (CIMD). |
| mcpcert update | Patch mutable dev metadata before expiry (never renews). |
| mcpcert info [--check] | Print the local identity; --check reconciles with live server state. |
| mcpcert conformance run | Drive the OAuth/conformance flow end to end. |
| mcpcert conformance list | List conformance runs. |
| mcpcert conformance show <runId> | Show one conformance run. |
Run mcpcert <command> --help for flags. Add --json to any command for machine-readable output.
Conversion to a permanent production CIMD is a two-step web dashboard flow
(https://mcpcert.org/dashboard/promote): first claim the dev identity with the auth token saved
in .mcpcert/credentials.json, then promote the claimed dev identity from your dashboard. It
requires an account and is not a CLI command.
There is no promote or refresh command. Full docs: https://mcpcert.org.
License
Apache-2.0. See LICENSE and NOTICE in this package.
