IteraTools API Docs

Quick Start

The IteraTools API is available at https://api.iteratools.com. All endpoints accept JSON and return JSON.

🚀 Fastest way to start

Find IteraTools on smithery.ai and add it to your MCP client. Your AI agent can then call tools automatically with zero config.

Or install the Python SDK: pip install iteratools — SDK docs →

Your first call

# Generate an image in one line
curl -X POST https://api.iteratools.com/image/generate \
  -H "Authorization: Bearer it-YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a futuristic city at sunset, photorealistic"}'
bash

{
  "success": true,
  "url": "https://replicate.delivery/...",
  "cost_usd": 0.005,
  "model": "flux-1.1-pro"
}
json

Authentication

IteraTools supports two authentication methods depending on your use case.

API Key — Pre-paid Credits

Buy credits via Stripe (card, no crypto needed) and authenticate with a Bearer token.

1. Create an API key

curl -X POST https://api.iteratools.com/credits/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

# Response: { "api_key": "it-XXXX-XXXX-XXXX", "credits_usd": 0 }
bash

2. Top up credits

curl -X POST https://api.iteratools.com/credits/checkout \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "it-XXXX-XXXX-XXXX",
    "amount_usd": 10,
    "success_url": "https://yourapp.com/success",
    "cancel_url": "https://yourapp.com/cancel"
  }'

# Open checkout_url in browser to pay via card
bash

3. Use tools with Bearer auth

curl -X POST https://api.iteratools.com/search \
  -H "Authorization: Bearer it-XXXX-XXXX-XXXX" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI news"}'
bash

x402 — For AI Agents (Recommended)

The x402 protocol enables automatic micropayments in USDC on Base blockchain — no signup, no credit card.

curl -X POST https://api.iteratools.com/search \
  -H "Content-Type: application/json" \
  -H "X-Payment: <x402-payment-token>" \
  -d '{"query": "latest AI news"}'
bash

Errors

Code	Meaning
200	Success
400	Bad request — missing or invalid parameters
402	Payment required — insufficient credits or x402 flow
429	Rate limit exceeded — slow down
500	Internal server error — try again

All Tools Reference

Tool	Endpoint	Price
🖼️ Image Generate	`POST /image/generate`	$0.005
🖼️ Image Fast	`POST /image/fast`	$0.002
🖼️ Image Describe	`POST /image/describe`	$0.002
🖼️ Image BG Remove	`POST /image/rembg`	$0.005
🖼️ Image OCR	`POST /image/ocr`	$0.002
🎬 Video Generate	`POST /video/generate`	$0.05
🎬 Video Transcribe	`POST /video/transcribe`	$0.003
🧠 Memory Upsert	`POST /memory/upsert`	$0.001
🧠 Memory Search	`POST /memory/search`	$0.001
🧠 Memory Clear	`POST /memory/clear`	$0.001
🤖 AI Chat	`POST /ai/chat`	$0.001–$0.01
💻 Code Execute	`POST /code_execute`	$0.005
🔍 Web Scrape	`POST /scrape`	$0.002
📸 Screenshot	`POST /screenshot`	$0.002
🌐 Web Search	`POST /search`	$0.002
🕷️ Web Crawl	`POST /crawl`	$0.002/page
🖥️ Browser Act	`POST /browser/act`	$0.01
📄 PDF Extract	`POST /pdf/extract`	$0.001
📄 PDF Generate	`POST /pdf/generate`	$0.002
🔊 TTS	`POST /tts`	$0.001
🎙️ Transcribe	`POST /audio/transcribe`	$0.003
💬 WhatsApp Send	`POST /whatsapp/send`	$0.07/conv
📱 SMS Send	`POST /sms/send`	$0.01
💼 Slack Send	`POST /slack/send`	$0.001
💼 Slack Post	`POST /slack/post`	$0.001
💼 Slack React	`POST /slack/react`	$0.001
🐙 GitHub Repo	`GET /github/repo`	$0.001
🐙 GitHub Issue	`POST /github/issue`	$0.001
🐙 GitHub Search	`GET /github/search`	$0.001
🐙 GitHub File	`GET /github/file`	$0.001
📊 Sheets Read	`GET /sheets/read`	$0.001
📊 Sheets Write	`POST /sheets/write`	$0.002
📊 Sheets Append	`POST /sheets/append`	$0.002
📅 Calendar Create	`POST /calendar/event`	$0.002
📅 Calendar List	`POST /calendar/list`	$0.001
📅 Calendar Update	`POST /calendar/update`	$0.002
📅 Calendar Delete	`POST /calendar/delete`	$0.001
🌍 Translate	`POST /translate`	$0.001
🔲 QR Code	`POST /qrcode`	$0.001
📊 Barcode	`POST /barcode`	$0.001
🌤️ Weather	`GET /weather`	$0.001
💱 Currency	`GET /currency/convert`	$0.001
🔍 DNS Lookup	`POST /dns/lookup`	$0.001
#️⃣ Hash	`POST /hash`	$0.001
✍️ Summarize	`POST /summarize`	$0.002
💭 Sentiment	`POST /sentiment`	$0.001
🔢 Embeddings	`POST /embeddings`	$0.001
📈 Chart	`POST /chart/generate`	$0.002
📂 Doc Convert	`POST /document/convert`	$0.005
📋 Spreadsheet	`POST /spreadsheet/read`	$0.002

