Words in Context

Draw words-in-context vocabulary practice questions from a curated, human-written bank. Use this to quiz a learner, build a practice set, or check what a question of this type looks like. It is free, deterministic, and costs no inference. IMPORTANT: the response deliberately contains NO answer index and NO explanations. That is so you can present the questions without leaking the answers. Call `check_answer` with the item id and the chosen option to get the answer, why it fits, and why each distractor fails. Input: `count` (1-20, default 5) — an out-of-range count is REFUSED rather than clamped, so you learn the limit. `difficulty` is foundation|core|stretch. `theme` is science|humanities|social-science|literature. `seed` makes the draw reproducible: the same seed always returns the same items, so a practice session can be replayed or shared. Format note: these test inference from context, which is how the current digital SAT asks about vocabulary — not recall of definitions. Each item is a sentence with one word blanked and four options.

{
  "type": "object",
  "properties": {
    "count": {
      "description": "How many items, 1-20, default 5. An out-of-range value is refused, not clamped.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "difficulty": {
      "description": "Filter by difficulty.",
      "type": "string",
      "enum": [
        "foundation",
        "core",
        "stretch"
      ]
    },
    "theme": {
      "description": "Filter by passage flavour.",
      "type": "string",
      "enum": [
        "science",
        "humanities",
        "social-science",
        "literature"
      ]
    },
    "seed": {
      "description": "Makes the draw reproducible — the same seed always returns the same items, so a session can be replayed or shared. Omit for a random set.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Check an answer to a practice item and get the teaching content. Returns whether the choice was correct, which option was right, why it fits the sentence specifically, why the chosen option was wrong, and the reason EVERY distractor fails. Read the distractor reasons out to the learner even when they answered correctly. Knowing why the tempting wrong answer was tempting is the part that transfers to the next question; being told "correct" teaches nothing. Input: `id` from a draw response, and `choice` as the zero-based index of the selected option.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The item id from a draw response."
    },
    "choice": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Zero-based index of the chosen option."
    }
  },
  "required": [
    "id",
    "choice"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Generate new practice items from a passage the learner supplies — their own reading, or the material they got wrong. This is the PAID tier and it costs real money per call, unlike the curated bank. Prefer `draw_items` unless the learner specifically needs questions from their own material. `model` is a priced choice: "economy" at $0.002 per item (Fast and cheap. Good enough for straightforward vocabulary in clear prose.); "standard" at $0.008 per item (Better at writing distractors that are genuinely tempting, which is the hard part of a good practice item.). Pick economy for straightforward prose and standard when the distractors need to be genuinely tempting, which is the hard part of a good question. Limits: passage 200 characters minimum, and `count` at most 5 per call. Generation is capped at 10 calls per caller per day, separately from the free quota. Generated items are NOT reviewed by a person. Every response carries a caveat saying so. Check the answer and the distractor reasons before giving them to a learner — a generated question with two defensible answers is worse than no question. Returns 503 when generation is not enabled on the deployment; fall back to `draw_items`.

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "description": "A passage of at least 200 characters. The learner's own reading."
    },
    "count": {
      "description": "How many items, 1-5. Default 3.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "model": {
      "description": "Priced choice. \"economy\" is cheaper; \"standard\" writes more tempting distractors. Default economy.",
      "type": "string",
      "enum": [
        "economy",
        "standard"
      ]
    },
    "difficulty": {
      "description": "Target difficulty.",
      "type": "string",
      "enum": [
        "foundation",
        "core",
        "stretch"
      ]
    }
  },
  "required": [
    "source"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}