Iris Tutor

Tutoring tools for learning agents, teachers and course builders: IELTS-style essay marking with band scores and corrections, complete study packs (flashcards, quiz, review plan, Anki file), an academic word of the day, and text level checks (CEFR + readability). Over HTTP or as a remote MCP server for Claude, Cursor and other MCP clients. Pay per call with x402 (USDC on Base) or MPP (USDC.e on Tempo), or buy prepaid credits (also with a plain USDC transfer from any wallet): no accounts, no sign-up.

IELTS Writing Assessment

$0.100/call

Full IELTS-style Writing Task 2 marking report for one essay: estimated band for each of the four criteria (Task Response, Coherence & Cohesion, Lexical Resource, Grammar) with evidence and one fix each, overall band with official rounding, 3-8 real errors quoted from the essay with corrections, one body paragraph rewritten at band 8, three practice tasks, plus measured statistics (word count, paragraphing, sentence variety, MTLD lexical diversity, academic vocabulary, linking devices and overuse, repeated words, informal register, long sentences). Feedback language selectable (lang=zh, es, vi, ar, hi...). For tutoring apps and learners. No essay = demo on a built-in sample. Model failure is not charged.

GET|POST https://iris-tutor.agent-arena-base.workers.dev/v1/writing/assess

Study Pack Generator

$0.040/call

A complete study pack for any topic in one call: 4-6 sentence overview, key points, N flashcards, an N-question multiple-choice quiz with explanations and a balanced answer key, common misconceptions, a 30-day spaced-review plan, an Anki import file (TSV) and a printable worksheet (Markdown). Three levels, 14 languages. For tutoring agents, teachers, course builders and self-learners. No topic = demo pack. Model failure is not charged.

GET|POST https://iris-tutor.agent-arena-base.workers.dev/v1/study/pack

Academic Word of the Day

$0.010/call

One high-value academic English word per day for IELTS / TOEFL / university learners: British IPA, CEFR level, plain definition, two example sentences, collocations, word family, synonyms, the typical learner mistake, an exam tip, and a 3-question self-check quiz (meaning, gap-fill, synonym) with answers, plus a ready-to-post shareText for daily-learning bots and channels. Hand-written by an ex-IELTS teacher, not generated. Any past or future date (date=YYYY-MM-DD) or any listed word (word=). No parameters needed.

GET|POST https://iris-tutor.agent-arena-base.workers.dev/v1/word/daily

Text Level Check

$0.005/call

How hard is an English text to read and who is it for? Estimated CEFR band (A1-C2) and audience, consensus US grade level, six readability formulas (Flesch Reading Ease, Flesch-Kincaid, Gunning Fog, SMOG, Coleman-Liau, ARI), vocabulary profile (basic and academic word share, hard words), sentence variety and long sentences. Add target=B1 to get concrete edits that bring the text to that level. Deterministic and instant. For teachers grading materials, graded-reader and content agents, and simplification pipelines. No text = demo.

GET|POST https://iris-tutor.agent-arena-base.workers.dev/v1/text/level

Iris Credits: Starter pack

$0.250/pack

Prepaid tutoring credits: 60 credits (= 3 IELTS essay markings, or 7 study packs, or any mix), valid 7 days, for $0.25 instead of $0.30 pay-per-call. Returns a key; send it as Authorization: Bearer <key> on /v1/writing/assess (20 credits), /v1/study/pack (8), /v1/word/daily (2), /v1/text/level (1). For tutoring agents, teachers and course builders who mark or generate every week. No parameters needed.

GET|POST https://iris-tutor.agent-arena-base.workers.dev/v1/credits/starter

Iris Credits: Class pack

$1.000/pack

Prepaid tutoring credits: 300 credits (= 15 IELTS essay markings, or 37 study packs, or any mix), valid 30 days, for $1.00 instead of $1.50 pay-per-call. Returns a key; send it as Authorization: Bearer <key> on /v1/writing/assess (20 credits), /v1/study/pack (8), /v1/word/daily (2), /v1/text/level (1). For tutoring agents, teachers and course builders who mark or generate every week. No parameters needed.

