ProofPay MCP Server
Enables creating Solana Pay invoices, verifying finalized SPL-token payments on Solana, and releasing sealed artifacts after exact payment confirmation.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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.tomlRun the test suite:
.venv/bin/python -m pytest tests -qThe 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 statusProofPay 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 artifactSecurity 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
Agent-native storage with cryptographic verification on Solana. Keyless: clients sign and pay.
Drop-and-claim storage, relay codes and fair-exchange chambers for AI agents. Pay per use in USDC.
Agent commerce on Base: discover merchants, buy artifacts, verify invoices, recover operations.
Non-custodial x402 payments between AI agents on Solana. Returns unsigned transactions.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables 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.3670 npm4Apache 2.0
- AlicenseAqualityCmaintenanceEnables AI agents to discover, inspect, and pay for paid HTTP and MCP services using USDC on Solana with a self-custodial wallet.49Apache 2.0
- AlicenseAqualityCmaintenanceAgentic 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.1894 npmMIT
- AlicenseAqualityBmaintenanceOn-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.3MIT