onyx_verify_explain

Active

declared in 1.26.0

Diagnose a failing x402 v2 /verify. Decodes a captured X-PAYMENT header, runs 10 rules (decode, schema, network/asset/payTo match, value sufficiency, EIP-3009 timing, signature shape, scheme) against expected paymentRequirements, and returns the FIRST failing rule with a plain-English fix. Catches the common case where the facilitator returns bare HTTP 402 (no body) because of JWT or schema fail upstream of the verifier. Stdlib-only, no install, no network. (price: $0 USDC, tier: free)

Parameters schema

{
  "type": "object",
  "required": [
    "payment_requirements"
  ],
  "properties": {
    "now_unix": {
      "type": "integer",
      "description": "Override current unix time for replay/CI use. Defaults to now."
    },
    "x_payment_b64": {
      "type": "string",
      "description": "Base64-encoded X-PAYMENT (v2 PAYMENT-SIGNATURE) header value. Optional if payment_payload provided."
    },
    "payment_payload": {
      "type": "object",
      "description": "Decoded payment payload dict. Use this OR x_payment_b64."
    },
    "payment_requirements": {
      "type": "object",
      "description": "Expected paymentRequirements from the 402 challenge ({scheme, network, payTo, asset, maxAmountRequired, maxTimeoutSeconds, ...})."
    }
  }
}

What this tool wraps· 1 endpoint

min confidence0.70 0.50

Packagepypi: x402
declared dependency0.85

Parent server

onyx-paid-mcp

https://github.com/dimitrilaouanis-tech/onyx-mcp

2/7 registries

View full server →