check_read_aloud

Use when a student has read a Read Aloud passage aloud and you have the transcript of what they said (for example from voice mode) but no audio. Compares the words said against the passage: omitted, inserted and substituted words and a word-accuracy percentage. CONTENT ONLY — pronunciation, fluency and prosody need a recording: offer speak_practice or the answer link for those.

read-only

Argument	Type	Description
questionId*	string	The questionId returned by speak_practice or practice_question for a Read Aloud passage.
transcript*	string	What the student said, as text.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "questionId",
    "transcript"
  ],
  "properties": {
    "questionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The questionId returned by speak_practice or practice_question for a Read Aloud passage."
    },
    "transcript": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 1,
      "description": "What the student said, as text."
    }
  }
}

exam_overview

Use this when a student asks what an English exam contains, how a task type is scored, how long a section is, what the score scale is, or where to start preparing. Returns the exam sections with task types, question counts and time limits, the writing and speaking scoring criteria (writing with word limits), and links to ScoreFluent guides. Do not use this to score or mark a student's answer; it only describes the exam.

read-only

Argument	Type	Description
exam*	string	Exam id, e.g. "pte", "toefl", "ielts", "languagecert_academic".
taskType	string	Optional task-type slug (e.g. "write-essay") to narrow the answer to one task.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "exam"
  ],
  "properties": {
    "exam": {
      "enum": [
        "pte",
        "languagecert_academic",
        "toefl",
        "met",
        "celpip",
        "ielts",
        "ielts_general",
        "c1_advanced",
        "pte_core"
      ],
      "type": "string",
      "description": "Exam id, e.g. \"pte\", \"toefl\", \"ielts\", \"languagecert_academic\"."
    },
    "taskType": {
      "type": "string",
      "description": "Optional task-type slug (e.g. \"write-essay\") to narrow the answer to one task."
    }
  }
}

practice_question

Use this when a student wants a real practice question for an English exam task, for example "give me a PTE Write Essay prompt" or "a TOEFL listening question". Returns one random published question (prompt, passage, options, word limit, and an audio link for listening tasks) and a link where the student can answer it with the real timer and scoring. It never returns answers or model responses. Do not use it to check an answer; it only serves questions. For PTE Read Aloud or Describe Image, use speak_practice instead: it serves the question with a recorder so the student can answer and be scored in the chat.

read-only

Argument	Type	Description
exam	string	Exam id. Defaults to "pte".
taskType*	string	Task-type slug, e.g. "write-essay" or "listening-mcq-single". Call exam_overview to list the valid slugs.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "taskType"
  ],
  "properties": {
    "exam": {
      "enum": [
        "pte",
        "languagecert_academic",
        "toefl",
        "met",
        "celpip",
        "ielts",
        "ielts_general",
        "c1_advanced",
        "pte_core"
      ],
      "type": "string",
      "default": "pte",
      "description": "Exam id. Defaults to \"pte\"."
    },
    "taskType": {
      "type": "string",
      "description": "Task-type slug, e.g. \"write-essay\" or \"listening-mcq-single\". Call exam_overview to list the valid slugs."
    }
  }
}

recorder_confirm

Confirm the upload and queue it for scoring. Called by the speaking recorder card only.

Argument	Type	Description
attemptId*	string
deviceToken*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "attemptId",
    "deviceToken"
  ],
  "properties": {
    "attemptId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "deviceToken": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  }
}

recorder_result

Read the scoring status and scores for a recording. Called by the speaking recorder card only.

read-only

Argument	Type	Description
attemptId*	string
deviceToken*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "attemptId",
    "deviceToken"
  ],
  "properties": {
    "attemptId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "deviceToken": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  }
}

recorder_start

Reserve a recording slot and get an upload URL. Called by the speaking recorder card only.

Argument	Type	Description
mimeType*	string
questionId*	string
deviceToken*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "deviceToken",
    "questionId",
    "mimeType"
  ],
  "properties": {
    "mimeType": {
      "enum": [
        "audio/webm",
        "audio/mp4",
        "audio/m4a",
        "audio/aac"
      ],
      "type": "string"
    },
    "questionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "deviceToken": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  }
}

