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; within 60 days, claim one into an account and promote it to production.

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.11.

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

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.