🖼️ Image Generation

Generate photorealistic images using Flux 1.1 Pro or quick drafts with Flux Schnell.

POST `/image/generate` — $0.005

{
  "prompt": "a dragon flying over a cyberpunk city, 8K, cinematic",
  "width": 1024,
  "height": 1024
}request

{
  "success": true,
  "url": "https://replicate.delivery/...",
  "cost_usd": 0.005,
  "model": "flux-1.1-pro"
}response

POST `/image/fast` — $0.002

Flux Schnell — faster and cheaper draft-quality images.

POST `/image/rembg` — $0.005

{ "image_url": "https://example.com/photo.jpg" }request

{ "url": "https://...transparent.png", "cost_usd": 0.005 }response

POST `/image/ocr` — $0.002

{ "image_url": "https://example.com/screenshot.png" }request

{ "text": "Extracted text from image...", "cost_usd": 0.002 }response

🎬 Video Generation

Generate 5-second cinematic videos from text prompts using Kling v1.6 Pro.

POST `/video/generate` — $0.05

{
  "prompt": "a rocket launching at night, slow motion, dramatic"
}request

{
  "success": true,
  "url": "https://...",
  "cost_usd": 0.05,
  "model": "kling-v1.6-pro"
}response

🤖 AI Chat

Chat completion via multiple AI providers with a single endpoint. Supports OpenAI, Anthropic, and more.

POST `/ai/chat` — $0.001–$0.01

{
  "messages": [
    { "role": "user", "content": "What is the capital of Brazil?" }
  ],
  "model": "gpt-4o-mini"   // gpt-4o, claude-3-haiku, etc.
}request

{
  "success": true,
  "content": "The capital of Brazil is Brasília.",
  "model": "gpt-4o-mini",
  "cost_usd": 0.001
}response

🧠 Memory & RAG

Persistent vector memory for AI agents. Store facts, documents, and context — then retrieve them by semantic similarity across sessions.

POST `/memory/upsert` — $0.001

{
  "namespace": "user-123",   // logical partition
  "key": "fact-1",           // unique document id
  "text": "The meeting is scheduled for Friday at 3pm.",
  "metadata": { "type": "calendar", "date": "2026-03-27" }
}request

{
  "success": true,
  "id": "fact-1",
  "cost_usd": 0.001
}response

POST `/memory/search` — $0.001

{
  "namespace": "user-123",
  "query": "when is the meeting?",
  "limit": 3
}request

