x402receipts
Records agent x402 purchases as receipts reconciled against on-chain payments
- Pricing
- Paid
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 1.0.0
- Listing updated
- 1 day ago
About x402receipts
x402receipts is a paid MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a 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-mcpAdd to claude_desktop_config.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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Configuration
X402RECEIPTS_EVM_PRIVATE_KEYOptional. 0x… key holding USDC on Base; pays USD 1 per wallet per calendar month; later uploads that month are free.X402RECEIPTS_SOLANA_PRIVATE_KEYOptional. ed25519 key (hex or base58) holding USDC on Solana.
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- record_receipts
- Record x402 purchases as receipts.
- verify_receipt
- Verify a receipt on the ledger.
- service_info
- Return information about the service.
What it does
- 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
Pricing
Paid
README lists USD 0.01 per agent wallet per active day, paid in USDC over x402
Prices change. Check x402receipts.com before you buy.
x402receipts 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 to x402receipts

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government