# IteraTools

> Pay-per-use API tools for AI agents. 48 tools across media, data, communication, and automation — from $0.001/call, no subscriptions.

> **⚡ x402-native:** every endpoint accepts x402 micropayments in USDC on Base mainnet. Compatible with `@x402/fetch` and any x402 client — no signup, no API key.
> Discovery manifest: https://iteratools.com/.well-known/x402.json

## Overview

IteraTools (iteratools.com) is an API platform built for AI agents. Instead of subscriptions, you pay per call — most tools cost $0.001–$0.005. All endpoints are at `https://api.iteratools.com`.

**Two ways to pay:**
1. **x402 micropayments** (for agents) — pay in USDC on Base via `X-Payment` header; no account needed
2. **Pre-paid credits** (for humans) — buy credits via Stripe, pass `Authorization: Bearer YOUR_KEY`

- All responses are JSON (except binary outputs like images/audio)
- MCP package available: `npx -y @iteratools/mcp` (add to Claude, Cursor, etc.)

## Featured Premium Tools (x402-listed · Coinbase Agentic.market)

Top 5 premium tools listed on [Coinbase Agentic.market](https://agentic.market), priced in USDC on Base. Pay instantly via `@x402/fetch` — no account needed:

| Tool | Endpoint | Price (USDC) | Use case |
|------|----------|--------------|----------|
| Video Generation (Kling) | `POST /video/generate` | 0.050 | Short video clips from text prompts |
| WhatsApp Messaging | `POST /whatsapp/send` | 0.070 | Outbound WhatsApp template messages (Meta API) |
| Structured Extraction (LLM) | `POST /extract/structured` | 0.010 | Schema-driven JSON extraction from any page |
| Browser Automation | `POST /browser/act` | 0.005 | Multi-step Playwright flows (forms, logins, flows) |
| Code Execution (E2B) | `POST /code_execute` | 0.005 | Sandboxed Python/JS/bash execution |

Agentic.market listing: `https://agentic.market/iteratools`

---

## Tools

### Image Generation

**POST /image/generate** — Generate an image using Flux 1.1 Pro (high quality)
- Price: $0.005/call
- Body: `{ "prompt": "a futuristic city at sunset", "width": 1024, "height": 1024 }`
- Returns: `{ "url": "https://..." }`
- Use when: you need high-quality images for content, products, or creative work

**POST /image/fast** — Generate an image using Flux Schnell (fast, cheaper)
- Price: $0.002/call
- Body: `{ "prompt": "a simple logo for a tech startup" }`
- Returns: `{ "url": "https://..." }`
- Use when: speed matters more than max quality

**POST /image/rembg** — Remove background from an image
- Price: $0.003/call
- Body: `{ "image_url": "https://example.com/photo.jpg" }` or upload as base64
- Returns: `{ "url": "https://..." }` (PNG with transparent background)
- Use when: preparing product photos, avatars, or cutouts

**POST /image/resize** — Resize or crop an image
- Price: $0.001/call
- Body: `{ "image_url": "https://...", "width": 800, "height": 600 }`
- Returns: `{ "url": "https://..." }`

**POST /image/ocr** — Extract text from an image (OCR)
- Price: $0.003/call
- Body: `{ "image_url": "https://example.com/screenshot.png" }`
- Returns: `{ "text": "extracted text content..." }`
- Use when: reading receipts, screenshots, scanned documents

### Video

**POST /video/generate** — Generate a short video (Kling AI)
- Price: $0.05/call
- Body: `{ "prompt": "a cat playing piano", "duration": 5 }`
- Returns: `{ "url": "https://..." }`
- Use when: creating short video clips from text descriptions

**POST /video/frames** — Extract frames from a video
- Price: $0.005/call
- Body: `{ "video_url": "https://...", "fps": 1 }`
- Returns: `{ "frames": ["https://...", "https://..."] }`

### Audio

**POST /tts** — Convert text to speech (Edge TTS, multiple voices)
- Price: $0.001/call
- Body: `{ "text": "Hello, world!", "voice": "pt-BR-AntonioNeural" }`
- Returns: audio file (MP3)
- Voices available: en-US-AriaNeural, pt-BR-AntonioNeural, pt-BR-FranciscaNeural, es-ES-AlvaroNeural, and many more
- Use when: generating voice responses, podcasts, accessibility features

**POST /transcribe** — ⚠️ DEPRECATED — use POST /audio/transcribe instead
- Price: $0.005/call
- Body: `{ "url": "https://..." }`
- Returns: `{ "success": true, "deprecated": true, "successor": "/audio/transcribe", "text": "..." }`
- Note: This endpoint is deprecated and will be removed in a future version. Migrate to POST /audio/transcribe.

**POST /audio/transcribe** — Audio transcription (Whisper, per minute)
- Price: $0.005/call
- Body: `{ "audio_url": "https://..." }`
- Returns: `{ "text": "..." }`

### Web & Scraping

**POST /scrape** — Scrape a webpage (full HTML or cleaned text)
- Price: $0.002/call
- Body: `{ "url": "https://example.com" }`
- Returns: `{ "text": "...", "html": "...", "title": "..." }`
- Use when: extracting content from websites for analysis

**POST /search** — Web search (returns top results)
- Price: $0.001/call
- Body: `{ "query": "best AI tools 2026", "count": 10 }`
- Returns: `{ "results": [{ "title": "...", "url": "...", "snippet": "..." }] }`
- Use when: researching topics, finding current information

**POST /screenshot** — Capture a webpage screenshot
- Price: $0.002/call
- Body: `{ "url": "https://example.com" }`
- Returns: PNG image
- Use when: generating website previews, visual QA

**POST /extract** — Structured web extraction (Readability + schema)
- Price: $0.005/call
- Body: `{ "url": "https://...", "schema": { "title": "string", "price": "number" } }`
- Returns: `{ "data": { "title": "...", "price": 29.99 } }`
- Use when: extracting structured data from product pages, articles

**POST /extract/structured** — Structured data extraction (scrape + LLM)
- Price: $0.010/call
- Body: `{ "url": "https://...", "schema": { "title": "string", "price": "number", "features": "array" }, "instructions": "prices in USD" }`
- Returns: `{ "ok": true, "data": { "title": "...", "price": 29.99, "features": [...] }, "model": "gpt-4o-mini", "tokens": 450 }`
- Use when: extracting specific fields from any webpage using AI (product info, contact details, pricing)

**POST /browser/act** — Browser automation (Playwright actions)
- Price: $0.005/call
- Body: `{ "url": "https://...", "actions": [{ "type": "click", "selector": "#button" }] }`
- Returns: `{ "result": "...", "screenshot": "..." }`
- Use when: automating form fills, multi-step web interactions

### Documents & Text

**POST /pdf/extract** — Extract text from a PDF
- Price: $0.002/call
- Body: `{ "pdf_url": "https://..." }` or upload file
- Returns: `{ "text": "...", "pages": 5 }`
- Use when: reading contracts, research papers, reports

**POST /pdf/generate** — Generate a PDF from HTML or markdown
- Price: $0.003/call
- Body: `{ "html": "<h1>Report</h1><p>Content...</p>" }`
- Returns: PDF file
- Use when: creating invoices, reports, formatted documents

**POST /summarize** — Summarize long text
- Price: $0.002/call
- Body: `{ "text": "long article text...", "max_length": 200 }`
- Returns: `{ "summary": "..." }`

**POST /translate** — Translate text (up to 5000 chars)
- Price: $0.002/call
- Body: `{ "text": "Hello world", "target": "pt", "source": "en" }`
- Returns: `{ "translated": "Olá mundo" }`

**POST /sentiment** — Analyze text sentiment
- Price: $0.001/call
- Body: `{ "text": "This product is amazing!" }`
- Returns: `{ "score": 5, "sentiment": "positive", "comparative": 0.83 }`
- Use when: analyzing reviews, social media monitoring, feedback classification

**POST /text/stats** — Text statistics (word count, reading time, etc.)
- Price: $0.001/call
- Body: `{ "text": "your text here" }`
- Returns: `{ "words": 42, "chars": 215, "reading_time_sec": 10, "sentences": 3 }`

**POST /embeddings** — Generate text embeddings (semantic vectors)
- Price: $0.001/call
- Body: `{ "text": "machine learning for beginners" }`
- Returns: `{ "embedding": [0.02, -0.11, ...] }` (384-dim vector)
- Use when: semantic search, similarity comparison, clustering

**POST /spreadsheet/generate** — Generate xlsx or csv spreadsheet
- Price: $0.003/call
- Body: `{ "format": "xlsx", "data": [["Name", "Age"], ["Alice", 30]] }`
- Returns: spreadsheet file

### Communication

**POST /email/send** — Send an email via SMTP
- Price: $0.001/call
- Body: `{ "to": "user@example.com", "subject": "Hello", "body": "Message content" }`
- Returns: `{ "sent": true }`

**POST /email/validate** — Validate an email address (format + MX check)
- Price: $0.001/call
- Body: `{ "email": "user@example.com" }`
- Returns: `{ "valid": true, "mx": true, "format": true }`

**POST /whatsapp/send** — Send a WhatsApp template message (marketing category)
- Price: $0.07/call (includes Meta fee)
- Body: `{ "to": "+5511999999999", "template": "hello_world", "language": "en_US" }`
- Returns: `{ "message_id": "..." }`
- Use when: sending outbound WhatsApp notifications (requires approved template)

**POST /whatsapp/reply** — Reply to a WhatsApp conversation (within 24h window)
- Price: $0.005/call
- Body: `{ "to": "+5511999999999", "message": "Here's what you asked for!" }`
- Returns: `{ "message_id": "..." }`
- Use when: responding to incoming WhatsApp messages in real time

### Data & Lookups

**GET /weather** — Get weather for any location
- Price: $0.001/call
- Params: `?location=São Paulo, BR`
- Returns: `{ "temp_c": 26, "description": "partly cloudy", "humidity": 65 }`

**GET /crypto/price** — Get cryptocurrency price
- Price: $0.001/call
- Params: `?symbol=BTC&currency=USD`
- Returns: `{ "price": 84250.00, "symbol": "BTC", "currency": "USD" }`

**GET /currency/convert** — Convert between currencies (ECB rates)
- Price: $0.001/call
- Params: `?from=USD&to=BRL&amount=100`
- Returns: `{ "result": 520.50, "rate": 5.205 }`

**GET /ip/geolocation** — Geolocate an IP address
- Price: $0.001/call
- Params: `?ip=8.8.8.8`
- Returns: `{ "country": "US", "city": "Mountain View", "lat": 37.386, "lon": -122.084 }`

**POST /dns/lookup** — DNS lookup (A, AAAA, MX, TXT, CNAME, NS, SOA)
- Price: $0.001/call
- Body: `{ "domain": "example.com", "type": "MX" }`
- Returns: `{ "records": [{ "value": "mail.example.com", "priority": 10 }] }`

**POST /whois** — WHOIS domain lookup
- Price: $0.001/call
- Body: `{ "domain": "iteratools.com" }`
- Returns: `{ "registrar": "...", "created": "2024-01-01", "expires": "2027-01-01" }`

**GET /calendar/holidays** — Public holidays by country
- Price: $0.001/call
- Params: `?country=BR&year=2026`
- Returns: `{ "holidays": [{ "date": "2026-01-01", "name": "New Year's Day" }] }`

### Utilities

**POST /qrcode** — Generate a QR code
- Price: $0.001/call
- Body: `{ "data": "https://iteratools.com", "size": 300 }`
- Returns: PNG image
- Use when: creating shareable links, contact cards, payment QR codes

**POST /url/shorten** — Shorten a URL
- Price: $0.001/call
- Body: `{ "url": "https://example.com/very/long/path?with=params" }`
- Returns: `{ "short_url": "https://..." }`

**POST /chart/generate** — Generate chart image (bar, line, pie, etc.)
- Price: $0.002/call
- Body: `{ "type": "bar", "labels": ["Jan", "Feb", "Mar"], "datasets": [{ "label": "Sales", "data": [100, 200, 150] }] }`
- Returns: PNG image
- Use when: visualizing data in reports, dashboards, social posts

**POST /code_execute** — Execute code in a sandbox (E2B)
- Price: $0.005/call
- Body: `{ "language": "python", "code": "print(sum([1,2,3]))" }`
- Returns: `{ "stdout": "6\n", "stderr": "" }`
- Languages: python, javascript, bash

**POST /hash** — Cryptographic hash generation
- Price: $0.001/call
- Body: `{ "text": "hello world", "algorithm": "sha256" }`
- Returns: `{ "hash": "b94d27...", "algorithm": "sha256", "input_length": 11, "hex": "b94d27...", "base64": "uU0n..." }`
- Algorithms: md5, sha1, sha256 (default), sha384, sha512
- Use when: fingerprinting content, verifying integrity, generating unique identifiers

### Google Sheets

**POST /sheets/read** — Read data from a Google Sheet
- Price: $0.002/call
- Body: `{ "spreadsheet_id": "1BxiMVs...", "range": "Sheet1!A1:C10" }`
- Returns: `{ "values": [["Name", "Score"], ["Alice", "95"]] }`

**POST /sheets/write** — Write data to a Google Sheet
- Price: $0.003/call
- Body: `{ "spreadsheet_id": "1BxiMVs...", "range": "Sheet1!A1", "values": [["Name", "Score"]] }`
- Returns: `{ "updated_cells": 2 }`

**POST /sheets/create** — Create a new Google Sheet
- Price: $0.005/call
- Body: `{ "title": "My Report", "data": [["Col A", "Col B"], [1, 2]] }`
- Returns: `{ "spreadsheet_id": "...", "url": "https://docs.google.com/..." }`

---

## Authentication

All requests require an API key:

```
Authorization: Bearer YOUR_API_KEY
```

Get your key at: https://iteratools.com

---

## Pricing Summary

| Range       | Example tools                              |
|-------------|---------------------------------------------|
| $0.001/call | search, tts, qrcode, weather, sentiment     |
| $0.002/call | scrape, translate, screenshot, chart        |
| $0.003/call | pdf/generate, image/rembg, sheets/write     |
| $0.005/call | image/generate (Flux Pro), transcribe, code |
| $0.007/call | video frames                                |
| $0.050/call | video/generate (Kling)                      |
| $0.070/call | whatsapp/send (includes Meta fee)           |

No monthly fees. No minimums. Pay only for what you use.

---

## MCP Integration

Add IteraTools to Claude, Cursor, or any MCP-compatible host:

```json
{
  "mcpServers": {
    "iteratools": {
      "command": "npx",
      "args": ["-y", "@iteratools/mcp"],
      "env": {
        "ITERATOOLS_API_KEY": "YOUR_KEY"
      }
    }
  }
}
```

npm package: `@iteratools/mcp`

---

## Links

- Website: https://iteratools.com
- API docs: https://iteratools.com/docs
- All tools: https://iteratools.com/tools
- Status: https://iteratools.com/status
- Support: support@iteratools.com