# Agent Tools

> Small pay-per-call utilities for AI agents. Payment is x402 (HTTP 402), USDC on Base (eip155:8453). No accounts or API keys: call an endpoint, receive a 402 with payment requirements, pay, retry with the PAYMENT-SIGNATURE header.

## Endpoints

### email_check
GET https://agent-tools.jbarkules.workers.dev/v1/email/check  ($0.001 USDC)
Email validation for signup forms, lead lists and CRM cleanup: checks syntax, MX mail servers, disposable or temporary domains, role addresses (info@, sales@) and free providers. Returns a deliverable_guess. No SMTP probe, no data stored.
Example input: {"email":"jane@acme.com"}
Example output: {"email":"jane@acme.com","valid_syntax":true,"domain":"acme.com","mx_records":["10 mx1.acme.com."],"has_mail_server":true,"disposable":false,"role_account":false,"free_provider":false,"deliverable_guess":"likely"}

### email_check_full
GET https://agent-tools.jbarkules.workers.dev/v1/email/full  ($0.0025 USDC)
One call email risk check: everything in email_check plus sender domain health (domain age, registrar, SPF, DMARC, website reachable) and a 0-100 risk score with accept/review/reject verdict. Use for fraud screening, lead qualification and signup gating.
Example input: {"email":"jane@acme.com"}
Example output: {"email":"jane@acme.com","has_mail_server":true,"disposable":false,"domain_health":{"registrar":"GoDaddy.com, LLC","age_days":4021,"spf":"v=spf1 include:_spf.google.com ~all","dmarc":"v=DMARC1; p=reject","website_reachable":true},"risk_score":0,"risk_reasons":[],"verdict":"accept"}

### pdf_to_text
GET https://agent-tools.jbarkules.workers.dev/v1/pdf/text  ($0.0035 USDC)
PDF to text or markdown for RAG, summarizing, search indexing and reading reports, papers, contracts and invoices. Give a PDF URL (max 20 MB); returns text per page. format=text or markdown. Not stored.
Example input: {"url":"https://pdfobject.com/pdf/sample.pdf","format":"markdown"}
Example output: {"pages":1,"format":"markdown","characters":2859,"text":"## Page 1\n\nSample PDF\nThis is a simple PDF file..."}

### pdf_to_text_upload
POST https://agent-tools.jbarkules.workers.dev/v1/pdf/text/upload  ($0.0035 USDC)
PDF to text from uploaded bytes: send the raw PDF as the request body (max 20 MB). For files that are not on a public URL. ?format=text or markdown.
Example input: {}
Example output: {"pages":1,"format":"text","characters":14,"text":"Dummy PDF file"}

### document_extract
GET https://agent-tools.jbarkules.workers.dev/v1/document/extract  ($0.006 USDC)
One call document parsing for invoices, receipts, statements, forms and scanned pages: PDF or image URL in, full text plus extracted fields out (dates, money amounts, totals/tax/amount due, invoice or order numbers, key: value pairs, emails, phones, URLs, simple tables). Images and scans use OCR.
Example input: {"url":"https://pdfobject.com/pdf/sample.pdf"}
Example output: {"kind":"pdf","pages":1,"characters":1840,"text":"INVOICE\nInvoice #: INV-1042\nDate: 2026-10-01\nTotal: $1,250.00","fields":{"dates":["2026-10-01"],"amounts":["$1,250.00"],"totals":[{"label":"total","value":"$1,250.00"}],"identifiers":["Invoice #: INV-1042"],"key_values":{"Invoice":"INV-1042","Date":"2026-10-01"},"emails":[],"phones":[],"urls":[],"tables":[]}}

### document_extract_upload
POST https://agent-tools.jbarkules.workers.dev/v1/document/extract/upload  ($0.006 USDC)
Document parsing from uploaded bytes: send a raw PDF or image (PNG/JPEG) body; returns text plus dates, amounts, totals, IDs, key-value pairs and tables.
Example input: {}
Example output: {"kind":"image","pages":null,"text":"TOTAL $12.40","fields":{"amounts":["$12.40"],"totals":[{"label":"total","value":"$12.40"}]}}

### domain_lookup
GET https://agent-tools.jbarkules.workers.dev/v1/domain/lookup  ($0.0018 USDC)
Domain intelligence for due diligence, phishing checks and lead research: registrar, creation and expiry dates (RDAP/WHOIS), A/AAAA/MX/NS/TXT records, SPF, DMARC and HTTPS reachability in one call.
Example input: {"domain":"example.com"}
Example output: {"domain":"example.com","registered":true,"registrar":"RESERVED-Internet Assigned Numbers Authority","created":"1995-08-14T04:00:00Z","expires":"2027-08-13T04:00:00Z","dns":{"a":["93.184.215.14"],"mx":[],"ns":["a.iana-servers.net."]},"email_security":{"spf":"v=spf1 -all","dmarc":null},"https":{"reachable":true,"status":200}}

### image_ocr
GET https://agent-tools.jbarkules.workers.dev/v1/ocr  ($0.0038 USDC)
OCR: read all text from a screenshot, photo, receipt, sign, scanned page or chart image at a URL (PNG/JPEG, max 10 MB). Keeps line breaks.
Example input: {"url":"https://placehold.co/600x200/png?text=Hello+Agent+Tools"}
Example output: {"text":"Hello Agent Tools"}

