ClassMarker MCP by usefulapi

Server Details

Read ClassMarker groups, links, exams and recent results; manage question bank and access codes.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.

Status: Healthy
Last Tested: 2026-10-12 02:14
Transport: Streamable HTTP · MCP 2025-06-18
URL
Repository: m190/usefulapi-mcp
GitHub Stars: 0

TDQS

Score is being calculated.

Available Tools

15 tools

classmarker_add_access_codesAdd access codes to a listInspect

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.

ParametersJSON Schema

Name	Required	Description	Default
`codes`	Yes	1-100 access codes to add.
`access_list_id`	Yes	The access list id (links[].access_list_id).

classmarker_create_categoryCreate a categoryInspect

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.

ParametersJSON Schema

Name	Required	Description	Default
`category_name`	Yes	Name of the new category.
`parent_category_id`	Yes	The parent category id (from classmarker_list_categories).

classmarker_create_parent_categoryCreate a parent categoryInspect

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.

ParametersJSON Schema

Name	Required	Description	Default
`parent_category_name`	Yes	Name of the new parent category.

classmarker_create_questionCreate a questionInspect

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.

ParametersJSON Schema

Name	Required	Description
`points`	No	Points for a correct answer (for an essay: the maximum score).
`options`	No	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`	Yes	The question text.
`category_id`	No	Category id (from classmarker_list_categories).
`grade_style`	No	multipleresponse only: partial credit with or without deduction, or off (all-or-nothing).
`question_type`	Yes	multiplechoice (one correct option), multipleresponse (one or more), truefalse, or essay (graded by hand). Free text, grammar and matching cannot be written.
`random_answers`	No	Shuffle the order of the options for each test-taker (multiplechoice / multipleresponse).
`correct_options`	No	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`	No	Feedback shown for a correct answer.
`incorrect_feedback`	No	Feedback shown for an incorrect answer.

classmarker_get_questionGet a question

Read-only

Inspect

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.

ParametersJSON Schema

Name	Required	Description	Default
`question_id`	Yes	The question id.

classmarker_list_categoriesList question categories

Read-only

Inspect

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.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

classmarker_list_groups_links_examsList groups, links and exams

Read-only

Inspect

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.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

classmarker_list_questionsList question-bank questions

Read-only

Inspect

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.

ParametersJSON Schema

Name	Required	Description	Default
`page`	No	Page number, 1-based (default 1).

classmarker_recent_group_exam_resultsRecent results for one group exam

Read-only

Inspect

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.

ParametersJSON Schema

