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)
| group | examples |
|---|---|
| Research & web | search, html2md, web-scrape, extract-structured, deep-search, research-brief, citations, fact-check, web-archive, openapi-fetch, graphql |
| Documents & media | pdf-extract, ocr, md2pdf, pdf-invoice, video-download, video2mp3, image-optimize, image-compress, capture-page (full-page screenshot/PDF), screenshot-mobile, pdf-merge, pdf-compress |
| Speech | stt / stt-fast (Whisper), tts (neural Kokoro-82M, 30+ voices, $0.004/1k chars), tts-voices |
| Security & recon | security-headers, cors-check, cookie-flags, dns-recon, port-scan, leak-check, subdomain-find, threat-intel, site-report, file-scan, email-verify, reverse-dns, header-compare |
| Finance & world | crypto-price, stock-quote, fx-rates, weather, geoip |
| Dev & data | http-headers, ssl-check, exec-python, repo2context, md-compress, temp-webhook, robots, sitemap, link-health, sqlite, embed, price-estimate, dry-run, batch |
| AI & text | ai-text, ai-rewrite, ai-summarize, translate, resume-parse, pdf-to-word, plagiarism, qr, |
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