{
  "success": true,
  "results": [
    {
      "key": "fact-1",
      "text": "The meeting is scheduled for Friday at 3pm.",
      "score": 0.94,
      "metadata": { "type": "calendar" }
    }
  ],
  "cost_usd": 0.001
}response

POST `/memory/clear` — $0.001

{
  "namespace": "user-123",
  "key": "fact-1"   // omit to clear entire namespace
}request

💻 Code Execution

Execute code in a secure sandbox. Supports Python, JavaScript, Bash and more. Perfect for agents that need to compute, transform data, or run scripts.

POST `/code_execute` — $0.005

{
  "code": "import math\nprint(math.pi * 2)\nprint([x**2 for x in range(5)])",
  "language": "python"   // python, javascript, bash
}request

{
  "success": true,
  "stdout": "6.283185307179586\n[0, 1, 4, 9, 16]\n",
  "stderr": "",
  "exit_code": 0,
  "cost_usd": 0.005
}response

🔍 Web Scraping

Convert any URL to clean Markdown. JavaScript-rendered pages fully supported.

POST `/scrape` — $0.002

{
  "url": "https://example.com/article",
  "render_js": true
}request

{
  "success": true,
  "markdown": "# Article Title\n\nContent here...",
  "title": "Article Title",
  "cost_usd": 0.002
}response

🌐 Web Search

Real-time web search results. Give your agent up-to-date knowledge.

POST `/search` — $0.002

{
  "query": "latest AI news 2026",
  "limit": 5
}request

{
  "results": [
    { "title": "...", "url": "https://...", "snippet": "..." }
  ],
  "cost_usd": 0.002
}response

🖥️ Browser Automation

Run Playwright browser actions against any URL — click, type, scroll, extract. Ideal for complex JS-heavy sites that resist basic scraping.

POST `/browser/act` — $0.01

{
  "url": "https://example.com",
  "actions": [
    { "type": "click", "selector": "button#login" },
    { "type": "type", "selector": "input[name=email]", "text": "user@example.com" },
    { "type": "screenshot" }
  ]
}request

{
  "success": true,
  "screenshot_url": "https://...",
  "html": "<html>...</html>",
  "cost_usd": 0.01
}response

🔊 Text to Speech

Convert text to natural-sounding audio in 50+ languages and voices.

POST `/tts` — $0.001

{
  "text": "Hello, this is a test message.",
  "voice": "en-US-JennyNeural",
  "language": "en-US"
}request

{
  "audio_url": "https://...",
  "duration_seconds": 3.2,
  "cost_usd": 0.001
}response

📄 PDF

Extract text from PDFs or generate PDFs from HTML.

POST `/pdf/extract` — $0.001

{ "pdf_url": "https://example.com/doc.pdf" }request

{ "text": "Extracted text content...", "pages": 5, "cost_usd": 0.001 }response

POST `/pdf/generate` — $0.002

{ "html": "<h1>Invoice</h1><p>Amount: $100</p>" }request

{ "pdf_url": "https://...", "cost_usd": 0.002 }response

💬 WhatsApp

Send WhatsApp messages anywhere in the world via WhatsApp Business API.

POST `/whatsapp/send` — $0.07/conv

{
  "to": "+5511999999999",
  "message": "Hello from your AI agent!"
}request

{
  "success": true,
  "message_id": "wamid....",
  "cost_usd": 0.07
}response

💼 Slack

Send messages and reactions to Slack channels.

POST `/slack/send` — $0.001 (Incoming Webhook)

{
  "webhook_url": "https://hooks.slack.com/services/...",
  "message": "🚀 Deploy succeeded!"
}request

{ "success": true, "cost_usd": 0.001 }response

POST `/slack/post` — $0.001 (Bot Token)

{
  "channel": "#general",
  "message": "Hello from IteraTools!",
  "token": "xoxb-..."
}request

POST `/slack/react` — $0.001

{
  "channel": "C01234567",
  "timestamp": "1234567890.123456",
  "emoji": "rocket",
  "token": "xoxb-..."
}request

