The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the X402 Notary MCP listing page.
A ForgeMesh Labs product — the notary of the x402 agent economy.
Prove what your AI said, when it said it, and which model said it.
Every AI output is just text. There's no proof a specific model produced a specific response at a specific time — and as agents start hiring other agents, that trust gap gets expensive. x402 Notary closes it: submit any inference, pay $0.001 in USDC (automatic, via x402 on Base or Solana — no API key, no account), and get back a signed, timestamped, chain-anchored receipt that anyone can verify, free, forever.
We notarize the hash, not your secrets. Your prompt and response are hashed and signed — never stored. Private signed receipts, publicly anchored by batch root.
WALLET_PRIVATE_KEY is a dedicated low-balance Base wallet for x402 micropayments — never your primary wallet. $1 of USDC notarizes 1,000 outputs.
SOLANA_PRIVATE_KEY is a dedicated low-balance Solana keypair for x402 micropayments. It may be a JSON byte array, base58, base64, or hex-encoded 32/64-byte key. Never use your primary wallet.
Verification needs no wallet at all. Skip the env block entirely and you can still verify receipts, inspect attestations, and read live stats.
| Tool | Cost | What it does |
|---|---|---|
notarize_inference | $0.001 | Signed receipt for one {prompt, response, model_id} |
notarize_batch | $0.005 | Up to 20 receipts in one call — built for audit trails |
verify_attestation | free | Check any receipt: signature, content hash, Merkle proof |
get_receipt | free | Fetch the public proof material for an attestation |
notary_stats | free | Live volume, top models, anchored batches |
notary_pubkey | free | The notary's Ed25519 key — verify receipts fully offline |
When you notarize an inference you get an attestation:
That's proof of three things:
Any agent (or human, or CI job) can check a receipt before acting on the output behind it:
"valid": true means the content matches the notarized hash and the notary's Ed25519 signature checks out. Tampered content is rejected with the exact failing check.
Not every call — the outputs that matter:
Casual chat and scratchpad reasoning don't need receipts. Externalized outputs do.
No signup, no API key, no subscription. The first request returns an HTTP 402 challenge; your MCP client signs a USDC payment authorization and retries. Base uses EIP-3009; Solana uses the x402 SVM exact rail. The receipt lands in the same response — including the payment transaction hash under _payment.
Prefer raw HTTP? The full agent-readable surface:
https://notary.forgemesh.io/llms.txt — one-page summary for agentshttps://notary.forgemesh.io/openapi.json — OpenAPI 3.1 with x402 payment metadatahttps://notary.forgemesh.io/.well-known/x402.json — x402 discovery manifesthttps://notary-solana.forgemesh.io/llms.txt — Solana rail summaryhttps://notary-solana.forgemesh.io/openapi.json — Solana OpenAPI 3.1 with x402 metadatahttps://notary-solana.forgemesh.io/.well-known/x402.json — Solana x402 discovery manifestIs my prompt stored anywhere? No. The hash is computed, signed, and the raw text is discarded. This is the default and only mode.
Do I need an account or API key? No. x402 payments are the only credential.
What does verification cost? Nothing, for anyone, forever. Charging to verify would defeat the point of a trust primitive.
What chain and token? USDC on Base mainnet (eip155:8453) by default. Set NOTARY_RAIL=solana and NOTARY_BASE_URL=https://notary-solana.forgemesh.io for Solana mainnet USDC.
Can I verify receipts without contacting the notary? Yes — fetch the Ed25519 public key once (notary_pubkey) and verify signatures offline.
Why "x402 Notary"? x402 is the open protocol that lets AI agents pay for services in USDC over plain HTTP — and this is its notary: the attestation layer agents use to prove and verify each other's outputs before money or reputation moves on them.
Built by ForgeMesh Labs · Powered by the x402 protocol · MIT License