ictexam-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ictexam-mcp Show me the item analysis for the last chemistry exam."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ictexam-mcp
A Model Context Protocol server for ICTExam, the AI exam authoring, delivery and auto-grading platform from ICT Innovations.
It lets an AI assistant read your exams, gradebooks and per-question item analysis, and — only when you turn writes on — parse a question paper into a structured exam with AI and publish exams to students.
Install
Run it straight from npm with npx, or install it globally:
npx -y ictexam-mcp # no install
npm install -g ictexam-mcpRequires Node.js 18 or newer.
Related MCP server: Octopus Deploy Official MCP Server
Configure
Set these in your MCP client's server config (or a .env):
Variable | Required | Default | |
| yes | Your site, e.g. | |
| yes | A teacher or admin account | |
| yes | Password for that account | |
| no |
| API mount path; set empty to hit the backend port directly |
| no |
| Unlock the write tools (see Safety) |
| no |
| Per-request timeout (AI parsing can be slow) |
| no |
| Skip TLS verification — self-signed test servers only |
Claude Desktop example
{
"mcpServers": {
"ictexam": {
"command": "npx",
"args": ["-y", "ictexam-mcp"],
"env": {
"ICTEXAM_BASE_URL": "https://app.ictlms.net",
"ICTEXAM_EMAIL": "teacher@example.com",
"ICTEXAM_PASSWORD": "your-password"
}
}
}
}Tools
Read tools are always available:
Tool | What it does |
| List exam papers (id, title, status, class, subject) |
| One paper's settings, share links and questions |
| Classes (course groups) |
| Subjects, each tied to a class |
| Per-exam totals and student marks |
| Per-question difficulty, p-value and average mark |
Write tools appear only when ICTEXAM_MCP_ALLOW_WRITE=true:
Tool | What it does |
| Upload a local PDF/DOCX and AI-extract the questions |
| Publish a paper; returns student and teacher share URLs |
| Set a paper back to draft |
Safety
The server is read-only by default. The three write tools are not registered
at all unless you set ICTEXAM_MCP_ALLOW_WRITE=true, so a default install cannot
change anything on the platform. Parsing a paper spends AI credit on the server,
and publishing makes an exam live for students — both sit behind that switch on
purpose. The client authenticates with the account's own session cookie and
echoes the CSRF token on writes, exactly as the web app does; it never stores or
logs your password beyond the environment you give it.
How it connects
ICTExam runs a FastAPI backend. The server signs in once with your email and
password, keeps the session cookie for the life of the process, and talks to the
REST API under /api (configurable). No API key to provision.
About
Built by Tahir Almas at ICT Innovations — the team behind ICTExam, ICTContact, ICTDialer, ICTFax and ICTPBX. ICTExam ships with a native Moodle activity module (LTI 1.3, grade passback and roster sync); learn more at ictlms.net.
MIT licensed. Issues and PRs welcome at github.com/ictinnovations/ictexam-mcp.
Available Tools
6 toolsictexam_get_examGet one examARead-only
Get a single exam paper by id: its settings, timing, share links and questions.
Inputs: assessment_id (required).
ictexam_gradebookTeacher gradebookARead-only
Get the teacher gradebook: per-exam totals and student marks. Optionally filter by class_id or subject_id.
Inputs: class_id, subject_id.
ictexam_item_analysisItem analysisARead-only
Per-question item analysis for one exam: difficulty, p-value, average mark and how many responses were full vs zero credit.
Inputs: assessment_id (required).
ictexam_list_classesList classesARead-only
List the classes (course groups) defined on ICTExam.
Inputs: no named parameters.
ictexam_list_examsList examsARead-only
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.
Inputs: class_id, subject_id.
ictexam_list_subjectsList subjectsARead-only
List the subjects on ICTExam, each tied to a class.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: listing exams, fetching one exam, retrieving gradebook data, analyzing individual questions, listing classes, and listing subjects. The boundaries between list_exams and get_exam are explicit, and gradebook versus item_analysis target different levels of results.
All tools consistently use the ictexam_ prefix followed by snake_case verb/noun names. The pattern is predictable across listing, retrieval, and analysis operations.
Six tools form a tightly scoped set for exam discovery, inspection, and analytics. There are no redundant or filler tools, and the count is appropriate for the apparent read-focused purpose.
The toolset covers core read operations for exams, classes, subjects, gradebooks, and item analysis, but it lacks any write/lifecycle operations such as creating, updating, publishing, or deleting exams. It also lacks student/roster-level access, which may be needed for some teacher workflows.
Maintenance
Related MCP Connectors
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Gives AI assistants read access to your Dedox help centre and knowledge base articles.
Read-only AI access to HAVN properties, leads, tasks, files, media, and analytics.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Related MCP Servers
AlicenseAqualityBmaintenanceEnables AI assistants to read ICTCRM contact groups and, when write access is enabled, create or delete contacts and add contacts to campaigns.141 npm1MIT- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to inspect, query, and diagnose an Octopus instance and, when write access is enabled, create releases, deploy releases, run runbooks, and adjust feature toggles.547 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to access and manage academic course information, assignments, submissions, grades, calendars, materials, recordings, and announcements through authenticated LMS sessions.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to inspect enrolled courses, extract readable text from course documents, track upcoming deadlines, view announcements, and retrieve assignment details through the platform’s REST API.MIT