The server marks this tool read-only

classmarker_add_access_codes

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.

Argument	Type	Description
codes*	array	1-100 access codes to add.
access_list_id*	integer	The access list id (links[].access_list_id).

Input schema (JSON)

{
  "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
    }
  }
}

classmarker_create_category

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.

Argument	Type	Description
category_name*	string	Name of the new category.
parent_category_id*	integer	The parent category id (from classmarker_list_categories).

Input schema (JSON)

{
  "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
    }
  }
}

classmarker_create_parent_category

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.

Argument	Type	Description
parent_category_name*	string	Name of the new parent category.

Input schema (JSON)

{
  "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."
    }
  }
}

classmarker_create_question

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.

Argument	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).

classmarker_get_question

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.

read-only

Argument	Type	Description
question_id*	integer	The question id.

Input schema (JSON)

{
  "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
    }
  }
}

classmarker_list_categories

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

classmarker_list_groups_links_exams

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

classmarker_list_questions

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.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).

Input schema (JSON)

{
  "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)."
    }
  }
}

classmarker_recent_group_exam_results

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
    }
  }
}

classmarker_recent_group_results

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
    }
  }
}

classmarker_recent_link_exam_results

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
    }
  }
}

classmarker_recent_link_results

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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
    }
  }
}

classmarker_update_category

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.

destructive

Argument	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).

Input schema (JSON)

{
  "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
    }
  }
}

classmarker_update_parent_category

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.

destructive

Argument	Type	Description
parent_category_id*	integer	The parent category id (from classmarker_list_categories).
parent_category_name*	string	The new name.

Input schema (JSON)

{
  "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."
    }
  }
}

classmarker_update_question

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.

destructive

Argument	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*

ClassMarker MCP by usefulapi

Try it

classmarker_add_access_codes

ClassMarker MCP by usefulapi

Try it

classmarker_add_access_codes

Tools (15)