{
  "service": "Iris Tutor",
  "version": "1.2.0",
  "payment": "x402 v1/v2 (USDC on Base) or MPP tempo charge (USDC.e on Tempo)",
  "paymentsEnabled": true,
  "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.",
  "guidance": "Iris Tutor sells tutoring tools per call, paid with x402 (v1 or v2, USDC on Base) or MPP (WWW-Authenticate: Payment, method tempo, intent charge, pull mode, USDC.e on Tempo; credential in Authorization: Payment). Unpaid requests get HTTP 402 with both challenges. Every route works with no parameters (demo input); GET with query parameters or POST with a JSON body of the same fields.\n1) /v1/writing/assess ($0.10): mark an English essay like an IELTS Writing Task 2 examiner. essay=<text 60+ words>, prompt=<the question> (optional), lang=<feedback language: en, zh, es, vi, ar, hi, ...>. Returns overall band + 4 criterion bands with evidence and one fix each, 3-8 errors quoted from the essay with corrections, one paragraph rewritten at band 8, practice tasks, and measured statistics (words, paragraphs, sentence variety, lexical diversity, academic vocabulary, linking devices, register).\n2) /v1/study/pack ($0.04): topic=<anything to learn>, level=beginner|intermediate|advanced, cards=4-20, questions=3-12, lang=<14 languages>. Returns summary, key points, flashcards, multiple-choice quiz with explanations (balanced answer key), misconceptions, 30-day review plan, Anki TSV, printable worksheet.\n3) /v1/word/daily ($0.01): academic word of the day (hand-written): IPA, CEFR, definition, examples, collocations, word family, synonyms, common mistake, exam tip, 3-question quiz, shareText. date=YYYY-MM-DD or word=<listed word>.\n4) /v1/text/level ($0.005): text=<English text 30+ words>, target=A1..C2 (optional). Returns estimated CEFR band and audience, consensus grade, six readability formulas, vocabulary profile, long sentences, and edits to reach the target level.\n5) Prepaid credits (pay once, use for days): /v1/credits/starter ($0.25 = 60 credits = 3 essay markings, 7 days), /v1/credits/class ($1.00 = 300 credits = 15 essay markings, 30 days) or /v1/credits/term ($5.00 = 1800 credits = 90 essay markings, 90 days). The paid response contains a key; send Authorization: Bearer <key> on routes 1-4 instead of paying each call (costs: assess 20, pack 8, word 2, level 1 credit; 1 credit = $0.005). No x402 client? Buy the same packs with a plain USDC transfer on Base from any wallet: GET /v1/credits/quote?pack=starter&from=<your 0x wallet>, send the exact amount, then GET /v1/credits/claim?quote=<id>&tx=<hash>. Balance: GET /v1/credits/status (same header).\n6) Remote MCP server: POST /mcp (Streamable HTTP, JSON, stateless). Tools mark_ielts_essay, make_study_pack, academic_word_of_the_day, check_text_level (credits key in the MCP header Authorization: Bearer <key>, or x402 / MPP over MCP), buy_credit_pack, and free essay_statistics, payment_options, credits_quote, credits_claim, credits_status.\nInvalid input returns 400 before any payment. Failures are not charged (with credits: refunded).",
  "endpoints": [
    {
      "name": "IELTS Writing Assessment",
      "author": "Iris",
      "kind": "per-call",
      "url": "https://iris-tutor.agent-arena-base.workers.dev/v1/writing/assess",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 0.1,
      "priceAtomic": "100000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "100000",
        "recipient": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13"
      },
      "params": {
        "essay": {
          "type": "string",
          "required": false,
          "description": "The essay text, 60+ words, max 4500 characters (POST JSON {\"essay\": ...} also works). Omit for a demo on the built-in sample essay."
        },
        "prompt": {
          "type": "string",
          "required": false,
          "description": "The Task 2 question the essay answers (improves Task Response judging). Optional."
        },
        "lang": {
          "type": "string",
          "required": false,
          "description": "Language of the feedback comments (quotes, fixes and the rewrite stay in English). Default en.",
          "enum": [
            "en",
            "zh",
            "es",
            "pt",
            "fr",
            "de",
            "ja",
            "ko",
            "vi",
            "ar",
            "hi",
            "id",
            "tr",
            "ru"
          ]
        }
      }
    },
    {
      "name": "Study Pack Generator",
      "author": "Iris",
      "kind": "per-call",
      "url": "https://iris-tutor.agent-arena-base.workers.dev/v1/study/pack",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 0.04,
      "priceAtomic": "40000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "40000",
        "recipient": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13"
      },
      "params": {
        "topic": {
          "type": "string",
          "required": false,
          "description": "What to study, 2-120 characters (e.g. \"the French Revolution\", \"Python list comprehensions\", \"IELTS cohesive devices\"). Default: photosynthesis (demo)."
        },
        "level": {
          "type": "string",
          "required": false,
          "description": "Audience level. Default intermediate.",
          "enum": [
            "beginner",
            "intermediate",
            "advanced"
          ]
        },
        "cards": {
          "type": "integer",
          "required": false,
          "description": "Number of flashcards 4-20, default 10."
        },
        "questions": {
          "type": "integer",
          "required": false,
          "description": "Number of quiz questions 3-12, default 6."
        },
        "lang": {
          "type": "string",
          "required": false,
          "description": "Language of the whole pack. Default en.",
          "enum": [
            "en",
            "zh",
            "es",
            "pt",
            "fr",
            "de",
            "ja",
            "ko",
            "vi",
            "ar",
            "hi",
            "id",
            "tr",
            "ru"
          ]
        }
      }
    },
    {
      "name": "Academic Word of the Day",
      "author": "Iris",
      "kind": "per-call",
      "url": "https://iris-tutor.agent-arena-base.workers.dev/v1/word/daily",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 0.01,
      "priceAtomic": "10000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "10000",
        "recipient": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13"
      },
      "params": {
        "date": {
          "type": "string",
          "required": false,
          "description": "UTC date YYYY-MM-DD (default today). Same date = same word."
        },
        "word": {
          "type": "string",
          "required": false,
          "description": "Look up one word from the 40-word list instead of the date's word (e.g. mitigate, foster, ubiquitous)."
        }
      }
    },
    {
      "name": "Text Level Check",
      "author": "Iris",
      "kind": "per-call",
      "url": "https://iris-tutor.agent-arena-base.workers.dev/v1/text/level",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 0.005,
      "priceAtomic": "5000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "5000",
        "recipient": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13"
      },
      "params": {
        "text": {
          "type": "string",
          "required": false,
          "description": "English text, 30+ words, max 8000 characters (POST JSON {\"text\": ...} also works). Omit for a demo."
        },
        "target": {
          "type": "string",
          "required": false,
          "description": "Optional CEFR level you want the text to be at; the answer then includes edits to get there.",
          "enum": [
            "A1",
            "A2",
            "B1",
            "B2",
            "C1",
            "C2"
          ]
        }
      }
    },
    {
      "name": "Iris Credits: Starter pack",
      "author": "Iris",
      "kind": "prepaid-pack",
      "url": "https://iris-tutor.agent-arena-base.workers.dev/v1/credits/starter",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 0.25,
      "priceAtomic": "250000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "250000",
        "recipient": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13"
      },
      "params": {
        "label": {
          "type": "string",
          "required": false,
          "description": "Optional name for this key (for example a class or student group), shown in /v1/credits/status. Max 60 characters."
        }
      }
    },
    {
      "name": "Iris Credits: Class pack",
      "author": "Iris",
      "kind": "prepaid-pack",
      "url": "https://iris-tutor.agent-arena-base.workers.dev/v1/credits/class",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 1,
      "priceAtomic": "1000000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "1000000",
        "recipient": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13"
      },
      "params": {
        "label": {
          "type": "string",
          "required": false,
          "description": "Optional name for this key (for example a class or student group), shown in /v1/credits/status. Max 60 characters."
        }
      }
    },
    {
      "name": "Iris Credits: Term pack",
      "author": "Iris",
      "kind": "prepaid-pack",
      "url": "https://iris-tutor.agent-arena-base.workers.dev/v1/credits/term",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 5,
      "priceAtomic": "5000000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "5000000",
        "recipient": "0x367e67Aac1Eb07b056D90b6c78e22cAe19B1FE13"
      },
      "params": {
        "label": {
          "type": "string",
          "required": false,
          "description": "Optional name for this key (for example a class or student group), shown in /v1/credits/status. Max 60 characters."
        }
      }
    }
  ]
}