score_writing

Use this when a student pastes an essay or summary for a PTE, IELTS, TOEFL, LanguageCert, MET or CELPIP writing task and wants a score. Returns marks out of the exam task maximum, a score and one line of feedback for each marking criterion, and the top improvements. Pass the questionId from practice_question when the text answers one of our questions; otherwise pass the prompt the student wrote to. Pass exactly one of the two. Free up to a daily limit. This is the quick score: Personalised Tips on the site add sentence-level annotations and verified marks. When the student is signed in to ScoreFluent and the text answers one of our questions, the scored attempt is saved to their History.

Argument	Type	Description
exam*	string	Exam id, e.g. "pte" or "toefl".
text*	string	The student's essay or summary, exactly as they wrote it.
prompt	string	The prompt the student wrote to, when the text does not answer one of our questions.
taskType*	string	Writing task-type slug, e.g. "write-essay" or "summarize-written-text". Call exam_overview to list the valid slugs.
questionId	string	The questionId returned by practice_question, when the text answers one of our questions.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "exam",
    "taskType",
    "text"
  ],
  "properties": {
    "exam": {
      "enum": [
        "pte",
        "languagecert_academic",
        "toefl",
        "met",
        "celpip",
        "ielts",
        "ielts_general",
        "c1_advanced",
        "pte_core"
      ],
      "type": "string",
      "description": "Exam id, e.g. \"pte\" or \"toefl\"."
    },
    "text": {
      "type": "string",
      "maxLength": 5000,
      "minLength": 20,
      "description": "The student's essay or summary, exactly as they wrote it."
    },
    "prompt": {
      "type": "string",
      "maxLength": 1500,
      "description": "The prompt the student wrote to, when the text does not answer one of our questions."
    },
    "taskType": {
      "type": "string",
      "description": "Writing task-type slug, e.g. \"write-essay\" or \"summarize-written-text\". Call exam_overview to list the valid slugs."
    },
    "questionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The questionId returned by practice_question, when the text answers one of our questions."
    }
  }
}

speak_practice

Use whenever a student asks for a PTE Read Aloud or Describe Image to practise, even without mentioning recording or scores. Lets them practise the speaking task and get pronunciation and fluency scores. Shows a recorder card; desktop web only today. Do not use for scoring text.

read-only

Argument	Type	Description
exam	string	Exam id. Defaults to "pte".
taskType	string	"read-aloud" or "describe-image". Defaults to "read-aloud".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "exam": {
      "enum": [
        "pte",
        "languagecert_academic",
        "toefl",
        "met",
        "celpip",
        "ielts",
        "ielts_general",
        "c1_advanced",
        "pte_core"
      ],
      "type": "string",
      "default": "pte",
      "description": "Exam id. Defaults to \"pte\"."
    },
    "taskType": {
      "enum": [
        "read-aloud",
        "describe-image"
      ],
      "type": "string",
      "default": "read-aloud",
      "description": "\"read-aloud\" or \"describe-image\". Defaults to \"read-aloud\"."
    }
  }
}

start_diagnostic

Use when a student does not know which exam to take (diagnostic) or knows the exam and wants a starting baseline (placement). Returns a link to a free test on the site; do not try to run the test in chat.

read-only

Argument	Type	Description
exam	string	Exam id when the student already knows it, e.g. "pte". Omit when they are not sure which exam to take.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "exam": {
      "enum": [
        "pte",
        "languagecert_academic",
        "toefl",
        "met",
        "celpip",
        "ielts",
        "ielts_general",
        "c1_advanced",
        "pte_core"
      ],
      "type": "string",
      "description": "Exam id when the student already knows it, e.g. \"pte\". Omit when they are not sure which exam to take."
    }
  }
}

ScoreFluent

Registry entry

Try it

check_read_aloud Read-only

ScoreFluent

Registry entry

Try it

check_read_aloud Read-only

Install

Tools (9)

Security checkA100/100