KeenIELTS MCP

Search real student IELTS Writing answers scored by AI examiner. Args: task: IELTS Writing task number — 1 (reports/letters) or 2 (essays). band: whole band to filter on; matches half-bands too (8 -> 8.0-8.5). query: free-text match against the question/prompt. limit: max results (1-50). Each result links to a full page with the question, the student's answer, and criterion-by-criterion examiner feedback. Use get_model_answer for the full content, or compare_question to see the same prompt at other bands.

{
  "type": "object",
  "title": "search_model_answersArguments",
  "properties": {
    "band": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Band",
      "default": null
    },
    "task": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Task",
      "default": null
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Query",
      "default": null
    }
  }
}

Get one student IELTS Writing answer in full: the question, the essay, and the AI examiner's band scores + feedback on all four official IELTS marking criteria (Task Achievement, Coherence & Cohesion, Lexical Resource, Grammatical Range & Accuracy). Get section_id/attempt_id pairs from search_model_answers or compare_question.

{
  "type": "object",
  "title": "get_model_answerArguments",
  "required": [
    "section_id",
    "attempt_id"
  ],
  "properties": {
    "attempt_id": {
      "type": "integer",
      "title": "Attempt Id"
    },
    "section_id": {
      "type": "integer",
      "title": "Section Id"
    }
  }
}

List every public band-scored answer to ONE IELTS Writing question — the same prompt answered by different students at different band scores, useful for showing what separates a Band 6 from a Band 8 on identical input. Fetch individual answers with get_model_answer.

{
  "type": "object",
  "title": "compare_questionArguments",
  "required": [
    "section_id"
  ],
  "properties": {
    "section_id": {
      "type": "integer",
      "title": "Section Id"
    }
  }
}

List short, targeted IELTS practice drills that can be taken right here in the conversation (fetch with get_drill, grade with check_drill_answers). Args: skill: 'listening' or 'reading'. category: optional IELTS question-type filter. Listening: completion, multiple-choice, matching, labelling. Reading: true-false-not-given, completion, matching-headings, matching-information, multiple-choice-short-answer.

{
  "type": "object",
  "title": "list_drillsArguments",
  "required": [
    "skill"
  ],
  "properties": {
    "skill": {
      "type": "string",
      "title": "Skill"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Category",
      "default": null
    }
  }
}

Get one drill's content so the user can attempt it in conversation. The questions are markdown; `{{3}}` marks a gap the user fills for question 3, and `{{3:A/B/C}}` means question 3 is a choice between the slash-separated options. For listening drills, give the user the audio link to play before answering. Collect the user's answers, then call check_drill_answers to grade them — do NOT guess at or reveal correct answers yourself; they are only returned by check_drill_answers.

{
  "type": "object",
  "title": "get_drillArguments",
  "required": [
    "skill",
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "title": "Slug"
    },
    "skill": {
      "type": "string",
      "title": "Skill"
    }
  }
}

Grade a user's drill answers server-side (same grader the website uses — case/whitespace tolerant, accepts standard IELTS answer variants). Args: skill: 'listening' or 'reading'. slug: the drill slug from get_drill. answers: question number -> the user's answer, e.g. {"1": "true", "2": "B", "3": "24 April"}. Returns per-question results with the accepted answers and explanations (safe to share with the user now that they have answered), plus a score.

{
  "type": "object",
  "title": "check_drill_answersArguments",
  "required": [
    "skill",
    "slug",
    "answers"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "title": "Slug"
    },
    "skill": {
      "type": "string",
      "title": "Skill"
    },
    "answers": {
      "type": "object",
      "title": "Answers",
      "additionalProperties": {
        "type": "string"
      }
    }
  }
}

Catalog of full-length IELTS practice tests on keenielts.com — books, difficulty, and test counts for all four skills (Listening, Reading, Writing, Speaking). Full tests are taken on the website (timed, with audio players and AI band scoring), not in this conversation — point the user at the URLs. Taking tests and getting AI band scores is free.

{
  "type": "object",
  "title": "list_practice_testsArguments",
  "properties": {}
}

Search KeenIELTS: real student IELTS Writing model answers with band scores, Listening/Reading practice drills, and IELTS practice resources. Returns result ids for use with fetch.

{
  "type": "object",
  "title": "searchArguments",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "title": "Query"
    }
  }
}

Fetch the full content of a KeenIELTS search result by id: a model answer with examiner feedback, a practice drill, a question compared across band scores, or a site page.

{
  "type": "object",
  "title": "fetchArguments",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "title": "Id"
    }
  }
}