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

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.3
File	Size	Uploaded
miqa_mcp-0.2.3.tar.gz	7.4 kB	Jul 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for miqa-mcp 0.2.3
File	Interpreter	ABI	Platform	Reset
miqa_mcp-0.2.3-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.3.tar.gz

Download URL	miqa_mcp-0.2.3.tar.gz
Size	7.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`c92b265dd2b4c18b6710748d4d42229bf4cc902f5cc76d21f2dfff5f4ca18a76`
BLAKE2b-256 checksum How to use checksums	`c06a9f38cab3b72e4f45e3e0a941ca45ea72c179b5d3c71789224e29bf6c63e4`
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.3-py3-none-any.whl

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