# Assurance

Reads a session transcript and reports what the agent skipped or could not verify. Useful when a run ends with a cheerful “all done”.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: i-ops-hq
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/i-ops-hq/assurance
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/assurance

## What it does

Assurance takes the transcript of a Claude session and works through it: which commands ran, which ones failed, what changed after the last test run. The report comes back in plain sentences. When a command is not recognised, the server says so and names it instead of counting silence as a pass.

A Stop hook runs the audit after every turn and speaks up only when there is something to report. There are three levels: “note”, “suggested review” and “stop and check”. The last one fires when untested code has been pushed, merged, deployed, migrated or committed to main. The hook never blocks a session.

Everything runs through `uvx`, so you need uv installed or the package from `pip install assurance`. Installing the hook edits `~/.claude/settings.json`; the installer shows the change and asks first. Test commands are picked up from `package.json`, `Makefile` and `justfile`, and a run of zero tests is not treated as a pass.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add assurance-mcp -- uvx assurance-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from assurance-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add assurance -- uvx assurance-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from assurance-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "assurance": {
            "command": "uvx",
            "args": [
                "assurance-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from assurance-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "assurance": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "assurance-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from assurance-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add assurance uvx assurance-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from assurance-mcp <command>

## When to use it
- spot that the same test failed three times while the agent reported success
- catch an edit that no relevant test followed
- review a session where some commands stayed unclassified
- check that untested code never reached a push or deploy
- get a session report without reading the transcript by hand

## Example prompts
- Audit my last Claude session and tell me what was left unverified
- Check the transcript for whether `pytest -q tests/test_invoice.py` ran after the last edit
- Install the assurance Stop hook so the audit runs after every turn

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md