facilitator.agent-tools.cloud

An open, community-funded x402 facilitator. No API keys, no KYT, no data harvesting. Apache-2.0.

Deployed at: https://facilitator.agent-tools.cloud

What is this?

x402 is an HTTP-native payment protocol (RFC 9110 status 402 Payment Required) that lets agents and APIs charge in stablecoin per request. A facilitator is the off-chain service that verifies buyer signatures and submits the on-chain settlement.

This facilitator:

• Implements the standard x402 v2 protocol (/verify, /settle, /supported)
• Supports Base mainnet (Solana / Polygon planned)
• Charges no settlement fee
• Open-source under Apache-2.0
• Tips welcome at 0xC445aa2AA0FA68db67Cd22fc04867773941f9CdF (USDC on Base)

Quick use

Point your x402 client at:

https://facilitator.agent-tools.cloud

/supported returns the chains and schemes we accept.

Run your own

git clone git@github.com:JoursBleu/facilitator.git
cd facilitator
cp .env.example .env
# fill in HOT_WALLET_PRIVATE_KEY, RPC_BASE_URL, TIP_ADDRESS
python3 scripts/gen_wallet.py        # or bring your own key
docker compose up -d

Open http://localhost:9200/healthz.

Project layout

facilitator/
├── facilitator/         # FastAPI app
│   ├── main.py
│   ├── config.py
│   ├── wallet.py
│   ├── gas_oracle.py
│   ├── x402.py          # /verify, /settle, /supported
│   ├── db.py
│   └── landing.py
├── scripts/
│   └── gen_wallet.py
├── nginx/
├── systemd/
├── Dockerfile
├── docker-compose.yml
├── pyproject.toml
└── .env.example

License

Apache-2.0