Skip to content
MCP server

Agent Receipt Verify

Check x402 endpoints before an agent pays and link a receipt to its on-chain settlement

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.2.1
Listing updated
today

Similar MCP servers

About Agent Receipt Verify

Agent Receipt Verify is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Agents that pay for services over x402 face two moments of doubt, and this server handles both. Before paying, check_x402_endpoint sends one request and reports which levels of the README's conformance ladder an endpoint reaches; levels needing a real settlement come back as not measured rather than failed. After paying, link_receipt_to_settlement takes the receipt, authorization salt and asset, resolves the salted commitment against live chain state, and answers linked, not linked or could not check as three separate outcomes.

The README is open about limits: it judges the shape of a receipt, not the honesty of its issuer. Verifiers are written from published specifications and tested against vector files from the protocols' authors, with several outside parties and the x402 spec author's independent run cited as cross-checks. It also ships offline vector suites for INAM, EIP-3009 and the x402 attempt identity section.

The server speaks MCP over stdio with no SDK and no required dependency, opens no port and writes nothing to disk. Run it with npx, a Docker image or an MCPB bundle; ethers is an optional dependency for one signature check.

Install

Run in a terminal

claude mcp add agent-receipt-verify -- npx -y https://github.com/holistis/agent-receipt-verify/releases/download/v0.2.1/agent-receipt-verify-0.2.1.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agent-receipt-verify": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/holistis/agent-receipt-verify/releases/download/v0.2.1/agent-receipt-verify-0.2.1.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-receipt-verify": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/holistis/agent-receipt-verify/releases/download/v0.2.1/agent-receipt-verify-0.2.1.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "agent-receipt-verify": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/holistis/agent-receipt-verify/releases/download/v0.2.1/agent-receipt-verify-0.2.1.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "agent-receipt-verify": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/holistis/agent-receipt-verify/releases/download/v0.2.1/agent-receipt-verify-0.2.1.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "agent-receipt-verify": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/holistis/agent-receipt-verify/releases/download/v0.2.1/agent-receipt-verify-0.2.1.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

check_x402_endpoint
Check an x402 endpoint's conformance before paying
link_receipt_to_settlement
Link a receipt to its on-chain settlement after paying

What it does

Pre-payment check
Reports how far an endpoint conforms to x402 before you pay.
Receipt to settlement link
Resolves a receipt's commitment against chain state.
Three-way answers
Linked, not linked and could not check stay distinct.
Offline vectors
Published test vectors can be rerun without a network.
Minimal footprint
No port, no disk writes, no SDK.

Good for

  • Verify an x402 endpoint before an agent spends money
  • Confirm a receipt matches a real settlement
  • Cross-check implementations against published vectors
  • Audit agent payment flows

Pricing

Open source

Agent Receipt Verify FAQ

Does it need an account or key?

No account, key or payment is needed.

Does it prove a seller is honest?

No. It checks the shape of receipts, not the issuer's honesty.

How do I run it?

With npx from GitHub, a Dockerfile, or an MCPB bundle over stdio.

What happens when it cannot verify something?

It reports not measured or could not check rather than failing it.

Is Agent Receipt Verify free?

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

How do I add Agent Receipt Verify to Claude Code?

Run this command in your terminal: claude mcp add agent-receipt-verify -- npx -y https://github.com/holistis/agent-receipt-verify/releases/download/v0.2.1/agent-receipt-verify-0.2.1.mcpb

What are the best alternatives to Agent Receipt Verify?

The closest alternatives to Agent Receipt Verify are REA, AiSOC, Solana MCP by Vybe, redamon and x64dbg-mcp-server.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers