English Français العربية

x402receipts

Registre officiel Sécurité

Record x402 agent purchases as reconciled, auditable receipts; verify any receipt on the ledger.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package x402receipts-mcp
Claude Code 
claude mcp add x402receipts -e 'X402RECEIPTS_EVM_PRIVATE_KEY=<your x402receipts_evm_private_key>' -e 'X402RECEIPTS_SOLANA_PRIVATE_KEY=<your x402receipts_solana_private_key>' -- npx -y x402receipts-mcp@1.0.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "x402receipts": {
            "command": "npx",
            "args": [
                "-y",
                "x402receipts-mcp@1.0.0"
            ],
            "env": {
                "X402RECEIPTS_EVM_PRIVATE_KEY": "<your x402receipts_evm_private_key>",
                "X402RECEIPTS_SOLANA_PRIVATE_KEY": "<your x402receipts_solana_private_key>"
            }
        }
    }
}

Variables d'environnement

  • X402RECEIPTS_EVM_PRIVATE_KEY secret Optional. 0x… key holding USDC on Base; pays USD 1 per wallet per calendar month; later uploads that month are free.
  • X402RECEIPTS_SOLANA_PRIVATE_KEY secret Optional. ed25519 key (hex or base58) holding USDC on Solana.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. x402receipts
  2. Use it
  3. The format is an open standard
  4. In this repo
  5. How it works

x402receipts

Accounting infrastructure for autonomous spending. Every x402 purchase an agent makes becomes a receipt, reconciled against the on-chain transaction, with missing or unmatched payments flagged, monthly statements for finance, and evidence anyone can verify.

Use it

In code — one wrapper around the fetch your agent already pays with (npm i x402receipts-sdk):

import { wrapFetchWithPayment } from "@x402/fetch";
import { withRegister } from "x402receipts-sdk";

const register = withRegister(fetch, { endpoint: "https://app.x402receipts.com", payWith: () => pay });
const pay = wrapFetchWithPayment(register, wallet);

As an MCP server (npx -y x402receipts-mcp): record_receipts, verify_receipt, service_info. See packages/mcp.

Over HTTP: POST https://app.x402receipts.com/api/v1/receipts — answers 402 with the x402 challenge; any x402 client pays it.

With an AI coding tool: paste the integration prompt into Claude Code or Cursor.

The format is an open standard

The record, its fingerprint, the append-only log above it, the anchor record and the verification algorithm are published as ARR-1 — Agent Receipt Record, released into the public domain (CC0). JSON Schemas are in spec/arr-1/. Implement it yourself, or check our implementation against it.

ARR-1 builds on existing standards rather than replacing them: the tree is the RFC 9162 profile used by Certificate Transparency, checkpoints are published as HCS-27 messages, accounts are named with CAIP-2/CAIP-10, and agents with HCS-14 identifiers.

In this repo

PathWhat
spec/arr-1/the ARR-1 specification and its JSON Schemas (CC0)
sdk/the x402receipts-sdk npm package (single file, no dependencies)
packages/mcp/the x402receipts-mcp MCP server
examples/plain Node, Vercel AI SDK, LangChain, OpenAI Agents
integrations/agentkit/Coinbase AgentKit action provider
integrations/x402-ecosystem/x402.org ecosystem entry

How it works

  1. Capture — the SDK records each paid call: resource, amount, counterparty, transaction reference, request/response fingerprints, delivery status, and the seller's signed receipt when it issues one (x402 offer-receipt).
  2. Reconcile — the connected wallets are read on Base and Solana; every outgoing USDC payment is matched to a receipt. What doesn't match is an exception, not an average.
  3. Prove — each night, the account's whole receipt log is hashed into one RFC 9162 Merkle tree and its root is written to the Hedera Consensus Service, linked to the previous day's root. Every receipt has a public verification page that redoes the maths in the browser.
  4. Report — the owner signs in with the wallet: spend by supplier, the register, CSV and signed JSON export.

Guide: https://x402receipts.com/guide.html · Status: https://app.x402receipts.com/status · Contact: hello@x402receipts.com

MIT licensed.

Questions fréquentes

Qu'est-ce que x402receipts ?

Record x402 agent purchases as reconciled, auditable receipts; verify any receipt on the ledger.

Comment installer x402receipts ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add x402receipts -e 'X402RECEIPTS_EVM_PRIVATE_KEY=<your x402receipts_evm_private_key>' -e 'X402RECEIPTS_SOLANA_PRIVATE_KEY=<your x402receipts_solana_private_key>' -- npx -y x402receipts-mcp@1.0.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour x402receipts ?

Oui. Il attend X402RECEIPTS_EVM_PRIVATE_KEY, X402RECEIPTS_SOLANA_PRIVATE_KEY, à renseigner dans sa configuration.

x402receipts est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient x402receipts ?

Il est publié par x402receipts. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.