mcpcert-cli 0.1.0

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.

mcpcert (Python)

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; promote one to production within 60 days.

This is the Python build of the official mcpcert CLI (a TypeScript/Node build is also published to npm). It installs an executable named mcpcert and is a thin HTTP client over the public mcpcert.org API.

Install

uv tool install mcpcert-cli      # or:
pipx install mcpcert-cli

The PyPI package is mcpcert-cli; it installs a command named mcpcert. Requires Python >= 3.10.

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/callback

Commands

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.

Promotion to a permanent production CIMD is done in the web dashboard (https://mcpcert.org/dashboard/promote) — 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.