ClassMarker MCP by usefulapi is an MCP server published by io.usefulapi, hosted at classmarker.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 15 tools, including classmarker_list_groups_links_exams, classmarker_recent_group_results, classmarker_recent_link_results, classmarker_recent_group_exam_results, classmarker_recent_link_exam_results.
Read ClassMarker groups, links, exams and recent results; manage question bank and access codes.
4,023 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the groups, links and exams (tests) this API key can access, with the ids the other tools need (group_id, link_id, link_url_id, test_id, and access_list_id for links with an access-code list). Good first call. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1.json.
No parameters.
{
"name": "classmarker_list_groups_links_exams",
"title": "List groups, links and exams",
"description": "List the groups, links and exams (tests) this API key can access, with the ids the other tools need (group_id, link_id, link_url_id, test_id, and access_list_id for links with an access-code list). Good first call. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List groups, links and exams",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Recent finished test results taken in the key's groups (all groups, all exams), oldest first, PAGED by finish time: test-taker name, email, score, percentage, pass/fail, timing, certificate. Contains personal data: use small pages. Max look-back 3 months. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/groups/recent_results.json.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per request, 1-200 (default 25; ClassMarker's own default is 200). |
| include_monitor_events | boolean | Include each result's detailed monitor_events.events list (default false: only the counts). |
| finished_after_timestamp | integer | UNIX time in SECONDS: only results finished after this are returned (oldest first). Default: 14 days ago. Maximum look-back is 3 months. To page, pass next_finished_after_timestamp from the previous reply. |
{
"name": "classmarker_recent_group_results",
"title": "Recent results across all groups",
"description": "Recent finished test results taken in the key's groups (all groups, all exams), oldest first, PAGED by finish time: test-taker name, email, score, percentage, pass/fail, timing, certificate. Contains personal data: use small pages. Max look-back 3 months. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/groups/recent_results.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per request, 1-200 (default 25; ClassMarker's own default is 200)."
},
"include_monitor_events": {
"type": "boolean",
"description": "Include each result's detailed monitor_events.events list (default false: only the counts)."
},
"finished_after_timestamp": {
"type": "integer",
"maximum": 9007199254740991,
"description": "UNIX time in SECONDS: only results finished after this are returned (oldest first). Default: 14 days ago. Maximum look-back is 3 months. To page, pass next_finished_after_timestamp from the previous reply.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Recent results across all groups",
"readOnlyHint": true
}
}Recent finished test results taken through the key's links (all links, all exams), oldest first, PAGED by finish time: test-taker name, email, score, pass/fail, timing, access code, extra tracking fields, IP address, certificate. Contains personal data: use small pages. Max look-back 3 months. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/links/recent_results.json.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per request, 1-200 (default 25; ClassMarker's own default is 200). |
| include_monitor_events | boolean | Include each result's detailed monitor_events.events list (default false: only the counts). |
| finished_after_timestamp | integer | UNIX time in SECONDS: only results finished after this are returned (oldest first). Default: 14 days ago. Maximum look-back is 3 months. To page, pass next_finished_after_timestamp from the previous reply. |
{
"name": "classmarker_recent_link_results",
"title": "Recent results across all links",
"description": "Recent finished test results taken through the key's links (all links, all exams), oldest first, PAGED by finish time: test-taker name, email, score, pass/fail, timing, access code, extra tracking fields, IP address, certificate. Contains personal data: use small pages. Max look-back 3 months. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/links/recent_results.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per request, 1-200 (default 25; ClassMarker's own default is 200)."
},
"include_monitor_events": {
"type": "boolean",
"description": "Include each result's detailed monitor_events.events list (default false: only the counts)."
},
"finished_after_timestamp": {
"type": "integer",
"maximum": 9007199254740991,
"description": "UNIX time in SECONDS: only results finished after this are returned (oldest first). Default: 14 days ago. Maximum look-back is 3 months. To page, pass next_finished_after_timestamp from the previous reply.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Recent results across all links",
"readOnlyHint": true
}
}Recent finished results for ONE exam in ONE group (ids from classmarker_list_groups_links_exams), oldest first, PAGED by finish time. Contains personal data: use small pages. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/groups/{group_id}/tests/{test_id}/recent_results.json.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per request, 1-200 (default 25; ClassMarker's own default is 200). |
| test_id * | integer | The exam (test) id. |
| group_id * | integer | The group id. |
| include_monitor_events | boolean | Include each result's detailed monitor_events.events list (default false: only the counts). |
| finished_after_timestamp | integer | UNIX time in SECONDS: only results finished after this are returned (oldest first). Default: 14 days ago. Maximum look-back is 3 months. To page, pass next_finished_after_timestamp from the previous reply. |
{
"name": "classmarker_recent_group_exam_results",
"title": "Recent results for one group exam",
"description": "Recent finished results for ONE exam in ONE group (ids from classmarker_list_groups_links_exams), oldest first, PAGED by finish time. Contains personal data: use small pages. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/groups/{group_id}/tests/{test_id}/recent_results.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"group_id",
"test_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per request, 1-200 (default 25; ClassMarker's own default is 200)."
},
"test_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The exam (test) id.",
"exclusiveMinimum": 0
},
"group_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The group id.",
"exclusiveMinimum": 0
},
"include_monitor_events": {
"type": "boolean",
"description": "Include each result's detailed monitor_events.events list (default false: only the counts)."
},
"finished_after_timestamp": {
"type": "integer",
"maximum": 9007199254740991,
"description": "UNIX time in SECONDS: only results finished after this are returned (oldest first). Default: 14 days ago. Maximum look-back is 3 months. To page, pass next_finished_after_timestamp from the previous reply.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Recent results for one group exam",
"readOnlyHint": true
}
}Recent finished results for the exam of ONE link (ids from classmarker_list_groups_links_exams), oldest first, PAGED by finish time. Contains personal data: use small pages. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/links/{link_id}/tests/{test_id}/recent_results.json.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per request, 1-200 (default 25; ClassMarker's own default is 200). |
| link_id * | integer | The link id. |
| test_id * | integer | The exam (test) id. |
| include_monitor_events | boolean | Include each result's detailed monitor_events.events list (default false: only the counts). |
| finished_after_timestamp | integer | UNIX time in SECONDS: only results finished after this are returned (oldest first). Default: 14 days ago. Maximum look-back is 3 months. To page, pass next_finished_after_timestamp from the previous reply. |
{
"name": "classmarker_recent_link_exam_results",
"title": "Recent results for one link exam",
"description": "Recent finished results for the exam of ONE link (ids from classmarker_list_groups_links_exams), oldest first, PAGED by finish time. Contains personal data: use small pages. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/links/{link_id}/tests/{test_id}/recent_results.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"link_id",
"test_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per request, 1-200 (default 25; ClassMarker's own default is 200)."
},
"link_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The link id.",
"exclusiveMinimum": 0
},
"test_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The exam (test) id.",
"exclusiveMinimum": 0
},
"include_monitor_events": {
"type": "boolean",
"description": "Include each result's detailed monitor_events.events list (default false: only the counts)."
},
"finished_after_timestamp": {
"type": "integer",
"maximum": 9007199254740991,
"description": "UNIX time in SECONDS: only results finished after this are returned (oldest first). Default: 14 days ago. Maximum look-back is 3 months. To page, pass next_finished_after_timestamp from the previous reply.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Recent results for one link exam",
"readOnlyHint": true
}
}List the question-bank categories with their parent categories and ids (needed for creating and updating questions). Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/categories.json.
No parameters.
{
"name": "classmarker_list_categories",
"title": "List question categories",
"description": "List the question-bank categories with their parent categories and ids (needed for creating and updating questions). Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/categories.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List question categories",
"readOnlyHint": true
}
}List the questions of the question bank, 200 per page (page 1, 2, ...): question text, type, category, points, options, correct options, status. A full page means more may follow, so ask for the next page. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/questions.json?page=N.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-based (default 1). |
{
"name": "classmarker_list_questions",
"title": "List question-bank questions",
"description": "List the questions of the question bank, 200 per page (page 1, 2, ...): question text, type, category, points, options, correct options, status. A full page means more may follow, so ask for the next page. Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/questions.json?page=N.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Page number, 1-based (default 1)."
}
}
},
"annotations": {
"title": "List question-bank questions",
"readOnlyHint": true
}
}Get one question-bank question by id (ids from classmarker_list_questions). Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/questions/{question_id}.json.
| Parameter | Type | Description |
|---|---|---|
| question_id * | integer | The question id. |
{
"name": "classmarker_get_question",
"title": "Get a question",
"description": "Get one question-bank question by id (ids from classmarker_list_questions). Counts as one of ClassMarker's 30 requests per hour per API key. API: GET /v1/questions/{question_id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"question_id"
],
"properties": {
"question_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The question id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a question",
"readOnlyHint": true
}
}WRITE: add access codes (1-100 per call, up to 255 characters each; a list holds at most 20,000) to a link's access-code list, so those people can start the exam. The access_list_id comes from classmarker_list_groups_links_exams (links[].access_list_id). Only adds; removing codes is not offered. Does not count against the 30 requests per hour limit. API: POST /v1/accesslists/{access_list_id}.json.
| Parameter | Type | Description |
|---|---|---|
| codes * | array | 1-100 access codes to add. |
| access_list_id * | integer | The access list id (links[].access_list_id). |
{
"name": "classmarker_add_access_codes",
"title": "Add access codes to a list",
"description": "WRITE: add access codes (1-100 per call, up to 255 characters each; a list holds at most 20,000) to a link's access-code list, so those people can start the exam. The access_list_id comes from classmarker_list_groups_links_exams (links[].access_list_id). Only adds; removing codes is not offered. Does not count against the 30 requests per hour limit. API: POST /v1/accesslists/{access_list_id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"access_list_id",
"codes"
],
"properties": {
"codes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "1-100 access codes to add."
},
"access_list_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The access list id (links[].access_list_id).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Add access codes to a list",
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: create a new top-level question category. Returns its parent_category_id. Counts as one of ClassMarker's 30 requests per hour per API key. API: POST /v1/categories/parent_category.json.
| Parameter | Type | Description |
|---|---|---|
| parent_category_name * | string | Name of the new parent category. |
{
"name": "classmarker_create_parent_category",
"title": "Create a parent category",
"description": "WRITE: create a new top-level question category. Returns its parent_category_id. Counts as one of ClassMarker's 30 requests per hour per API key. API: POST /v1/categories/parent_category.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parent_category_name"
],
"properties": {
"parent_category_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Name of the new parent category."
}
}
},
"annotations": {
"title": "Create a parent category",
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: rename an existing parent category (overwrites its name). Counts as one of ClassMarker's 30 requests per hour per API key. API: PUT /v1/categories/parent_category/{parent_category_id}.json.
| Parameter | Type | Description |
|---|---|---|
| parent_category_id * | integer | The parent category id (from classmarker_list_categories). |
| parent_category_name * | string | The new name. |
{
"name": "classmarker_update_parent_category",
"title": "Rename a parent category",
"description": "WRITE: rename an existing parent category (overwrites its name). Counts as one of ClassMarker's 30 requests per hour per API key. API: PUT /v1/categories/parent_category/{parent_category_id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parent_category_id",
"parent_category_name"
],
"properties": {
"parent_category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The parent category id (from classmarker_list_categories).",
"exclusiveMinimum": 0
},
"parent_category_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "The new name."
}
}
},
"annotations": {
"title": "Rename a parent category",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: create a question category under a parent category. Returns its category_id. Counts as one of ClassMarker's 30 requests per hour per API key. API: POST /v1/categories/category.json.
| Parameter | Type | Description |
|---|---|---|
| category_name * | string | Name of the new category. |
| parent_category_id * | integer | The parent category id (from classmarker_list_categories). |
{
"name": "classmarker_create_category",
"title": "Create a category",
"description": "WRITE: create a question category under a parent category. Returns its category_id. Counts as one of ClassMarker's 30 requests per hour per API key. API: POST /v1/categories/category.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category_name",
"parent_category_id"
],
"properties": {
"category_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Name of the new category."
},
"parent_category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The parent category id (from classmarker_list_categories).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create a category",
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: rename a category and/or move it to another parent (overwrites both fields: send the name and parent_category_id you want it to have). Counts as one of ClassMarker's 30 requests per hour per API key. API: PUT /v1/categories/category/{category_id}.json.
| Parameter | Type | Description |
|---|---|---|
| category_id * | integer | The category id (from classmarker_list_categories). |
| category_name * | string | The category's name (new or unchanged). |
| parent_category_id * | integer | The parent category id (new or unchanged). |
{
"name": "classmarker_update_category",
"title": "Update a category",
"description": "WRITE: rename a category and/or move it to another parent (overwrites both fields: send the name and parent_category_id you want it to have). Counts as one of ClassMarker's 30 requests per hour per API key. API: PUT /v1/categories/category/{category_id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category_id",
"category_name",
"parent_category_id"
],
"properties": {
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The category id (from classmarker_list_categories).",
"exclusiveMinimum": 0
},
"category_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "The category's name (new or unchanged)."
},
"parent_category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The parent category id (new or unchanged).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update a category",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: add a new question to the question bank. Only multiplechoice, multipleresponse, truefalse and essay can be created. Returns the new question_id. For truefalse, give only correct_options ["A"] (True) or ["B"] (False). Counts as one of ClassMarker's 30 requests per hour per API key. API: POST /v1/questions.json.
| Parameter | Type | Description |
|---|---|---|
| points | number | Points for a correct answer (for an essay: the maximum score). |
| options | object | Answer options keyed by letter A-J (up to 10), e.g. {"A": "Apply oil", "B": "Soak in water"}. Needed for multiplechoice and multipleresponse; not allowed for truefalse and essay. |
| question * | string | The question text. |
| category_id | integer | Category id (from classmarker_list_categories). |
| grade_style | string | multipleresponse only: partial credit with or without deduction, or off (all-or-nothing). |
| question_type * | string | multiplechoice (one correct option), multipleresponse (one or more), truefalse, or essay (graded by hand). Free text, grammar and matching cannot be written. |
| random_answers | boolean | Shuffle the order of the options for each test-taker (multiplechoice / multipleresponse). |
| correct_options | array | Letters of the correct options, e.g. ["C"]. multiplechoice: exactly one; multipleresponse: one or more; truefalse: ["A"] (True) or ["B"] (False); not allowed for essay. |
| correct_feedback | string | Feedback shown for a correct answer. |
| incorrect_feedback | string | Feedback shown for an incorrect answer. |
{
"name": "classmarker_create_question",
"title": "Create a question",
"description": "WRITE: add a new question to the question bank. Only multiplechoice, multipleresponse, truefalse and essay can be created. Returns the new question_id. For truefalse, give only correct_options [\"A\"] (True) or [\"B\"] (False). Counts as one of ClassMarker's 30 requests per hour per API key. API: POST /v1/questions.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"question_type",
"question"
],
"properties": {
"points": {
"type": "number",
"maximum": 1000,
"minimum": 0,
"description": "Points for a correct answer (for an essay: the maximum score)."
},
"options": {
"type": "object",
"description": "Answer options keyed by letter A-J (up to 10), e.g. {\"A\": \"Apply oil\", \"B\": \"Soak in water\"}. Needed for multiplechoice and multipleresponse; not allowed for truefalse and essay.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string",
"maxLength": 5000,
"minLength": 1
}
},
"question": {
"type": "string",
"maxLength": 10000,
"minLength": 1,
"description": "The question text."
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Category id (from classmarker_list_categories).",
"exclusiveMinimum": 0
},
"grade_style": {
"enum": [
"partial_with_deduction",
"partial_without_deduction",
"off"
],
"type": "string",
"description": "multipleresponse only: partial credit with or without deduction, or off (all-or-nothing)."
},
"question_type": {
"enum": [
"multiplechoice",
"multipleresponse",
"truefalse",
"essay"
],
"type": "string",
"description": "multiplechoice (one correct option), multipleresponse (one or more), truefalse, or essay (graded by hand). Free text, grammar and matching cannot be written."
},
"random_answers": {
"type": "boolean",
"description": "Shuffle the order of the options for each test-taker (multiplechoice / multipleresponse)."
},
"correct_options": {
"type": "array",
"items": {
"type": "string"
},
"description": "Letters of the correct options, e.g. [\"C\"]. multiplechoice: exactly one; multipleresponse: one or more; truefalse: [\"A\"] (True) or [\"B\"] (False); not allowed for essay."
},
"correct_feedback": {
"type": "string",
"maxLength": 5000,
"description": "Feedback shown for a correct answer."
},
"incorrect_feedback": {
"type": "string",
"maxLength": 5000,
"description": "Feedback shown for an incorrect answer."
}
}
},
"annotations": {
"title": "Create a question",
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE (overwrites): replace an existing question-bank question. Send the COMPLETE question (type, text, options, correct options, points, feedback), not only the changed fields; read it first with classmarker_get_question. Only multiplechoice, multipleresponse, truefalse and essay questions can be updated. Counts as one of ClassMarker's 30 requests per hour per API key. API: PUT /v1/questions/{question_id}.json.
| Parameter | Type | Description |
|---|---|---|
| points | number | Points for a correct answer (for an essay: the maximum score). |
| options | object | Answer options keyed by letter A-J (up to 10), e.g. {"A": "Apply oil", "B": "Soak in water"}. Needed for multiplechoice and multipleresponse; not allowed for truefalse and essay. |
| question * | string | The question text. |
| category_id | integer | Category id (from classmarker_list_categories). |
| grade_style | string | multipleresponse only: partial credit with or without deduction, or off (all-or-nothing). |
| question_id * | integer | The question id (from classmarker_list_questions). |
| question_type * | string | multiplechoice (one correct option), multipleresponse (one or more), truefalse, or essay (graded by hand). Free text, grammar and matching cannot be written. |
| random_answers | boolean | Shuffle the order of the options for each test-taker (multiplechoice / multipleresponse). |
| correct_options | array | Letters of the correct options, e.g. ["C"]. multiplechoice: exactly one; multipleresponse: one or more; truefalse: ["A"] (True) or ["B"] (False); not allowed for essay. |
| correct_feedback | string | Feedback shown for a correct answer. |
| incorrect_feedback | string | Feedback shown for an incorrect answer. |
{
"name": "classmarker_update_question",
"title": "Update a question",
"description": "WRITE (overwrites): replace an existing question-bank question. Send the COMPLETE question (type, text, options, correct options, points, feedback), not only the changed fields; read it first with classmarker_get_question. Only multiplechoice, multipleresponse, truefalse and essay questions can be updated. Counts as one of ClassMarker's 30 requests per hour per API key. API: PUT /v1/questions/{question_id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"question_id",
"question_type",
"question"
],
"properties": {
"points": {
"type": "number",
"maximum": 1000,
"minimum": 0,
"description": "Points for a correct answer (for an essay: the maximum score)."
},
"options": {
"type": "object",
"description": "Answer options keyed by letter A-J (up to 10), e.g. {\"A\": \"Apply oil\", \"B\": \"Soak in water\"}. Needed for multiplechoice and multipleresponse; not allowed for truefalse and essay.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string",
"maxLength": 5000,
"minLength": 1
}
},
"question": {
"type": "string",
"maxLength": 10000,
"minLength": 1,
"description": "The question text."
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Category id (from classmarker_list_categories).",
"exclusiveMinimum": 0
},
"grade_style": {
"enum": [
"partial_with_deduction",
"partial_without_deduction",
"off"
],
"type": "string",
"description": "multipleresponse only: partial credit with or without deduction, or off (all-or-nothing)."
},
"question_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The question id (from classmarker_list_questions).",
"exclusiveMinimum": 0
},
"question_type": {
"enum": [
"multiplechoice",
"multipleresponse",
"truefalse",
"essay"
],
"type": "string",
"description": "multiplechoice (one correct option), multipleresponse (one or more), truefalse, or essay (graded by hand). Free text, grammar and matching cannot be written."
},
"random_answers": {
"type": "boolean",
"description": "Shuffle the order of the options for each test-taker (multiplechoice / multipleresponse)."
},
"correct_options": {
"type": "array",
"items": {
"type": "string"
},
"description": "Letters of the correct options, e.g. [\"C\"]. multiplechoice: exactly one; multipleresponse: one or more; truefalse: [\"A\"] (True) or [\"B\"] (False); not allowed for essay."
},
"correct_feedback": {
"type": "string",
"maxLength": 5000,
"description": "Feedback shown for a correct answer."
},
"incorrect_feedback": {
"type": "string",
"maxLength": 5000,
"description": "Feedback shown for an incorrect answer."
}
}
},
"annotations": {
"title": "Update a question",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for ClassMarker, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Show test results from my groups that were finished in the past week."; "Which groups, links and exams do I have set up for online tests?"; "What questions are currently in my question bank, first page?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes ClassMarker data. Free plan: 50 tool calls per month. Run classmarker_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run classmarker_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run classmarker_upgrade without a plan: it returns both plans, each with a payment link for the user to open. classmarker_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.