ictexam-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ICTEXAM_EMAIL | Yes | A teacher or admin account email | |
| ICTEXAM_BASE_URL | Yes | The base URL of your ICTExam site, e.g. https://app.ictlms.net (without trailing /api) | |
| ICTEXAM_PASSWORD | Yes | Password for that account | |
| ICTEXAM_API_PREFIX | No | API mount path; set empty to hit the backend port directly | /api |
| ICTEXAM_TIMEOUT_MS | No | Per-request timeout in milliseconds (AI parsing can be slow) | 60000 |
| ICTEXAM_TLS_INSECURE | No | Skip TLS verification — self-signed test servers only | false |
| ICTEXAM_MCP_ALLOW_WRITE | No | Unlock the write tools. Set to 'true' to enable write tools. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ictexam_list_examsA | List exam papers (assessments) on ICTExam: id, title, status (draft/published), class and subject. Start here to find an exam's id. Optionally filter by class_id or subject_id. |
| ictexam_get_examA | Get a single exam paper by id: its settings, timing, share links and questions. |
| ictexam_list_classesA | List the classes (course groups) defined on ICTExam. |
| ictexam_list_subjectsA | List the subjects on ICTExam, each tied to a class. |
| ictexam_gradebookA | Get the teacher gradebook: per-exam totals and student marks. Optionally filter by class_id or subject_id. |
| ictexam_item_analysisA | Per-question item analysis for one exam: difficulty, p-value, average mark and how many responses were full vs zero credit. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool targets a distinct entity or artifact: subjects, classes, exams, exam detail, gradebook, and item analysis. There is no pair that would plausibly produce the same result, so an agent can reliably choose based on the desired resource.
All tools share the consistent ictexam_ prefix, and most use a clear verb_noun pattern (list_subjects, list_exams, list_classes, get_exam). However, gradebook and item_analysis are plain noun phrases, breaking the imperative verb pattern.
Six tools is a compact and well-scoped set for an exam data and analytics MCP. Each tool covers a meaningful query surface, and none feels redundant or unnecessary.
The set covers the core read-only workflows: enumerating classes, subjects, and exams; retrieving an exam; viewing gradebook data; and running item analysis. It lacks create/update/delete operations, but those appear outside the apparent analysis-oriented purpose.