# Agent Data Tools

> Pay-per-call tools for AI agents: web page text extraction and summaries, screenshots, image generation, speech-to-text, image description, domain and email-auth intelligence, and live Base token and wallet lookups. No account or API key; pay per request in USDC on Base via x402.

All endpoints are GET, return JSON, and cost a fixed price per successful call. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header (x402 v2, exact scheme, USDC on Base). Sign the payment and retry with the PAYMENT-SIGNATURE header. Failed calls (4xx/5xx) are not charged.

Free trial: add trial=1 to any GET request for a free call, up to 3 per caller per day while the daily trial pool lasts. Without it, unpaid requests get the 402 challenge.

## Endpoints

### GET /extract — $0.002
Fetch any public web page and get clean readable text for LLM input: title, meta description, language, canonical URL, H1-H3 headings, main body text with navigation, scripts and boilerplate removed, and the page's outbound links. Use for web scraping, article reading, research and RAG ingestion.
- `url` (string, required): Absolute http(s) URL of the page to fetch
- `maxChars` (integer): Maximum characters of body text to return (500-100000, default 20000)
Example: https://agent-data-tools.revmesh2074.workers.dev/extract?url=https%3A%2F%2Fexample.com

### GET /domain — $0.005
Domain intelligence in one call: DNS records (A, AAAA, CNAME, MX, NS, TXT, CAA), DNSSEC status, registrar, registration and expiry dates with domain age in days (RDAP/WHOIS), and email authentication (SPF and DMARC records and policies, whether the domain accepts mail). Use for lead qualification, phishing and trust checks, and deliverability audits.
- `name` (string, required): Domain name, e.g. cloudflare.com
Example: https://agent-data-tools.revmesh2074.workers.dev/domain?name=cloudflare.com

### GET /token — $0.01
Live on-chain facts for any ERC-20 token on Base: name, symbol, decimals, total supply, owner address and whether ownership is renounced, paused state, proxy detection (EIP-1967 and minimal proxy) with implementation and admin addresses, and bytecode heuristics for mint, pause, blacklist and fee-setter functions. Use for token due diligence and rug-pull or honeypot screening before a swap.
- `address` (string, required): Token contract address on Base (0x...)
Example: https://agent-data-tools.revmesh2074.workers.dev/token?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

### GET /wallet — $0.005
Live snapshot of any address on Base: ETH balance, balances of major tokens (USDC, WETH, cbBTC, DAI, USDbC, cbETH, AERO, EURC) plus up to 20 extra token addresses you pass, transaction count, and whether the address is an EOA, a smart contract or an EIP-7702 delegated account. Use for portfolio checks, counterparty screening and payment verification.
- `address` (string, required): Wallet or contract address on Base (0x...)
- `tokens` (string): Optional comma-separated extra ERC-20 addresses to check (max 20)
Example: https://agent-data-tools.revmesh2074.workers.dev/wallet?address=0x4200000000000000000000000000000000000006

### GET /summarize — $0.01
Give a URL, get a short summary of the page plus three to six key points, ready to drop into an agent's context. Fetches the page, strips navigation and boilerplate, and summarizes the main text with an LLM. Use for research, news triage, link previews and deciding whether a page is worth reading in full.
- `url` (string, required): Absolute http(s) URL of the page to summarize
Example: https://agent-data-tools.revmesh2074.workers.dev/summarize?url=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FHTTP_402

### GET /screenshot — $0.02
Render any public web page in a real headless Chrome browser, with JavaScript executed, and get a JPEG screenshot (1280 px wide, base64) plus the final URL, HTTP status and page title. Set fullPage=true to capture up to 4000 px of page height. Use for visual checks, page previews, monitoring and feeding pages to vision models.
- `url` (string, required): Absolute http(s) URL of the page to capture
- `fullPage` (string): Set to true to capture the full page height (max 4000 px) instead of the 1280x800 viewport
Example: https://agent-data-tools.revmesh2074.workers.dev/screenshot?url=https%3A%2F%2Fexample.com

### GET /image — $0.02
Text-to-image generation with FLUX.1 schnell. Send a prompt, get a 1024x1024 JPEG back as base64 in a few seconds. Use for illustrations, thumbnails, mockups, avatars and social media images. Optional steps parameter (1-8, default 4) trades speed for detail.
- `prompt` (string, required): What the image should show (3-800 characters)
- `steps` (integer): Diffusion steps, 1-8 (default 4)
Example: https://agent-data-tools.revmesh2074.workers.dev/image?prompt=a%20lighthouse%20on%20a%20cliff%20at%20sunset%2C%20watercolor

### GET /transcribe — $0.02
Transcribe speech from an audio file at a public URL using Whisper large-v3-turbo. Returns the transcript text, detected language, duration and word count. Accepts common formats such as MP3, WAV, M4A and OGG up to 5 MB. Use for voice notes, podcast clips, meeting snippets and voice messages.
- `url` (string, required): Absolute http(s) URL of an audio file (max 5 MB)
Example: https://agent-data-tools.revmesh2074.workers.dev/transcribe?url=https%3A%2F%2Fcommons.wikimedia.org%2Fwiki%2FSpecial%3AFilePath%2FEn-us-hello.ogg

