Mark an essay like an IELTS Writing Task 2 examiner (20 credits or $0.100)
mark_ielts_essayPaste a student essay (60+ words; add the question as prompt). Returns the overall band and the four criterion bands (Task Response, Coherence and Cohesion, Lexical Resource, Grammar) with evidence and one fix each, 3-8 real errors quoted from the essay with corrections, one body paragraph rewritten at band 8, three practice tasks and measured statistics. Feedback language selectable (lang=zh, es, vi, ar, hi, ...). PAID: 20 Iris Credits with a credits key (Authorization: Bearer iris_... header or the key argument; packs from $0.25, buyable with a plain USDC transfer, see payment_options), or $0.100 per call with x402 over MCP (USDC on Base) or MPP over MCP (USDC.e on Tempo). An unpaid call returns the payment terms and charges nothing; bad input is rejected first; failed work is never charged (credits are refunded). Same result as GET /v1/writing/assess.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"essay": "<essay>"
},
"name": "mark_ielts_essay"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | Optional Iris Credits key (iris_ + 48 hex). Better: set it once as the MCP header Authorization: Bearer <key>. Without a key the call is paid with x402 / MPP over MCP. | |
| lang | No | Language of the feedback comments (quotes, fixes and the rewrite stay in English). Default en. | |
| essay | Yes | The essay text, 60+ words, max 4500 characters (POST JSON {"essay": ...} also works). Omit for a demo on the built-in sample essay. | |
| prompt | No | The Task 2 question the essay answers (improves Task Response judging). Optional. |