MIQA MCP

An MCP server that exposes MIQA test-reporting data to Claude Code and any other MCP client over stdio.

Tools

Read-only:

Tool	Description
`find_runs_by_version(version_name, limit=100)`	Find Test Chain Runs for a version name, newest-first.
`get_test_run(run_id, sample_ds_id=None)`	Details for a single run.
`get_test_run_results(run_id, sample_ds_id=None)`	Assertion/result summary table.
`get_test_run_report(run_id, sample_ds_id=None, format="json")`	Sample-centric structured report.
`get_test_run_sample_metadata(run_id, sample_ds_id=None)`	Sample metadata for a run.
`get_test_run_environment(run_id, sample_ds_id=None)`	Captured test/execution environment.
`list_component_versions(component_id, limit=100)`	A component's versions, newest-first.

Write (the only tool that can change MIQA state):

Tool	Description
`create_component_version(trigger_id, component_id=None, docker_uri=None, command=None, version_name=None, apply=False)`	Create a new component version (docker uri bump and/or main-step command change).

create_component_version is dry-run by default. With apply=False nothing is persisted — it returns a validation verdict and a diff of the would-be version. Show that diff to the user and get explicit confirmation before re-invoking with apply=True. Applying persists the version; it never starts a test run.

Some tools depend on server-side feature flags or routes and may be unavailable on older MIQA deployments.

Configuration

Variable	Description
`MIQA_SERVER_URL`	MIQA server hostname, e.g. `yourco.miqa.io`
`MIQA_API_KEY`	MIQA API key

Setup

No install needed — uv runs the server on demand. Register it with Claude Code:

claude mcp add miqa-mcp \
  --scope user \
  -e MIQA_SERVER_URL=yourco.miqa.io \
  -e MIQA_API_KEY=your-key-here \
  -- uvx --refresh --prerelease=allow miqa-mcp@0.2.2

--prerelease=allow is required while the miqatools dependency is on a prerelease. Drop @0.2.2 to always run the latest published version, or --scope user to register for the current project only.

Verify with claude mcp list (or claude mcp get miqa-mcp), and remove with claude mcp remove miqa-mcp.

Release files for miqa-mcp 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for miqa-mcp 0.2.2
File	Size	Uploaded
miqa_mcp-0.2.2.tar.gz	7.4 kB	Jul 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for miqa-mcp 0.2.2
File	Interpreter	ABI	Platform	Reset
miqa_mcp-0.2.2-py3-none-any.whl 5.5 kB Jul 28, 2026	Python 3	none	any	Details

Total release size: 12.9 kB

Release files / miqa_mcp-0.2.2.tar.gz

Download URL	miqa_mcp-0.2.2.tar.gz
Size	7.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`cc58f9cd259400e20c60acad33591ae113045edd0263b729d30a7b90657b3b03`
BLAKE2b-256 checksum How to use checksums	`501da65b6968b6785cac52c3adaba76d2ce39a47060cc3927f96196f8d7d61f2`
Upload date	Jul 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.15`

Release files / miqa_mcp-0.2.2-py3-none-any.whl

Download URL	miqa_mcp-0.2.2-py3-none-any.whl
Size	5.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6e51d7b2351f18f516b3b805477f252b09451e89a7627f993621556b98fc9bbd`
BLAKE2b-256 checksum How to use checksums	`ed19fdd86577c665fdc1084665a6b650f7e0d1caa79565e7da7c4247e2281e1e`
Upload date	Jul 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.15`