# x402receipts

> x402receipts is a paid MCP server for finance and payments. Records agent x402 purchases as receipts reconciled against on-chain payments. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://x402receipts.com
- **Repository:** https://github.com/x402receipts/x402receipts
- **MCP Registry name:** com.x402receipts/mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-16

## About

Agents that pay for data and model calls over x402 make thousands of tiny purchases that reach finance as a single wallet transfer. x402receipts turns each purchase into a receipt, matches it against the payment that settled on Base or Solana, and flags payments that have no receipt or deliveries that failed.

Each night the account's receipt log is hashed into a Merkle tree whose root is written to the Hedera Consensus Service, and every receipt gets a public verification page. Finance signs in with a wallet to see monthly totals by supplier, a register, CSV and signed JSON exports, and period statements. The receipt format is published as the ARR-1 open specification under CC0.

The MCP server runs locally over stdio through npm and exposes record_receipts, verify_receipt and service_info. The README says it is MIT licensed and lists a price of USD 0.01 per agent wallet for each day it records purchases, paid in USDC by the agent's own wallet.

## Features

- **Receipt capture:** Records supplier, amount, network, transaction reference and delivery status.
- **On-chain matching:** Reads wallets on Base and Solana and matches outgoing payments to receipts.
- **Exception flags:** Unmatched payments and failed deliveries are listed first.
- **Public ledger anchor:** Nightly Merkle roots are written to Hedera for verification.
- **Finance exports:** Monthly statements, CSV and signed JSON exports with receipt hashes.
- **Open receipt format:** ARR-1 is published under CC0 with JSON Schemas.

## Good for

- Reconcile agent spending at month end
- Prove an agent purchase happened and was delivered
- Give finance a statement of autonomous spend by supplier
- Find agents paying without recording receipts

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env X402RECEIPTS_EVM_PRIVATE_KEY='<X402RECEIPTS_EVM_PRIVATE_KEY>' --env X402RECEIPTS_SOLANA_PRIVATE_KEY='<X402RECEIPTS_SOLANA_PRIVATE_KEY>' -- npx -y x402receipts-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402receipts-mcp"
      ],
      "env": {
        "X402RECEIPTS_EVM_PRIVATE_KEY": "<X402RECEIPTS_EVM_PRIVATE_KEY>",
        "X402RECEIPTS_SOLANA_PRIVATE_KEY": "<X402RECEIPTS_SOLANA_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402receipts-mcp"
      ],
      "env": {
        "X402RECEIPTS_EVM_PRIVATE_KEY": "<X402RECEIPTS_EVM_PRIVATE_KEY>",
        "X402RECEIPTS_SOLANA_PRIVATE_KEY": "<X402RECEIPTS_SOLANA_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "x402receipts-mcp"
      ],
      "env": {
        "X402RECEIPTS_EVM_PRIVATE_KEY": "<X402RECEIPTS_EVM_PRIVATE_KEY>",
        "X402RECEIPTS_SOLANA_PRIVATE_KEY": "<X402RECEIPTS_SOLANA_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402receipts-mcp"
      ],
      "env": {
        "X402RECEIPTS_EVM_PRIVATE_KEY": "<X402RECEIPTS_EVM_PRIVATE_KEY>",
        "X402RECEIPTS_SOLANA_PRIVATE_KEY": "<X402RECEIPTS_SOLANA_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402receipts-mcp"
      ],
      "env": {
        "X402RECEIPTS_EVM_PRIVATE_KEY": "<X402RECEIPTS_EVM_PRIVATE_KEY>",
        "X402RECEIPTS_SOLANA_PRIVATE_KEY": "<X402RECEIPTS_SOLANA_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `record_receipts`: Record x402 purchases as receipts.
- `verify_receipt`: Verify a receipt on the ledger.
- `service_info`: Return information about the service.

## FAQ

### How does it get paid?

The README says the agent's own wallet pays over x402 in USDC, with no API key.

### What does the README list as the price?

USD 0.01 per agent wallet for each day it records purchases, with unlimited receipts.

### How do I run the MCP server?

With npx -y x402receipts-mcp; the registry entry lists it as an npm package over stdio.

### Which chains does it read?

Base and Solana.

### Is x402receipts free?

No. x402receipts is a paid product.

### How do I add x402receipts to Claude Code?

Run this command in your terminal: claude mcp add mcp --env X402RECEIPTS_EVM_PRIVATE_KEY='<X402RECEIPTS_EVM_PRIVATE_KEY>' --env X402RECEIPTS_SOLANA_PRIVATE_KEY='<X402RECEIPTS_SOLANA_PRIVATE_KEY>' -- npx -y x402receipts-mcp

### What are the best alternatives to x402receipts?

The closest alternatives to x402receipts are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [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.
- [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.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/x402receipts
