assurance-mcp

Coverage and staleness checks as MCP tools — arithmetic only, read-only inside folders you grant.

Install

pip install assurance-mcp
# or: pip install assurance   # every tool

{
  "mcpServers": {
    "assurance": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["-m", "assurance_mcp.server", "--root", "/absolute/path/to/your/reports"]
    }
  }
}

--root is required for folder tools (repeat for more roots, or set ASSURANCE_MCP_ROOTS). A filesystem root (/, C:\) is refused. Restart the client after editing the config.

Quick start

Five tools. Real output from check_set_coverage (no folder needed):

complete: false · read 2 of 4
"2 of 4 documents this question spans — not in the retrieved set: amendment-2.md, amendment-3.md"
unexpected: ["globex/msa.md"]

That is what this call returns:

from assurance_mcp.checks import check_set_coverage

result = check_set_coverage(
    expected=["msa.md", "amendment-1.md", "amendment-2.md", "amendment-3.md"],
    found=["msa.md", "amendment-1.md", "globex/msa.md"],
    scope="documents this question spans",
    where="the retrieved set",
)
assert result["complete"] is False
assert result["read"] == 2
assert "amendment-2.md" in result["summary"]

What it checks

tool	answers	needs `--root`
`check_set_coverage_tool`	did any two sets cover each other?	no
`check_retrieval_coverage_tool`	did retrieval hit every document the question spans?	no
`check_coverage_tool`	which periods are in this folder?	yes
`check_staleness_tool`	do figures still match a source you name?	yes
`list_dated_files_tool`	which periods does this folder hold?	yes

In CI

The MCP server itself is not a CI gate. Use assurance check / assurance diff from assurance-cli for exit codes:

exit	means
`0`	checked clean (or not asked to fail)
`1`	gap or unverifiable
`2`	could not run

Limits

expected is never inferred. You name the denominator.
CSV/TSV only for profiling — no XLSX dependency here.
Staleness needs recorded facts, or the answer is uncheckable.
No writes, no network. A model cannot widen --root.
Folder tools refuse until --root (or ASSURANCE_MCP_ROOTS) is set.

See the root README and CHANGELOG.md.

Metadata

Release files for assurance-mcp 0.5.4

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

Source distribution (sdist)

Source distribution for assurance-mcp 0.5.4
File	Size	Uploaded
assurance_mcp-0.5.4.tar.gz	25.0 kB	Oct 2, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for assurance-mcp 0.5.4
File	Interpreter	ABI	Platform	Reset
assurance_mcp-0.5.4-py3-none-any.whl 16.5 kB Oct 2, 2026	Python 3	none	any	Details

Total release size: 41.5 kB

Release files / assurance_mcp-0.5.4.tar.gz

Download URL	assurance_mcp-0.5.4.tar.gz
Size	25.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`746f66204ac79b6745a163f221922bf5f3029c013f7e34be51d27801108b90db`
BLAKE2b-256 checksum How to use checksums	`d344c58514d439323d34a8a22e49261cd2c66a907fa9322028a625df59dd5c0e`
Upload date	Oct 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/i-ops-hq/assurance
Publishing commit: github.com/i-ops-hq/assurance/tree/3c54795cadd20f21bfd6eacae6639508c742d0bf

Workflow

Publishing configuration: github.com/i-ops-hq/assurance/blob/3c54795cadd20f21bfd6eacae6639508c742d0bf/.github/workflows/publish.yml
Publishing logs: github.com/i-ops-hq/assurance/actions/runs/36967706949/attempts/1

Artifact

Subject: assurance_mcp-0.5.4.tar.gz
SHA-256 checksum: 746f66204ac79b6745a163f221922bf5f3029c013f7e34be51d27801108b90db Verifying attestations

Release files / assurance_mcp-0.5.4-py3-none-any.whl

Download URL	assurance_mcp-0.5.4-py3-none-any.whl
Size	16.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ae8456fa0e796a51edc4eb9a76f61d651e2884b6111208c18bb2dea45356b6b5`
BLAKE2b-256 checksum How to use checksums	`e41ec07822baff0d2dfebcb08f0ba26f315a41683931ba6bdd9644cb1b51f6ba`
Upload date	Oct 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/i-ops-hq/assurance
Publishing commit: github.com/i-ops-hq/assurance/tree/3c54795cadd20f21bfd6eacae6639508c742d0bf

Workflow

Publishing configuration: github.com/i-ops-hq/assurance/blob/3c54795cadd20f21bfd6eacae6639508c742d0bf/.github/workflows/publish.yml
Publishing logs: github.com/i-ops-hq/assurance/actions/runs/36967706949/attempts/1

Artifact

Subject: assurance_mcp-0.5.4-py3-none-any.whl
SHA-256 checksum: ae8456fa0e796a51edc4eb9a76f61d651e2884b6111208c18bb2dea45356b6b5 Verifying attestations