x402-conformance-suite

Audit, monitor, and protect endpoints against the x402 strict-v2 standard.

pip install x402-conformance-suite

Quick examples

CLI:

x402-validate https://observer.137-184-67-179.sslip.io

Batch audit:

x402-validate endpoints.txt --output html --parallel 20

MCP server (Claude / Cursor / any MCP client):

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | x402-mcp

Python:

import asyncio
from x402_conformance_suite._engine import run_audit

async def main():
    report = await run_audit("https://example.com")
    print(report.summary)

asyncio.run(main())

What it checks

Seven core checks plus marketplace mode:

A check that does not apply — a bazaar block on an endpoint that never returns 402, say — reports PASS with applicable: false rather than punishing the operator for something the spec does not require.

For multi-product catalogs, use mode="marketplace": every product in the manifest gets its own endpoint audit and bazaar check (see API.md).

Extended tools (separate repo)

Dashboard, API server, Stripe monetization, and proxy middleware: MSSATANASS/x402-validator-tools

Documentation

• API Reference — every public function and result type
• Design — architecture and design choices
• Validation Report — 27 endpoints audited in 5.2 s
• Contributing — how to add checks without breaking stability

License

Apache-2.0.