ClassMarker MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.23.5更新于 Nov 8, 2026

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

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流数据与分析

概览

AI 生成的概览

托管的 ClassMarker 服务器,让助手列出群组、链接和考试,分页读取近期测验结果,并管理题库分类、题目和访问码。

可以做什么
  • 列出该 API 密钥可访问的群组、链接和考试,并给出其他工具所需的 id
  • 按完成时间分页读取群组、链接或单个群组考试、链接考试的近期已完成结果
  • 列出题库分类和题目,并按 id 获取单道题目
  • 创建和重命名父分类与分类,创建题目或整体替换已有题目
  • 向链接的访问码列表添加访问码
  • 查看当月用量、提交缺失功能请求,以及升级或取消付费方案
适用场景
适合在 ClassMarker 中管理在线测验时使用:让助手汇总近期结果以便审阅,或在不逐页操作网页的情况下维护题库和访问码。
运行要求
远程 streamable HTTP 端点,无需本地安装。通过 OAuth 使用你自己的 ClassMarker 凭据登录,因此只填服务器地址,不要添加 Authorization 头或 API 密钥。免费方案每月 50 次工具调用,付费方案提高上限。ClassMarker 本身对底层 API 限制为每个 API 密钥每小时 30 次请求。
安装前请注意
结果类工具会返回应试者姓名、邮箱、IP 地址和访问码等个人数据,请使用较小的分页并谨慎处理输出。写入类工具会添加访问码、创建或覆盖分类和题目;更新工具会整体替换记录,应先读取。付费方案需通过结账链接付款,取消后当期不退款。你的 ClassMarker 凭据和测验数据会经过第三方托管方。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ClassMarker MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fclassmarker/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "classmarker-by-usefulapi": {
      "type": "http",
      "url": "https://classmarker.usefulapi.io/mcp"
    }
  }
}

README

ClassMarker MCP by usefulapi

Use ClassMarker from Claude, Cursor, or any MCP client — groups, links, exams, recent results, categories and the question bank, plus access codes. Hosted, no local install: connect with your own ClassMarker credentials.

Live endpoint: https://classmarker.usefulapi.io/mcp · Homepage: https://usefulapi.io/classmarker

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://classmarker.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http classmarker https://classmarker.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "classmarker": {      "url": "https://classmarker.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your ClassMarker credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/classmarker/

Tools

ToolTypeWhat it does
classmarker_list_groups_links_examsreadList groups, links and exams
classmarker_recent_group_resultsreadRecent results across all groups
classmarker_recent_link_resultsreadRecent results across all links
classmarker_recent_group_exam_resultsreadRecent results for one group exam
classmarker_recent_link_exam_resultsreadRecent results for one link exam
classmarker_list_categoriesreadList question categories
classmarker_list_questionsreadList question-bank questions
classmarker_get_questionreadGet a question
classmarker_add_access_codeswriteAdd access codes to a list
classmarker_create_parent_categorywriteCreate a parent category
classmarker_update_parent_categorywriteRename a parent category
classmarker_create_categorywriteCreate a category
classmarker_update_categorywriteUpdate a category
classmarker_create_questionwriteCreate a question
classmarker_update_questionwriteUpdate a question
classmarker_usage_statusmetaUsage status (free-tier meter)
classmarker_request_featuremetaRequest a missing feature
classmarker_upgrademetaUpgrade to Pro or Pro+
classmarker_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with classmarker_upgrade (it returns a Stripe Checkout link). Cancel any time with classmarker_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running classmarker_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by ClassMarker.

来源:servers/classmarker/README.md,提交 4046075

工具

15

classmarker_recent_group_results

Recent results across all groups

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.

输入参数limitinclude_monitor_eventsfinished_after_timestamp

classmarker_recent_group_exam_results

Recent results for one group exam

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.

输入参数limittest_id必填group_id必填include_monitor_eventsfinished_after_timestamp

classmarker_list_categories

List question 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.

无需输入参数。

classmarker_list_questions

List question-bank 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.

输入参数page

classmarker_get_question

Get a 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.

输入参数question_id必填

classmarker_add_access_codes

Add access codes to a list

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.

输入参数codes必填access_list_id必填

classmarker_create_parent_category

Create a 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.

输入参数parent_category_name必填

classmarker_update_parent_category

Rename a 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.

输入参数parent_category_id必填parent_category_name必填

classmarker_create_category

Create a 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.

输入参数category_name必填parent_category_id必填

classmarker_update_category

Update a 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.

输入参数category_id必填category_name必填parent_category_id必填

classmarker_create_question

Create a 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.

输入参数pointsoptionsquestion必填category_idgrade_stylequestion_type必填random_answerscorrect_optionscorrect_feedbackincorrect_feedback

classmarker_update_question

Update a 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.

输入参数pointsoptionsquestion必填category_idgrade_stylequestion_id必填question_type必填random_answerscorrect_optionscorrect_feedbackincorrect_feedback

版本历史

20
  1. v1.23.5最新Nov 8, 2026
  2. v1.23.4Nov 7, 2026
  3. v1.22.3Nov 5, 2026
  4. v1.22.2Nov 5, 2026
  5. v1.22.1Nov 4, 2026
  6. v1.22.0Nov 3, 2026
  7. v1.21.1Nov 3, 2026
  8. v1.20.0Nov 1, 2026
  9. v1.18.0Oct 31, 2026
  10. v1.17.0Oct 31, 2026
  11. v1.16.2Oct 30, 2026
  12. v1.16.0Oct 30, 2026
  13. v1.11.0Oct 26, 2026
  14. v1.8.3Oct 25, 2026
  15. v1.8.0Oct 25, 2026
  16. v1.7.0Oct 24, 2026
  17. v1.4.0Oct 23, 2026
  18. v1.3.4Oct 22, 2026
  19. v1.3.3Oct 21, 2026
  20. v1.0.0Oct 12, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成