Verify Claim MCP server

mcp-verify-claim

A Model Context Protocol (MCP) server that forces evidence-gated, honestly tiered claim reporting. Every claim an agent makes gets classified into an evidence tier (FACT / INFERENCE / SPECULATION / UNVERIFIED) with attached evidence — the antidote to the silent-unverified-claim failure mode ("pushed successfully", "the tests pass", "the API returned 200" — asserted without ever running the command).

Deterministic, no LLM, no network calls. Self-hostable, MCP-compatible with any agent (Claude Code, Cursor, Copilot, OpenClaw, Codex CLI).

Why it exists

The most common agent failure is not wrong reasoning — it's reporting a plausible-sounding result that was never verified. mcp-verify-claim installs a hard gate: no unverified claim can be reported as fact.

The pattern it fits (agent tooling that answers with evidence, not opinion)

When you give an agent access to real operations (edits, checks, rule evaluation, mutations) through MCP, the value is that it can answer with evidence instead of opinion — it ran the check, it saw the real state, it can prove what it did. But that only holds if the agent is forced to attach the evidence. A rules-and-checks surface ("is the module valid?", "did this state change slice apply?", "what actually changed?") is exactly the high-value case: each check produces a machine-verifiable result.

mcp-verify-claim is the gate that guarantees the agent reports the result with its evidence attached (exit code, real read-back, actual HTTP status) and cannot pass off a guess or an unrun step as truth. Pair it with any MCP surface that exposes operations, and the agent's answers become auditable, line-by-line, instead of plausible.

Tools

tier + verdict (TRUST / REVIEW / DO-NOT-REPORT) + honest next-action.

• tierclaim(claim, evidence, verificationkind) — classify a claim into a

(completion-without-artifact, "the API returned", hedge words).

• check_claim(claim) — deterministic scan for fabrication/hedging signals

shape and the 6-step behavioral loop.

• report_templates() — the canonical STATUS / EVIDENCE / GAPS completion

definitions.

• tier_definitions() — the FACT / INFERENCE / SPECULATION / UNVERIFIED

Evidence tier (the core)

Install & run

One command (recommended) — installs from the repo, no PyPI token needed:

uv tool install git+https://github.com/sudo-ai-git/mcp-verify-claim
mcp-verify-claim                         # run stdio server
mcp-verify-claim --http --port 8137      # or Streamable HTTP for remote use

Or with pipx: pipx install git+https://github.com/sudo-ai-git/mcp-verify-claim

Direct from source (fallback):

pip install mcp
python3 mcp_server.py

Claude Desktop / agent config

{ "mcpServers": {
    "verify-claim": { "command": "mcp-verify-claim", "args": [] }
}}

Example

tier_claim("Successfully deployed", evidence="", verification_kind="")
--> tier UNVERIFIED, verdict DO-NOT-REPORT
    signals: [high] completion claim without artifact
    next: go get the evidence before reporting

tier_claim("Deploy is live", evidence="origin/main SHA==local HEAD, HTTP 200", verification_kind="read_back")
--> tier FACT, verdict TRUST

Part of a family

This is one of three deterministic, no-LLM agent-trust MCP servers by sudo-ai-git:

Shortened. The full README is on GitHub.