# Agent Toolbox

> Everyday tools for AI agents, paid per call with x402: image generation, web pages and documents to Markdown, speech to text, embeddings, translation, summaries, email checks, exchange rates, DNS and domain records. No account or API key; pay per call in USDC on Base with x402. Requests that fail are not charged.

## Free
- Reader: GET https://agent-toolbox.zafermemon87.workers.dev/r/<url> returns any public web page or document as Markdown (Accept: application/json for JSON). 20 reads a minute per IP, up to 5 MB, follows robots.txt.
- GET https://agent-toolbox.zafermemon87.workers.dev/free/markdown: the url_to_markdown tool for free, 30 requests a minute per IP.
- GET https://agent-toolbox.zafermemon87.workers.dev/free/dns: the dns_lookup tool for free, 30 requests a minute per IP.
- GET https://agent-toolbox.zafermemon87.workers.dev/free/fx: the fx_rates tool for free, 30 requests a minute per IP.
- GET https://agent-toolbox.zafermemon87.workers.dev/free/whois: the domain_whois tool for free, 30 requests a minute per IP.
- GET https://agent-toolbox.zafermemon87.workers.dev/free/email-verify: the verify_email tool for free, 30 requests a minute per IP.

## Tools (HTTP, JSON answers)
- POST https://agent-toolbox.zafermemon87.workers.dev/v1/image: $0.01 (generate_image). Generate a 1024x1024 JPEG image from a text prompt with FLUX.1 schnell; every prompt passes a safety check first (sexual content and other unsafe requests are refused and not charged). Returns the image as base64. JSON body example: {"prompt":"a lighthouse on a cliff at sunrise, watercolor"}
- GET https://agent-toolbox.zafermemon87.workers.dev/v1/markdown?url=: $0.002 (url_to_markdown). Fetch a public web page or document (HTML, PDF, Word, Excel, CSV, XML; up to 10 MB) and return it as clean Markdown with its title and final URL.
- POST https://agent-toolbox.zafermemon87.workers.dev/v1/markdown: $0.003 (file_to_markdown). Convert an uploaded document (PDF, Word, Excel, CSV, HTML, XML, OpenDocument; up to 10 MB) to Markdown. JSON body example: {"filename":"notes.csv","file_base64":"bmFtZSxzY29yZQphbGljZSw5Cg=="}
- POST https://agent-toolbox.zafermemon87.workers.dev/v1/transcribe: $0.01 (transcribe_audio). Speech to text with Whisper large v3 turbo: transcribe audio (mp3, wav, m4a, ogg, webm; up to 20 MB, about 20 minutes) from a URL or base64, or translate the speech into English. Returns the text, language, duration and timed segments. JSON body example: {"audio_url":"https://example.com/meeting.mp3"}
- POST https://agent-toolbox.zafermemon87.workers.dev/v1/embed: $0.002 (embed_text). Text embeddings with BGE-M3 (multilingual, 1024 dimensions) for search, clustering and RAG: up to 100 texts of up to 8,000 characters per call. JSON body example: {"texts":["The cat sat on the mat","A feline rested on a rug"]}
- POST https://agent-toolbox.zafermemon87.workers.dev/v1/translate: $0.002 (translate_text). Translate text (up to 5,000 characters) between 100 languages with M2M100 1.2B. JSON body example: {"text":"Where is the train station?","target_lang":"french"}
- POST https://agent-toolbox.zafermemon87.workers.dev/v1/summarize: $0.003 (summarize). Summarize text (up to 60,000 characters) or a public web page or PDF by URL with Llama 3.1 8B, short, medium or long, optionally focused on a topic. JSON body example: {"url":"https://example.com","length":"short"}
- GET https://agent-toolbox.zafermemon87.workers.dev/v1/email-verify?email=: $0.002 (verify_email). Check an email address: format, whether the domain exists and accepts mail (MX records), disposable providers, role accounts and free providers, with a valid / risky / invalid verdict. The mailbox itself is not probed.
- GET https://agent-toolbox.zafermemon87.workers.dev/v1/fx?base=&symbols=&amount=: $0.002 (fx_rates). Currency exchange rates and conversion for about 30 currencies (USD, EUR, GBP, INR, JPY, CNY ...) from the European Central Bank reference rates of the latest working day.
- GET https://agent-toolbox.zafermemon87.workers.dev/v1/dns?name=&type=: $0.002 (dns_lookup). DNS records of a domain (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SRV, PTR) over DNS-over-HTTPS (1.1.1.1), with DNSSEC validation status.
- POST https://agent-toolbox.zafermemon87.workers.dev/v1/llm/gpt-oss-120b/chat/completions: $0.005 (chat_gpt_oss_120b). OpenAI-compatible chat completion with gpt-oss-120b (OpenAI's open-weight reasoning model): set the base URL to /v1/llm/gpt-oss-120b in any OpenAI SDK. Up to 32,000 characters in and 2,048 tokens out per call, a fixed price per call, no streaming. JSON body example: {"messages":[{"role":"user","content":"In one sentence, what is the capital of France?"}],"max_tokens":200}
- POST https://agent-toolbox.zafermemon87.workers.dev/v1/llm/qwen3-30b/chat/completions: $0.002 (chat_qwen3_30b). OpenAI-compatible chat completion with Qwen3 30B (fast mixture-of-experts model): set the base URL to /v1/llm/qwen3-30b in any OpenAI SDK. Up to 32,000 characters in and 2,048 tokens out per call, a fixed price per call, no streaming. JSON body example: {"messages":[{"role":"user","content":"In one sentence, what is the capital of France?"}],"max_tokens":200}
- GET https://agent-toolbox.zafermemon87.workers.dev/v1/whois?domain=: $0.002 (domain_whois). Domain registration data from RDAP (the successor of WHOIS): registrar, creation, expiry and update dates, status codes, nameservers and DNSSEC.

## API keys (instead of x402)
- Send Authorization: Bearer atb_... (or X-API-Key) on any paid route or MCP call: the price is taken from the key's prepaid credits, only when the call succeeds. Balance: GET https://agent-toolbox.zafermemon87.workers.dev/account.

## MCP
- Remote MCP server, nothing to install: https://agent-toolbox.zafermemon87.workers.dev/mcp (Streamable HTTP, no auth). Paid tools are charged with x402 over MCP (payment in _meta["x402/payment"]); service_info is free.

## More
- OpenAPI: https://agent-toolbox.zafermemon87.workers.dev/openapi.json
- x402 manifest: https://agent-toolbox.zafermemon87.workers.dev/.well-known/x402