📱 SMS

Send SMS messages worldwide.

POST `/sms/send` — $0.01

{
  "to": "+5511999999999",
  "message": "Your verification code is 123456"
}request

{ "success": true, "message_id": "sms_...", "cost_usd": 0.01 }response

🐙 GitHub

Interact with GitHub repositories — read metadata, create issues, search repos, and read files.

GET `/github/repo` — $0.001

GET /github/repo?owner=torvalds&repo=linuxrequest

{
  "name": "linux", "stars": 180000, "forks": 55000,
  "description": "Linux kernel source tree", "language": "C",
  "cost_usd": 0.001
}response

POST `/github/issue` — $0.001

{
  "owner": "myorg", "repo": "myrepo",
  "title": "Bug: login fails on Safari",
  "body": "Steps to reproduce...",
  "labels": ["bug"]
}request

GET `/github/search` — $0.001

GET /github/search?q=langchain+stars:>1000request

GET `/github/file` — $0.001

GET /github/file?owner=openai&repo=openai-python&path=README.mdrequest

📊 Google Sheets

Read and write Google Spreadsheets programmatically. Requires Google OAuth credentials configured in your account.

GET `/sheets/read` — $0.001

GET /sheets/read?spreadsheet_id=1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms&range=Sheet1!A1:D10request

{
  "values": [
    ["Name", "Score", "Date"],
    ["Alice", 95, "2026-03-01"]
  ],
  "cost_usd": 0.001
}response

POST `/sheets/write` — $0.002

{
  "spreadsheet_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
  "range": "Sheet1!A2:C2",
  "values": [["Bob", 88, "2026-03-23"]]
}request

POST `/sheets/append` — $0.002

{
  "spreadsheet_id": "...",
  "range": "Sheet1",
  "values": [["Charlie", 77, "2026-03-23"]]
}request

📅 Google Calendar

Create, list, update, and delete Google Calendar events. Requires Google OAuth credentials.

POST `/calendar/event` — $0.002

{
  "summary": "Team Standup",
  "start": "2026-03-27T10:00:00-03:00",
  "end": "2026-03-27T10:30:00-03:00",
  "attendees": ["alice@example.com"],
  "description": "Weekly sync"
}request

{
  "success": true,
  "event_id": "abc123xyz",
  "html_link": "https://calendar.google.com/...",
  "cost_usd": 0.002
}response

POST `/calendar/list` — $0.001

{ "max_results": 10, "time_min": "2026-03-23T00:00:00Z" }request

POST `/calendar/update` — $0.002

{ "event_id": "abc123xyz", "summary": "Updated title" }request

POST `/calendar/delete` — $0.001

{ "event_id": "abc123xyz" }request

🛠️ Utilities

A collection of handy utilities for common agent tasks.

POST `/translate` — $0.001

{ "text": "Hello, world!", "target_lang": "pt" }request

{ "translated": "Olá, mundo!", "from_lang": "en", "cost_usd": 0.001 }response

POST `/summarize` — $0.002

{ "text": "Long article text here...", "max_sentences": 3 }request

{ "summary": "Concise summary...", "cost_usd": 0.002 }response

POST `/sentiment` — $0.001

{ "text": "This product is absolutely amazing!" }request

{ "sentiment": "positive", "score": 0.97, "cost_usd": 0.001 }response

POST `/embeddings` — $0.001

{ "text": "Sentence to embed", "model": "text-embedding-3-small" }request

{ "embedding": [0.023, -0.14, ...], "dimensions": 1536, "cost_usd": 0.001 }response

POST `/hash` — $0.001

{ "text": "my secret", "algorithm": "sha256" }request

{ "hash": "2bb80d537b1da3e38bd30361aa855686bde0eacd7162fef6a25fe97bf527a25b", "cost_usd": 0.001 }response

POST `/qrcode` — $0.001

