Skip to main content
Glama

ProofPay

ProofPay is a custody-minimized paid-delivery primitive for ZeroClaw. An agent can create a Solana Pay invoice, verify an exact finalized SPL-token payment, and release an AES-256-GCM sealed artifact.

The model never receives encryption keys and cannot choose the recipient, mint, RPC, file roots, token decimals, or amount ceiling. Those remain operator-owned TOML policy.

MCP surface

  • proofpay__create_invoice(artifact_name, amount, buyer_label?)

  • proofpay__invoice_status(invoice_id)

  • proofpay__release_artifact(invoice_id) — writes the verified plaintext locally and returns paid UTF-8 content inline when it is within the operator cap.

Related MCP server: x402-mcp

Payment rule

A payment is accepted only when a finalized transaction includes the per-invoice reference and an exact configured-mint balance delta for the configured recipient. A reference touch, wrong mint, wrong recipient, underpayment, overpayment, failed transaction, or non-finalized transaction fails closed.

Quick start

python3.12 -m venv .venv
.venv/bin/pip install -e '.[dev]'
cp examples/proofpay.toml proofpay.local.toml
# Replace paths and recipient in proofpay.local.toml.
.venv/bin/proofpay-mcp --config proofpay.local.toml

Run the test suite:

.venv/bin/python -m pytest tests -q

The stdio integration test launches the actual MCP subprocess, initializes a client session, lists the three tools, and creates an invoice. The production-shaped ZeroClaw receipt is in docs/zeroclaw-v0.8.4-receipt.json; the labeled synthetic paid-release receipt is in docs/demo-receipt.json; the optional real-chain harness is documented in docs/DEVNET_SMOKE.md.

ZeroClaw

Install ZeroClaw, then merge examples/zeroclaw-config-snippet.toml into its config and grant the revenue MCP bundle only to the intended agent. Copy skills/proofpay/SKILL.md into that agent's skill bundle.

zeroclaw --version
zeroclaw --config-dir /path/to/config status

ProofPay has been exercised against ZeroClaw v0.8.4's current MCP schema. Absolute paths are intentional: the spawned stdio process must not depend on shell activation.

Architecture

buyer/channel -> ZeroClaw agent -> narrow MCP tools -> ProofPay policy
                                                    |-> Solana JSON-RPC
                                                    |-> SQLite invoice state
                                                    `-> AES-GCM sealed artifact

Security and scope

Read docs/THREAT_MODEL.md before deployment. This prototype handles invoice creation, exact payment verification, and local release. It does not provide buyer authentication, refunds, disputes, tax handling, sanctions screening, or encrypted buyer delivery.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to manage USDC wallets on Solana, allowing them to send payments, create invoices, and access paid APIs within human-defined spending limits. It uses threshold signatures to provide agents with financial autonomy while ensuring secure oversight and transaction approval.
      36
      70 npm
      4
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Agentic payments on Solana: an agent can pay x402 / HTTP 402 paywalls in USDC, hold a pre-paid balance or a subscription, and buy datasets or settle store checkouts. All 15 tools run behind fail-closed spending caps ($1 per payment, $10 per day by default), and settlement is non-custodial through a program-owned escrow that releases 99% to the creator.
      18
      94 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      On-chain delivery receipts for x402 AI-agent payments on Solana: anchors SHA-256 digests of delivered content to a PDA after settlement; buyers verify proof of delivery offline with zero trust in the seller. Live MCP endpoint + npm bridge.
      3
      MIT