ox402-utils
94 capability APIs an AI agent can't run in its own sandbox — paid per call via x402 (USDC on Base). Web research, security recon, neural text-to-speech (Kokoro-82M), speech, document + media conversion, full-page screenshots, SSL/breach audits, SQL sandboxes, embeddings, and more. No accounts, no API keys, no subscription. Free trial: 10 calls/IP on tier=free tools.
Live site: the current tunnel URL is published in
api.txtand/.well-known/x402on this repo's served docs, and rotates periodically — fetchapi.txtfor the live endpoint. MCP server:/mcp402/· Catalog:/x402/catalog· Machine-readable:/llms.txt
Why this exists
An AI agent's sandbox can't open a browser, run a GPU TTS model, scan a host for open ports,
or audit a site's TLS. ox402 does those for it — and bills per call in USDC. No signup, no
API key, no monthly minimum. Every call is authorized by an on-chain micropayment
(x402): hit the endpoint, get a 402 challenge, pay the exact amount,
retry with the X-Payment header.
Free trial: 10 calls/IP on tier=free tools. Paid-tier tools always require x402 USDC.
Use it in 30 seconds (curl)
# Free trial (10 calls/IP): no payment needed
curl -X POST http://129.213.128.185/x402/trial/search \
-H 'Content-Type: application/json' \
-d '{"query":"x402 protocol","count":3}'
# Paid tier: POST -> 402 challenge -> pay -> retry with X-Payment header
curl -i http://129.213.128.185/x402/paid/search \
-H 'Content-Type: application/json' \
-d '{"query":"x402 protocol","count":3}'
The 402 response carries a PAYMENT-REQUIRED challenge with the exact USDC amount and the
payTo address. Pay on Base, then repeat the request with the signed payment in the
X-Payment header (any x402 client: the Coinbase x402 fetch wrapper, or your own signer).
Verified + settled via our self-hosted facilitator (melonask/facilitator) on Base mainnet.
MCP server (Claude / any MCP client)
{
"mcpServers": {
"ox402-utils": { "url": "http://129.213.128.185/mcp402/" }
}
}
tools/list is free and returns all 94 tools (compact ~1.6k-token menu; full schemas on
demand). tools/call returns the payment instructions when unpaid. Drop it into Claude
Desktop, Cursor, or any MCP framework and the agent can pay-to-use every tool.
What's inside (94 tools)
Pricing
- Free tier: 10 calls/IP on all tier=free tools via
/x402/trial/<tool>(no wallet, no signup) - Paid tier: $0.001 – $0.10 per call (avg $0.014), USDC on Base mainnet (chain 8453)
- Payee:
0xE9C9cC258f7137fD0AbA4Ae513F0Cfa288c0cDc9
Self-host
git clone https://github.com/Hasned-spec/ox402-utils
cd ox402-utils
pip install -r requirements.txt
python3 x402_server.py # :8793
Docker:
docker build -t ox402 .
docker run -p 8793:8793 -p 8796:8796 ox402
Discovery
- GitHub Pages: https://hasned-spec.github.io/ox402-utils/
- 402index: https://402index.io (search "ox402")
- Glama: https://glama.ai/mcp/servers/Hasned-spec/ox402-utils
- MCP:
/mcp402/on the live tunnel
License
MIT