{ "data": "https://iteratools.com", "size": 300 }request

{ "url": "https://...qr.png", "cost_usd": 0.001 }response

POST `/barcode` — $0.001

{ "data": "123456789012", "format": "EAN13" }request

POST `/chart/generate` — $0.002

{
  "type": "bar",
  "data": {
    "labels": ["Jan", "Feb", "Mar"],
    "datasets": [{ "label": "Revenue", "data": [1200, 1800, 2400] }]
  }
}request

{ "url": "https://...chart.png", "cost_usd": 0.002 }response

GET `/weather` — $0.001

GET /weather?location=São Paulorequest

{ "temperature_c": 28, "condition": "Partly cloudy", "humidity": 72, "cost_usd": 0.001 }response

GET `/currency/convert` — $0.001

GET /currency/convert?amount=100&from_currency=USD&to_currency=BRLrequest

{ "result": 498.50, "rate": 4.985, "cost_usd": 0.001 }response

POST `/dns/lookup` — $0.001

{ "domain": "iteratools.com", "type": "A" }request

{ "records": ["104.21.45.231"], "ttl": 300, "cost_usd": 0.001 }response

🛡️ Rate Limits & WhatsApp Policies

To protect our shared WhatsApp Business number, the following limits apply.

WhatsApp Send Limits (per API key)

Window	Max Conversations
Per hour	10
Per day	50
Unique numbers / hour	20 (spam detection)

Contact Cooldown

Minimum 48 hours before re-contacting the same number.

WhatsApp Error Codes

HTTP	Error Code	Meaning
429	`number_blocklisted`	Number opted out
429	`cooldown`	Number contacted too recently (<48h)
429	`rate_limit_hour`	Hourly limit reached
429	`rate_limit_day`	Daily limit reached
429	`spam_pattern`	Key suspended (spam detected)
400	`callback_url must be HTTPS`	Invalid callback URL

💡 Use Cases

Explore real-world patterns and agent implementations built with IteraTools.

Use Case	Tools Used
Agent with persistent memory	memory/upsert + memory/search + ai/chat
Research assistant	search + scrape + summarize + memory/upsert
Content pipeline	search + ai/chat + image/generate + tts
GitHub PR reviewer	github/file + ai/chat + github/issue
Spreadsheet automation	sheets/read + ai/chat + sheets/write
Notification agent	memory/search + whatsapp/send + slack/send

🔌 MCP Integration

IteraTools is available as an MCP (Model Context Protocol) server, letting AI agents use all 80+ tools natively.

Quick Start (Local)

npx mcp-iteratoolsbash

Set your API key via environment variable:

export ITERATOOLS_API_KEY=it-YOUR-KEY
npx mcp-iteratoolsbash

Remote Server

URL	`https://mcp.iteratools.com/mcp`
Protocol	StreamableHTTP (MCP 2025-03-26)

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "iteratools": {
      "command": "npx",
      "args": ["mcp-iteratools"],
      "env": {
        "ITERATOOLS_API_KEY": "your-api-key"
      }
    }
  }
}json

OpenClaw Configuration

Add to your openclaw.json mcp section:

{
  "mcp": {
    "servers": {
      "iteratools": {
        "url": "https://mcp.iteratools.com/mcp"
      }
    }
  }
}json

Cursor / Windsurf / Other MCP Clients

Use the remote URL directly:

https://mcp.iteratools.com/mcpurl

Or install locally via npm for stdio transport:

npx mcp-iteratoolsbash

Available Tools

All 80+ IteraTools endpoints are available as MCP tools. Your AI agent can call them directly — image generation, web scraping, TTS, memory, code execution, WhatsApp, and more. See the full list in the tools reference above.

📦 Also available on

Smithery · npm · GitHub · ClawHub

API Documentation

Quick Start

Your first call

Authentication

API Key — Pre-paid Credits

1. Create an API key

2. Top up credits

3. Use tools with Bearer auth

x402 — For AI Agents (Recommended)

