# Agent Receipt Verify

> Agent Receipt Verify is an open-source MCP server for finance and payments. Check x402 endpoints before an agent pays and link a receipt to its on-chain settlement. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/holistis/agent-receipt-verify
- **MCP Registry name:** io.github.holistis/agent-receipt-verify
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.

---
Source: https://ai-powered.com/mcp/agent-receipt-verify
