verifyfirst-mcp

An MCP server for what your verification method cannot see.

A failure that crashes is cheap. A failure that reports success is expensive: the screenshot looks fine, the command exits zero, the endpoint returns 200, and the bug ships.

This server exposes verifyfirst.dev — a registry of 30 such failures, organised by the instrument that missed them rather than by the technology involved, because the instrument is what you know before you know the bug.

Install

uvx verifyfirst-mcp          # run it directly
pip install verifyfirst-mcp  # or install it

Register with Claude Code:

claude mcp add verifyfirst -- uvx verifyfirst-mcp

Or any MCP client:

{
  "mcpServers": {
    "verifyfirst": { "command": "uvx", "args": ["verifyfirst-mcp"] }
  }
}

Tools

Example

> blind_spots("screenshot")

screenshot (A rendered image) is blind to:
  - Time. A still frame cannot distinguish 'renders one frame then stops'
    from 'renders one frame correctly'.
  - Whether scripts ran at all, as opposed to running and producing this.
  ...

Notes

Zero dependencies — Python standard library only. Works offline from a bundled copy of the registry; pass --remote to read the live one, which falls back to the bundle on any failure.

Every entry in the registry is a failure that genuinely occurs, marked observed (diagnosed first-hand) or documented (primary source cited and the check reproduced). None are hypothetical.

CC0-1.0 — public domain. Maintained by Zion Labs.