402proof

io.github.Timwal78Published by GitHub account Timwal78v1.0.0Updated Nov 1, 2026

x402 payment firewall + Agent Credit Bureau. Invoice/verify/score via RLUSD on XRPL.

VerifiedStreamable HTTPWeb executableFinanceDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

Remote x402 payment firewall and agent credit bureau: issue and verify crypto invoices, check loyalty, and pull wallet credit scores.

What you can do
  • Request payment invoices for endpoints and verify submitted transaction hashes to obtain a short-lived access token
  • Check loyalty tiers, free-call balances and platform-wide payment stats
  • Retrieve compliance receipts and full Agent Passports for XRPL wallets
  • Query FICO-style credit bureau scores, full reports, threshold checks and portable attestations
  • Read merchant fee and loyalty tier pricing
When to use it
Useful when an assistant or agent needs to pay for x402-protected resources on XRPL, Xahau, Base or Solana, or when you want to assess the payment history and creditworthiness of an XRPL wallet before transacting.
Requirements
Remote streamable HTTP endpoint; no authentication, environment variables or headers declared. A crypto wallet able to pay invoices on XRPL (RLUSD or USDC), Xahau (XAH), Base (USDC) or Solana (USDC-SPL) is needed for paid flows; some tools cost RLUSD.
Before you install
Several tools cost money: bureau_full_report and bureau_get_attestation cost 0.01 RLUSD each, bureau_verify_threshold 0.005 RLUSD, and Xahau invoices may require an extra 0.01 XAH facilitator fee. Invoices involve real crypto payments to destination addresses; verify amounts and addresses before paying. Wallet addresses and payment history are sent to a third-party service.

Installation

In SourceWeft

  1. Open 402proof in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Timwal78%2F402proof/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "402proof": {
      "type": "http",
      "url": "https://four02proof.onrender.com/mcp"
    }
  }
}

README

This repository has no README.

Tools

12

merchant_pricing

Free, machine-readable merchant fee and loyalty tiers for 402Proof standard x402 v2 XRPL exact resource servers. List $0.0100; 20% discount after 100 prior successful merchant settlements, 30% after 1,000 and 50% after 10,000. Merchant-side fees accrue separately from buyer payments and are NOT automatically collected. No wallet spend, settlement, or subscription is required to call this tool.

Takes no parameters.

platform_stats

Live 402Proof platform stats: total payments, volume, active agents. Free.

Takes no parameters.

get_invoice

Request a payment invoice for any SqueezeOS endpoint. Returns destination address, amount, and payment_options for XRPL (RLUSD or USDC), Xahau (native XAH), Base (USDC), or Solana (USDC-SPL). Pass currency='USDC' and chain='solana' for Solana; pass asset='XAH' (or chain='xahau') for the Xahau rail. Xahau invoices for third-party endpoints also return fee_required/fee_amount/fee_pay_to/fee_memo_hex: a flat 0.01 XAH facilitator fee paid as a second Xahau Payment (SML endpoints are fee-exempt; the XRPL rail has no facilitator fee). Free.

Parametersassetchaincurrencyendpoint_idrequired

verify_payment

Submit tx_hash after paying an invoice. Supports XRPL, Xahau, Base (0x… hash), and Solana. Returns a signed JWT access_token (1-hour TTL). For a Xahau invoice with fee_required=true, also submit fee_tx_hash (the 0.01 XAH facilitator-fee payment) — settlement requires both payments. Free.

Parameterstx_hashrequiredinvoice_idrequiredfee_tx_hashagent_domainagent_walletrequiredrecovery_secretrequired

check_loyalty

Loyalty tier and free-call balance for any XRPL wallet. Automatic — no registration. Free.

Parameterswalletrequired

get_compliance_receipt

Retrieve a tamper-evident compliance receipt by UUID. Contains XRPL tx hash, agent wallet, endpoint, amount, and timestamp. Free.

Parametersreceipt_idrequired

get_agent_passport

Full Agent Passport for any XRPL wallet: payment history, risk score 0-100, loyalty tier, passport hash. Free.

Parameterswalletrequired

bureau_public_score

FICO-style 300-850 Agent Credit Bureau score for any XRPL wallet. Includes grade and loyalty tier. Free.

Parameterswalletrequired

bureau_full_report

Full credit bureau report: score breakdown, spend history, risk factors. Cost: 0.01 RLUSD.

Parameterswalletrequiredpayment_token

bureau_verify_threshold

Boolean creditworthiness check — is this wallet above a score threshold? Cost: 0.005 RLUSD.

Parameterswalletrequiredpayment_token

bureau_get_attestation

Portable attestation JWT (24h TTL) proving creditworthiness. Cost: 0.01 RLUSD.

Parameterswalletrequiredpayment_token

bureau_verify_attestation

Verify a bureau attestation JWT. Free.

Parameterstokenrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.