{
  "markdown": "# ox402-utils\n\n**94 capability APIs an AI agent can't run in its own sandbox — paid per call via x402 (USDC on Base).**\nWeb research, security recon, **neural text-to-speech (Kokoro-82M)**, speech, document + media\nconversion, full-page screenshots, SSL/breach audits, SQL sandboxes, embeddings, and more.\nNo accounts, no API keys, no subscription. **Free trial: 10 calls/IP on tier=free tools.**\n\n[![Hasned-spec/ox402-utils MCP server](https://glama.ai/mcp/servers/Hasned-spec/ox402-utils/badges/score.svg)](https://glama.ai/mcp/servers/Hasned-spec/ox402-utils)\n\n> 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.**\n> MCP server: **`/mcp402/`** · Catalog: **`/x402/catalog`** · Machine-readable: **`/llms.txt`**\n\n---\n\n## Why this exists\n\nAn AI agent's sandbox can't open a browser, run a GPU TTS model, scan a host for open ports,\nor audit a site's TLS. ox402 does those for it — and bills per call in USDC. No signup, no\nAPI key, no monthly minimum. Every call is authorized by an on-chain micropayment\n([x402](https://www.x402.org)): hit the endpoint, get a `402` challenge, pay the exact amount,\nretry with the `X-Payment` header.\n\n**Free trial: 10 calls/IP on tier=free tools.** Paid-tier tools always require x402 USDC.\n\n## Use it in 30 seconds (curl)\n\n```bash\n# Free trial (10 calls/IP): no payment needed\ncurl -X POST http://129.213.128.185/x402/trial/search \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"query\":\"x402 protocol\",\"count\":3}'\n\n# Paid tier: POST -> 402 challenge -> pay -> retry with X-Payment header\ncurl -i http://129.213.128.185/x402/paid/search \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"query\":\"x402 protocol\",\"count\":3}'\n```\n\nThe `402` response carries a `PAYMENT-REQUIRED` challenge with the exact USDC amount and the\n`payTo` address. Pay on Base, then repeat the request with the signed payment in the\n`X-Payment` header (any x402 client: the Coinbase `x402` fetch wrapper, or your own signer).\nVerified + settled via our self-hosted facilitator (melonask/facilitator) on Base mainnet.\n\n## MCP server (Claude / any MCP client)\n\n```json\n{\n  \"mcpServers\": {\n    \"ox402-utils\": { \"url\": \"http://129.213.128.185/mcp402/\" }\n  }\n}\n```\n\n`tools/list` is free and returns all 94 tools (compact ~1.6k-token menu; full schemas on\ndemand). `tools/call` returns the payment instructions when unpaid. Drop it into Claude\nDesktop, Cursor, or any MCP framework and the agent can pay-to-use every tool.\n\n## What's inside (94 tools)\n\n| group | examples |\n|-------|----------|\n| Research & web | `search`, `html2md`, `web-scrape`, `extract-structured`, `deep-search`, `research-brief`, `citations`, `fact-check`, `web-archive`, `openapi-fetch`, `graphql` |\n| 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` |\n| Speech | `stt` / `stt-fast` (Whisper), `tts` (**neural Kokoro-82M**, 30+ voices, $0.004/1k chars), `tts-voices` |\n| 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` |\n| Finance & world | `crypto-price`, `stock-quote`, `fx-rates`, `weather`, `geoip` |\n| Dev & data | `http-headers`, `ssl-check`, `exec-python`, `repo2context`, `md-compress`, `temp-webhook`, `robots`, `sitemap`, `link-health`, `sqlite`, `embed`, `price-estimate`, `dry-run`, `batch` |\n| AI & text | `ai-text`, `ai-rewrite`, `ai-summarize`, `translate`, `resume-parse`, `pdf-to-word`, `plagiarism`, `qr`, `link-preview` |\n\n## Pricing\n\n- **Free tier:** 10 calls/IP on all tier=free tools via `/x402/trial/<tool>` (no wallet, no signup)\n- **Paid tier:** $0.001 – $0.10 per call (avg $0.014), USDC on Base mainnet (chain 8453)\n- **Payee:** `0xE9C9cC258f7137fD0AbA4Ae513F0Cfa288c0cDc9`\n\n## Self-host\n\n```bash\ngit clone https://github.com/Hasned-spec/ox402-utils\ncd ox402-utils\npip install -r requirements.txt\npython3 x402_server.py   # :8793\n```\n\nDocker:\n\n```bash\ndocker build -t ox402 .\ndocker run -p 8793:8793 -p 8796:8796 ox402\n```\n\n## Discovery\n\n- **GitHub Pages:** https://hasned-spec.github.io/ox402-utils/\n- **402index:** https://402index.io (search \"ox402\")\n- **Glama:** https://glama.ai/mcp/servers/Hasned-spec/ox402-utils\n- **MCP:** `/mcp402/` on the live tunnel\n\n## License\n\nMIT\n",
  "bytes": 4562,
  "sha": "69fd1c8066a324947406eddbe5f6af9f60a984448b107a9c38b678e407ae0db5",
  "repo_slug": "hasned-spec/ox402-utils",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hasned_spec_ox402_utils_05c56767/readme"
}