Skip to content
MCP server

Verfy

A lockfile for MCP tools: blocks changed tool definitions and signs a receipt per call

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.23.1
Listing updated
3 days ago

About Verfy

Verfy is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

Verfy pins the SHA-256 of each MCP tool's exact definition in a verfy.lock you commit. If a server later alters a tool, the tool is hidden, calls are denied and CI fails the pull request with a readable diff. The site cites its own check of 46 popular servers, in which about one in three patch releases changed a tool definition, with nothing malicious found.

A guard checks each call against fixed allow, ask or deny rules for shell, files, URLs, SQL and payments, with no LLM verdicts. Every checked call gets an Ed25519-signed, hash-chained receipt that verfy verify can check offline. A scanner flags tool poisoning and leaked keys, and verfy run --sandbox uses Anthropic's sandbox runtime.

The registry entry is the PyPI package at 0.23.1. Hooks target Claude Code, Codex and Gemini CLI, with Cursor and others in beta.

Install

Run in a terminal

claude mcp add verfy -- uvx verfy

Add to claude_desktop_config.json

{
  "mcpServers": {
    "verfy": {
      "command": "uvx",
      "args": [
        "verfy"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "verfy": {
      "command": "uvx",
      "args": [
        "verfy"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "verfy": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "verfy"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "verfy": {
      "command": "uvx",
      "args": [
        "verfy"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "verfy": {
      "command": "uvx",
      "args": [
        "verfy"
      ]
    }
  }
}

What it does

Tool lockfile
Pins each tool definition by hash.
CI check
Fails a pull request when a tool changed.
Signed receipts
Chained, offline-verifiable records of each call.
Rule-based guard
Deterministic allow, ask or deny decisions.
Config scan
Flags poisoning, hidden instructions and plain-http servers.

Good for

  • Detect a silent MCP tool update
  • Block a risky shell command from an agent
  • Produce audit evidence of agent actions
  • Review an MCP config before approval

Pricing

Open source

MIT CLI; Verfy Cloud free in beta, paid plans not yet on sale

Prices change. Check verfy.dev before you buy.

Verfy FAQ

Does an LLM decide what is blocked?

No. Fixed rules decide.

Is it free?

The CLI is MIT; Verfy Cloud is free during beta and paid plans are not on sale.

Which agents does it support?

Claude Code, Codex and Gemini CLI, with three more in beta.

Can it run in CI?

Yes, verfy lock check or the GitHub Action.

Is Verfy free?

Yes. Verfy is open source, so you can use and self-host it for free.

How do I add Verfy to Claude Code?

Run this command in your terminal: claude mcp add verfy -- uvx verfy

What are the best alternatives to Verfy?

The closest alternatives to Verfy are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Verfy

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools