verdict-qa-mcp

A read-only MCP server and release gate over Verdict's QA state — so anything that speaks MCP can consult your QA memory.

Verdict is a Claude Code QA agent that keeps a baseline and reports what broke since yesterday: findings with stable IDs and ages, every red test classified, flaky tests quarantined with an expiry, and a verdict of pass | pass with risks | blocked | fail that names what was not tested.

This distribution is the part of Verdict that other tools talk to. It reads the same state files the agent writes and never writes to them — an orchestrator gating a merge, a Cursor or Codex session, or a CI step commenting on a PR can all ask what the tester last found. The agent itself is a Claude Code plugin with zero dependencies and works without this package.

Note on the name. The distribution is verdict-qa-mcp; the console script is still verdict-mcp, and the import package is still verdict_mcp. verdict-mcp was taken on PyPI by an unrelated project.

Install

claude mcp add verdict -- uvx --from verdict-qa-mcp verdict-mcp

Or pip install verdict-qa-mcp / uv pip install verdict-qa-mcp.

MCP tools

Every tool carries a read-only annotation, and the server never writes — the tester's memory is public API; the tester's pen is not.

Tool	Returns
`get_verdict(project)`	last verdict, release blockers, report path, not-tested list
`get_findings(project, status)`	`open` (default), `all`, or `NEW / STILL_OPEN / RESOLVED / REGRESSED` — REGRESSED ranked first
`get_quarantine(project)`	the flaky ledger, each entry with a computed `expired` flag
`get_history(project)`	run-over-run trend parsed from the report index
`get_report(project, report?)`	full report content, path-guarded to the QA root — so CI can quote the evidence, not just link it
`get_profile(project)`	isolation rules, risk areas, real test commands, and the lessons ledger when one exists
`get_trends(project)`	trajectory, current pressure (open by severity, age, quarantine size), and hotspots — where this project's defects actually cluster
`list_projects()` / `get_state(project)`	everything with a baseline / the raw state

project is a key under the solo root (~/.claude/verdict/, override with VERDICT_HOME) or a repo path in team mode, which resolves <repo>/.qa/.

Command-line entry points

Command	Does
`verdict-mcp`	the MCP server above
`verdict-gate`	exit-code release gate for CI — keeps "never ran" distinct from "said no"
`verdict-validate`	checks a state file is well-formed (`--at-rest` for a committed one)
`verdict-run`	runs a pass through the harness
`verdict-accept`	the maintainer's pen: record that a finding's risk is accepted, with a citation and a reason — the one status the tester cannot write
`verdict-facts` / `verdict-finalize`	measure-then-judge harness halves

Documentation

Full documentation, the plugin itself, and the published eval results live on GitHub:

Repository and plugin install
Published eval results — including the runs that scored badly
State schema
Changelog

MIT licensed.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

verdict_qa_mcp-0.78.0.tar.gz (175.6 kB view details)

Uploaded Sep 5, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

verdict_qa_mcp-0.78.0-py3-none-any.whl (106.4 kB view details)

Uploaded Sep 5, 2026 Python 3

File details

Details for the file verdict_qa_mcp-0.78.0.tar.gz.

File metadata

Download URL: verdict_qa_mcp-0.78.0.tar.gz
Upload date: Sep 5, 2026
Size: 175.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for verdict_qa_mcp-0.78.0.tar.gz
Algorithm	Hash digest
SHA256	`a70ef2f0eb371bd0f758c34911a1cc25cb86c5350d029b9a9ad30dba666402df`
MD5	`cc6970fca1d33b7f4634b2ab8c2fa065`
BLAKE2b-256	`b44b3806e33eb5b2b94c0877d63edf41f4b11e312753f29e9d8fda87ceec435e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for verdict_qa_mcp-0.78.0.tar.gz:

Publisher: release.yml on ArtJack/verdict

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: verdict_qa_mcp-0.78.0.tar.gz
- Subject digest: a70ef2f0eb371bd0f758c34911a1cc25cb86c5350d029b9a9ad30dba666402df
- Sigstore transparency entry: 2721864208
- Sigstore integration time: Sep 5, 2026
Source repository:
- Permalink: ArtJack/verdict@b7fef37422bd6a2f1ee320e0b661f83026732d8e
- Branch / Tag: refs/tags/v0.78.0
- Owner: https://github.com/ArtJack
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@b7fef37422bd6a2f1ee320e0b661f83026732d8e
- Trigger Event: push