Errors

All Tools Reference

🖼️ Image Generation

POST /image/generate — $0.005

POST /image/fast — $0.002

POST /image/rembg — $0.005

POST /image/ocr — $0.002

🎬 Video Generation

POST /video/generate — $0.05

🤖 AI Chat

POST /ai/chat — $0.001–$0.01

🧠 Memory & RAG

POST /memory/upsert — $0.001

POST /memory/search — $0.001

POST /memory/clear — $0.001

💻 Code Execution

POST /code_execute — $0.005

🔍 Web Scraping

POST /scrape — $0.002

🌐 Web Search

POST /search — $0.002

🖥️ Browser Automation

POST /browser/act — $0.01

🔊 Text to Speech

POST /tts — $0.001

📄 PDF

POST /pdf/extract — $0.001

POST /pdf/generate — $0.002

💬 WhatsApp

POST /whatsapp/send — $0.07/conv

💼 Slack

POST /slack/send — $0.001 (Incoming Webhook)

POST /slack/post — $0.001 (Bot Token)

POST /slack/react — $0.001

📱 SMS

POST /sms/send — $0.01

🐙 GitHub

GET /github/repo — $0.001

POST /github/issue — $0.001

GET /github/search — $0.001

GET /github/file — $0.001

📊 Google Sheets

GET /sheets/read — $0.001

POST /sheets/write — $0.002

POST /sheets/append — $0.002

📅 Google Calendar

POST /calendar/event — $0.002

POST /calendar/list — $0.001

POST /calendar/update — $0.002

POST /calendar/delete — $0.001

🛠️ Utilities

POST /translate — $0.001

POST /summarize — $0.002

POST /sentiment — $0.001

POST /embeddings — $0.001

POST /hash — $0.001

POST /qrcode — $0.001

POST /barcode — $0.001

POST /chart/generate — $0.002

GET /weather — $0.001

GET /currency/convert — $0.001

POST /dns/lookup — $0.001

🛡️ Rate Limits & WhatsApp Policies

WhatsApp Send Limits (per API key)

Contact Cooldown

WhatsApp Error Codes

💡 Use Cases

🔌 MCP Integration

Quick Start (Local)

Remote Server

Claude Desktop Configuration

POST `/image/generate` — $0.005

POST `/image/fast` — $0.002

POST `/image/rembg` — $0.005

POST `/image/ocr` — $0.002

POST `/video/generate` — $0.05

POST `/ai/chat` — $0.001–$0.01

POST `/memory/upsert` — $0.001

POST `/memory/search` — $0.001

POST `/memory/clear` — $0.001

POST `/code_execute` — $0.005

POST `/scrape` — $0.002

POST `/search` — $0.002

POST `/browser/act` — $0.01

POST `/tts` — $0.001

POST `/pdf/extract` — $0.001

POST `/pdf/generate` — $0.002

POST `/whatsapp/send` — $0.07/conv

POST `/slack/send` — $0.001 (Incoming Webhook)

POST `/slack/post` — $0.001 (Bot Token)

POST `/slack/react` — $0.001

POST `/sms/send` — $0.01

GET `/github/repo` — $0.001

POST `/github/issue` — $0.001

GET `/github/search` — $0.001

GET `/github/file` — $0.001

GET `/sheets/read` — $0.001

POST `/sheets/write` — $0.002

POST `/sheets/append` — $0.002

POST `/calendar/event` — $0.002

POST `/calendar/list` — $0.001

POST `/calendar/update` — $0.002

POST `/calendar/delete` — $0.001

POST `/translate` — $0.001

POST `/summarize` — $0.002

POST `/sentiment` — $0.001

POST `/embeddings` — $0.001

POST `/hash` — $0.001

POST `/qrcode` — $0.001

POST `/barcode` — $0.001

POST `/chart/generate` — $0.002

GET `/weather` — $0.001

GET `/currency/convert` — $0.001

POST `/dns/lookup` — $0.001