### GET /describe — $0.01
Vision model for an image at a public URL: get a detailed description including any visible text, or pass a question to ask something specific about the image. Accepts PNG, JPEG, WebP and GIF up to 3 MB. Use for alt text, OCR-style reading of screenshots, chart reading and content checks.
- `url` (string, required): Absolute http(s) URL of a PNG, JPEG, WebP or GIF image (max 3 MB)
- `question` (string): Optional question about the image (max 300 characters); default is a detailed description
Example: https://agent-data-tools.revmesh2074.workers.dev/describe?url=https%3A%2F%2Fupload.wikimedia.org%2Fwikipedia%2Fcommons%2F4%2F47%2FPNG_transparency_demonstration_1.png

### GET /btc-fees — $0.002
Current Bitcoin network fee rates in sat/vB for next-block, half-hour, one-hour and economy confirmation, the estimated cost in sats of a typical payment, mempool size and total pending fees, and the latest block height. Use before sending a Bitcoin transaction or to decide whether to wait for lower fees.
Example: https://agent-data-tools.revmesh2074.workers.dev/btc-fees?format=json

### GET /btc-address — $0.003
Balance and activity of any Bitcoin mainnet address (legacy, P2SH or bech32): confirmed balance in sats and BTC, unconfirmed pending amount, total received and sent, and transaction counts. Use for payment verification, checking whether a deposit arrived, and wallet monitoring.
- `address` (string, required): Bitcoin mainnet address (1..., 3... or bc1...)
Example: https://agent-data-tools.revmesh2074.workers.dev/btc-address?address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

### GET /ln-invoice — $0.001
Decode a BOLT11 Lightning Network invoice without paying it: network, amount in sats and BTC, description, payment hash, creation time, expiry time and whether it has already expired. Use to check what an invoice asks for before an agent pays it.
- `invoice` (string, required): BOLT11 invoice string starting with ln (lnbc... for mainnet)
Example: https://agent-data-tools.revmesh2074.workers.dev/ln-invoice?invoice=lnbc2500u1pvjluezsp5zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygspp5qqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqypqdq5xysxxatsyp3k7enxv4jsxqzpu9qrsgquk0rl77nj30yxdy8j9vdx85fkpmdla2087ne0xh8nhedh8w27kyke0lp53ut353s06fv3qfegext0eh0ymjpf39tuven09sam30g4vgpfna3rh

### GET /package — $0.002
Check a software package before installing it: whether it exists at all (AI coding assistants sometimes invent names), latest version and release date, package age, number of versions, weekly downloads (npm), licenses, deprecation, and known security advisories with severity. Returns a verdict of ok, caution or not-found with the reasons. Covers npm, PyPI, Cargo, Go, Maven and NuGet. Use before adding a dependency or running an install command.
- `ecosystem` (string, required): One of npm, pypi, cargo, go, maven, nuget
- `name` (string, required): Exact package name, e.g. lodash or @scope/name
Example: https://agent-data-tools.revmesh2074.workers.dev/package?ecosystem=npm&name=lodash

### GET /email — $0.001
Validate an email address before using it: syntax, whether the domain exists and accepts mail (MX records), disposable or throwaway provider detection, role addresses such as info@ or support@, free-provider detection, and SPF and DMARC presence. Returns a verdict of likely-deliverable, risky, undeliverable or invalid with reasons. No message is sent and the mail server is not contacted. Use for sign-up checks, lead list cleaning and contact enrichment.
- `address` (string, required): The email address to check
Example: https://agent-data-tools.revmesh2074.workers.dev/email?address=support%40cloudflare.com

### GET /papers — $0.003
Search scholarly literature across journals, conferences, preprints and books: title, authors, year, venue, citation count, DOI link and abstract where available. Optional fromYear filter and up to 20 results per call. Use for research agents, literature reviews, fact-checking a claim against published work, and finding the DOI for a citation.
- `query` (string, required): Search terms, a title or a research question (3-300 characters)
- `limit` (integer): Number of results, 1-20 (default 5)
- `fromYear` (integer): Only works published in or after this year
Example: https://agent-data-tools.revmesh2074.workers.dev/papers?query=attention%20is%20all%20you%20need

## Machine-readable

- MCP server (streamable HTTP, same tools and prices): https://agent-data-tools.revmesh2074.workers.dev/mcp
- [OpenAPI 3.1](https://agent-data-tools.revmesh2074.workers.dev/openapi.json)
- [Service card](https://agent-data-tools.revmesh2074.workers.dev/)
- [x402 resource list](https://agent-data-tools.revmesh2074.workers.dev/.well-known/x402)
- [Store: x402 Seller Kit, a template and guide for building a service like this](https://agent-data-tools.revmesh2074.workers.dev/store)