English Français العربية

io.github.Hasned-spec/ox402-utils

Official registry Search and web

47 micro-priced utilities: search, screenshots, OCR, whois, prices, video downloads. x402 USDC.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http ox402-utils 'https://tracy-collar-preview-demands.trycloudflare.com/mcp402/'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ox402-utils": {
            "type": "http",
            "url": "https://tracy-collar-preview-demands.trycloudflare.com/mcp402/"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ox402-utils
  2. Why this exists
  3. Use it in 30 seconds (curl)
  4. MCP server (Claude / any MCP client)
  5. What's inside (94 tools)
  6. Pricing
  7. Self-host
  8. Discovery
  9. License

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.txt and /.well-known/x402 on this repo's served docs, and rotates periodically — fetch api.txt for 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)

groupexamples
Research & websearch, html2md, web-scrape, extract-structured, deep-search, research-brief, citations, fact-check, web-archive, openapi-fetch, graphql
Documents & mediapdf-extract, ocr, md2pdf, pdf-invoice, video-download, video2mp3, image-optimize, image-compress, capture-page (full-page screenshot/PDF), screenshot-mobile, pdf-merge, pdf-compress
Speechstt / stt-fast (Whisper), tts (neural Kokoro-82M, 30+ voices, $0.004/1k chars), tts-voices
Security & reconsecurity-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 & worldcrypto-price, stock-quote, fx-rates, weather, geoip
Dev & datahttp-headers, ssl-check, exec-python, repo2context, md-compress, temp-webhook, robots, sitemap, link-health, sqlite, embed, price-estimate, dry-run, batch
AI & textai-text, ai-rewrite, ai-summarize, translate, resume-parse, pdf-to-word, plagiarism, qr, link-preview

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

License

MIT

Frequently asked questions

What is io.github.Hasned-spec/ox402-utils?

47 micro-priced utilities: search, screenshots, OCR, whois, prices, video downloads. x402 USDC.

How do I install io.github.Hasned-spec/ox402-utils?

It runs as a remote server. In Claude Code: claude mcp add --transport http ox402-utils 'https://tracy-collar-preview-demands.trycloudflare.com/mcp402/'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Hasned-spec/ox402-utils need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Hasned-spec/ox402-utils open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.Hasned-spec/ox402-utils?

It is published by Hasned-spec. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.