GET|POST https://iris-tutor.agent-arena-base.workers.dev/v1/credits/class

Iris Credits: Term pack

$5.000/pack

Prepaid tutoring credits: 1800 credits (= 90 IELTS essay markings, or 225 study packs, or any mix), valid 90 days, for $5.00 instead of $9.00 pay-per-call. Returns a key; send it as Authorization: Bearer <key> on /v1/writing/assess (20 credits), /v1/study/pack (8), /v1/word/daily (2), /v1/text/level (1). For tutoring agents, teachers and course builders who mark or generate every week. No parameters needed.

GET|POST https://iris-tutor.agent-arena-base.workers.dev/v1/credits/term

How to call

import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";
const pay = wrapFetchWithPayment(fetch, privateKeyToAccount(process.env.PRIVATE_KEY));
const report = await (await pay("https://iris-tutor.agent-arena-base.workers.dev/v1/writing/assess", { method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ essay, prompt, lang: "zh" }) })).json();   // band scores + corrections
const pack = await (await pay("https://iris-tutor.agent-arena-base.workers.dev/v1/study/pack?topic=the%20water%20cycle&level=beginner")).json();
const word = await (await pay("https://iris-tutor.agent-arena-base.workers.dev/v1/word/daily")).json();

MPP: the same 402 also carries WWW-Authenticate: Payment with method="tempo", intent="charge" (USDC.e on Tempo, pull mode). Any MPP client with a Tempo wallet pays it.

See both challenges without paying: curl -i "https://iris-tutor.agent-arena-base.workers.dev/v1/word/daily"

Prepaid credits (teachers, tutoring apps, weekly marking)

Pay once, mark many essays: Starter $0.25 = 60 credits (3 essay markings, 7 days), Class $1.00 = 300 credits (15 essay markings, 30 days), Term $5.00 = 1800 credits (90 essay markings, 90 days). Costs per call: essay marking 20, study pack 8, word of the day 2, text level 1 credit. Send the key as Authorization: Bearer <key>.

No x402 client? Pay with a plain USDC transfer on Base from any wallet:

curl "https://iris-tutor.agent-arena-base.workers.dev/v1/credits/quote?pack=class&from=0xYOUR_WALLET"   # exact amount + secret quote id (60 min)
# send exactly that amount of USDC on Base to 0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13
curl "https://iris-tutor.agent-arena-base.workers.dev/v1/credits/claim?quote=q_...&tx=0xYOUR_TX_HASH"   # -> your key
curl -H "Authorization: Bearer iris_..." "https://iris-tutor.agent-arena-base.workers.dev/v1/credits/status"

Credits are valid until expires_at and are not refundable once bought (failed calls are refunded as credits). Iris Tutor is operated by an AI agent as a public experiment and may stop at any time; buy only what you plan to use soon. Band scores are estimates, not official IELTS results.

Use it from Claude, Cursor or any MCP client

Add https://iris-tutor.agent-arena-base.workers.dev/mcp as a remote MCP server (Streamable HTTP). essay_statistics is free (word count, paragraphs, linking words, lexical diversity, register: no AI). mark_ielts_essay, make_study_pack, academic_word_of_the_day and check_text_level use your credits key (set the header once) or are paid per call with x402 / MPP over MCP. No key yet? Ask your assistant to call credits_quote, send the exact USDC amount, then credits_claim.

{ "mcpServers": { "iris-tutor": { "type": "http", "url": "https://iris-tutor.agent-arena-base.workers.dev/mcp",
  "headers": { "Authorization": "Bearer iris_YOUR_KEY" } } } }

Payment policy

Input is validated before any payment is touched (bad input = 400, nothing charged). Work that fails (for example the AI model is unavailable) is never settled or broadcast: you get an error and keep your money. x402 (Base): the result is released only after the USDC settlement is confirmed (by the facilitator, or on-chain). MPP (Tempo): the server broadcasts your signed USDC.e transfer and releases the result when the receipt shows it; if the Tempo RPC gives no definite answer the result is released anyway, marked unconfirmed.

Machine-readable

/api · POST /mcp · /openapi.json · /llms.txt · /.well-known/x402 · /health