Name	Required	Description
`limit`	No	Results per request, 1-200 (default 25; ClassMarker's own default is 200).
`test_id`	Yes	The exam (test) id.
`group_id`	Yes	The group id.
`include_monitor_events`	No	Include each result's detailed monitor_events.events list (default false: only the counts).
`finished_after_timestamp`	No	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.

classmarker_recent_group_resultsRecent results across all groups

Read-only

Inspect

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.

ParametersJSON Schema

Name	Required	Description
`limit`	No	Results per request, 1-200 (default 25; ClassMarker's own default is 200).
`include_monitor_events`	No	Include each result's detailed monitor_events.events list (default false: only the counts).
`finished_after_timestamp`	No	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.

classmarker_recent_link_exam_resultsRecent results for one link exam

Read-only

Inspect

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.

ParametersJSON Schema

Name	Required	Description
`limit`	No	Results per request, 1-200 (default 25; ClassMarker's own default is 200).
`link_id`	Yes	The link id.
`test_id`	Yes	The exam (test) id.
`include_monitor_events`	No	Include each result's detailed monitor_events.events list (default false: only the counts).
`finished_after_timestamp`	No	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.

classmarker_recent_link_resultsRecent results across all links

Read-only

Inspect

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.

ParametersJSON Schema

Name	Required	Description
`limit`	No	Results per request, 1-200 (default 25; ClassMarker's own default is 200).
`include_monitor_events`	No	Include each result's detailed monitor_events.events list (default false: only the counts).
`finished_after_timestamp`	No	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.

classmarker_update_categoryUpdate a category

DestructiveIdempotent

Inspect

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.

ParametersJSON Schema

Name	Required	Description
`category_id`	Yes	The category id (from classmarker_list_categories).
`category_name`	Yes	The category's name (new or unchanged).
`parent_category_id`	Yes	The parent category id (new or unchanged).

classmarker_update_parent_categoryRename a parent category

DestructiveIdempotent

Inspect

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.

ParametersJSON Schema

Name	Required	Description	Default
`parent_category_id`	Yes	The parent category id (from classmarker_list_categories).
`parent_category_name`	Yes	The new name.

classmarker_update_questionUpdate a question

DestructiveIdempotent

Inspect

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.

ParametersJSON Schema

Name	Required	Description
`points`	No	Points for a correct answer (for an essay: the maximum score).
`options`	No	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`	Yes	The question text.
`category_id`	No	Category id (from classmarker_list_categories).
`grade_style`	No	multipleresponse only: partial credit with or without deduction, or off (all-or-nothing).
`question_id`	Yes	The question id (from classmarker_list_questions).
`question_type`	Yes	multiplechoice (one correct option), multipleresponse (one or more), truefalse, or essay (graded by hand). Free text, grammar and matching cannot be written.
`random_answers`	No	Shuffle the order of the options for each test-taker (multiplechoice / multipleresponse).
`correct_options`	No	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`	No	Feedback shown for a correct answer.
`incorrect_feedback`	No	Feedback shown for an incorrect answer.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

15 tool updatesOct 11, 2026
- First observedclassmarker_add_access_codes
- First observedclassmarker_create_category
- First observedclassmarker_create_parent_category
- First observedclassmarker_create_question
- First observedclassmarker_get_question
- First observedclassmarker_list_categories
- First observedclassmarker_list_groups_links_exams
- First observedclassmarker_list_questions
- First observedclassmarker_recent_group_exam_results
- First observedclassmarker_recent_group_results
- First observedclassmarker_recent_link_exam_results
- First observedclassmarker_recent_link_results
- First observedclassmarker_update_category
- First observedclassmarker_update_parent_category
- First observedclassmarker_update_question

Related MCP Connectors

Formbricks MCP by usefulapi A
io.usefulapi
Read survey responses and manage contacts, webhooks, teams and organisation users.
Product Management Research & Data
171
Accredible MCP by usefulapi
io.usefulapi
Read Accredible credentials, groups, designs, analytics, skills; issue one credential as a draft.
191
Aircall MCP by usefulapi A
io.usefulapi
Read calls, contacts, users, teams and numbers; tag calls and create or update contacts.
Communication CRM Customer Support
251
Mailchimp MCP by usefulapi A
io.usefulapi
Read audiences, members, campaigns and reports; add, update, tag and archive subscribers.
Email Marketing
181

Related MCP Servers

google-classroom-mcp
Education & Learning Tools Workplace & Productivity
praisethefacts
A
license
A
quality
B
maintenance
Gives MCP-capable agents read-only access to a Google Classroom account, exposing courses, coursework, due dates, announcements, rosters and student submissions as callable tools. Nothing can be created, edited or deleted through it.
Updated 6 days ago (2026-10-06 10:01 UTC)
8
MIT
librus-mcp
Education & Learning Tools
TechAdrianPro
F
license
A
quality
C
maintenance
Enables read-only access to a Librus Portal account, letting users list linked Synergia accounts and retrieve grades, attendance, timetable, homework, notices, and school information.
Updated 2 months ago (2026-08-23 11:30 UTC)
3
-
Moodle Student MCP
Education & Learning Tools Databases
tcpassos
F
license
A
quality
D
maintenance
Enables read-only querying of Moodle as a student, including courses, assignments, grades, forums, and files, using a personal web services token.
Updated 4 months ago (2026-06-08 02:44 UTC)
11
-
moodle-cli
Education & Learning Tools Calendar Management Communication
TaoZhaoyu
A
license
Not graded
quality
C
maintenance
Enables read-only Moodle access through MCP for querying courses, content, assignments, grades, forums, discussions, submissions, and calendar events, while supporting multiple profiles and local ICS export.
Updated 12 days ago (2026-09-29 14:33 UTC)
268 npm
MIT

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Server Details

TDQS

Available Tools

Tool Schema Changelog

Related MCP Connectors

Related MCP Servers

google-classroom-mcp

librus-mcp

Moodle Student MCP

moodle-cli

Glama MCP Gateway

Resources