Metadata-Version: 2.4
Name: mcpcert-cli
Version: 0.1.0
Summary: 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.
Project-URL: Homepage, https://mcpcert.org
Project-URL: Issues, https://mcpcert.org/contact
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: cimd,cli,mcp,mcpcert,model-context-protocol,oauth,oauth2,pkce
Requires-Python: >=3.10
Requires-Dist: tomli>=2.0.1; python_version < '3.11'
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# mcpcert (Python)

[mcpcert.org](https://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

```bash
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

```bash
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.