### image_ocr_upload
POST https://agent-tools.jbarkules.workers.dev/v1/ocr/upload  ($0.0038 USDC)
OCR from uploaded bytes: send a raw PNG/JPEG image body (max 10 MB) and get its text back.
Example input: {}
Example output: {"text":"Hello Agent Tools"}

### file_convert
POST https://agent-tools.jbarkules.workers.dev/v1/convert  ($0.003 USDC)
Format conversion for data pipelines and publishing: CSV to JSON, JSON to CSV, HTML to markdown, markdown to HTML, HTML to plain text. JSON body {from, to, input}.
Example input: {"from":"csv","to":"json","input":"name,qty\nwidget,2"}
Example output: {"output":[{"name":"widget","qty":"2"}]}

### web_to_markdown
GET https://agent-tools.jbarkules.workers.dev/v1/web/markdown  ($0.0015 USDC)
Read a web page as clean LLM-ready markdown (main content, no nav or scripts) for research, RAG and summarization. Respects robots.txt.
Example input: {"url":"https://example.com"}
Example output: {"url":"https://example.com/","status":200,"title":"Example Domain","characters":156,"markdown":"This domain is for use in documentation examples..."}

### web_read_full
GET https://agent-tools.jbarkules.workers.dev/v1/web/read  ($0.003 USDC)
One call page reader: clean markdown plus page metadata (title, description, Open Graph, canonical, favicon), outbound links, word count and extracted dates, prices, emails and phones. Use for research agents, price checks and lead enrichment from public pages.
Example input: {"url":"https://example.com"}
Example output: {"url":"https://example.com/","title":"Example Domain","markdown":"...","meta":{"description":null,"og_image":null,"canonical":null},"links":["https://iana.org/domains/example"],"word_count":25,"fields":{"dates":[],"amounts":[],"emails":[],"phones":[]}}

### url_metadata
GET https://agent-tools.jbarkules.workers.dev/v1/web/meta  ($0.001 USDC)
Link preview and unfurl data: title, description, Open Graph image, site name, canonical URL, favicon and final URL after redirects.
Example input: {"url":"https://github.com"}
Example output: {"url":"https://github.com/","final_url":"https://github.com/","status":200,"title":"GitHub","description":"Join the world's most widely adopted...","og_image":"https://github.githubassets.com/images/modules/site/social-cards/campaign-social.png","site_name":"GitHub"}

### timezone_convert
GET https://agent-tools.jbarkules.workers.dev/v1/time/convert  ($0.001 USDC)
Timezone conversion for scheduling meetings and deadlines across IANA zones, with DST-correct UTC offsets. time=ISO local time or 'now'.
Example input: {"time":"2026-10-22T12:00:00","from":"America/New_York","to":"Asia/Tokyo"}
Example output: {"utc":"2026-10-22T16:00:00.000Z","from":{"timezone":"America/New_York","local":"2026-10-22T12:00:00","utc_offset":"-04:00"},"to":{"timezone":"Asia/Tokyo","local":"2026-10-23T01:00:00","utc_offset":"+09:00"}}

### business_days
GET https://agent-tools.jbarkules.workers.dev/v1/time/business-days  ($0.001 USDC)
Business day calculator for SLAs, invoice due dates, shipping and legal deadlines: counts working days between two dates, skipping weekends and national public holidays (ISO country code).
Example input: {"start":"2026-12-01","end":"2026-12-31","country":"US"}
Example output: {"start":"2026-12-01","end":"2026-12-31","country":"US","business_days":22,"holidays_excluded":1,"inclusive":true}

### public_holidays
GET https://agent-tools.jbarkules.workers.dev/v1/time/holidays  ($0.001 USDC)
Public holiday calendar for 100+ countries by year, for scheduling, payroll and delivery planning.
Example input: {"country":"US","year":"2027"}
Example output: {"year":2027,"country":"US","holidays":[{"date":"2027-01-01","name":"New Year's Day","local_name":"New Year's Day","global":true}]}

### fx_rates
GET https://agent-tools.jbarkules.workers.dev/v1/fx/rates  ($0.001 USDC)
Currency exchange rates (European Central Bank reference rates) for price conversion, invoicing and travel budgets. Latest or historical by date.
Example input: {"base":"USD","symbols":"EUR,JPY"}
Example output: {"source":"European Central Bank via Frankfurter","base":"USD","date":"2026-10-22","rates":{"EUR":0.89246,"JPY":157.05}}

### ip_lookup
GET https://agent-tools.jbarkules.workers.dev/v1/ip/lookup  ($0.002 USDC)
IP address lookup for security triage, log analysis and fraud checks: owning network, allocation range, registry country (RDAP) and reverse DNS.
Example input: {"ip":"1.1.1.1"}
Example output: {"ip":"1.1.1.1","network":"APNIC-LABS","range":"1.1.1.0 - 1.1.1.255","country":"AU","type":"ASSIGNED PORTABLE","reverse_dns":["one.one.one.one."]}


## Other

- Catalog JSON: https://agent-tools.jbarkules.workers.dev/v1/tools
- MCP (streamable HTTP, JSON-RPC): https://agent-tools.jbarkules.workers.dev/mcp

Files and pages are processed in memory and not stored. Failed calls (bad input or upstream error) return JSON {error, code, charged:false} and are not charged.