Ictexam MCP
Read exams, gradebooks and item analysis from ICTExam, and publish papers when allowed
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- 2 days ago
About Ictexam MCP
Ictexam MCP is an open-source MCP server for education and exams. It runs locally on your machine and is started by your AI client.
ICTExam is an exam platform that turns PDF, Word or scanned papers into online exams and grades answers with AI support. This server lets a teacher or admin account use it from an assistant: list exams, classes and subjects, open a paper's settings, share links and questions, read per-exam gradebooks, and see per-question difficulty, p-value and average mark.
Three write tools are off by default and not registered at all unless ICTEXAM_MCP_ALLOW_WRITE is true: parse a local PDF or DOCX into structured questions (which spends the server's AI credit), publish an exam to get student and teacher share links, and set a paper back to draft. It signs in once with the account's email and password and keeps the session cookie, sending the CSRF token on writes like the web app.
It needs Node.js 18 or newer, a base URL for your ICTExam site, and is MIT licensed. The platform itself offers LTI 1.3 and a Moodle module, per its site.
Install
Run in a terminal
claude mcp add ictexam-mcp --env ICTEXAM_BASE_URL='<ICTEXAM_BASE_URL>' --env ICTEXAM_EMAIL='<ICTEXAM_EMAIL>' --env ICTEXAM_PASSWORD='<ICTEXAM_PASSWORD>' -- npx -y ictexam-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"ictexam-mcp": {
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ictexam-mcp": {
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ictexam-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ictexam-mcp": {
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ictexam-mcp": {
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}Configuration
ICTEXAM_BASE_URLBase URL of your ICTExam site, e.g. https://app.ictlms.net (no trailing /api).RequiredICTEXAM_EMAILA teacher or admin account email.RequiredICTEXAM_PASSWORDPassword for the account.RequiredICTEXAM_API_PREFIXPath the API is mounted under. Defaults to /api (behind the usual reverse proxy). Set empty to talk to the backend port directly.ICTEXAM_MCP_ALLOW_WRITEUnlocks the write tools: parse a paper with AI (spends server AI credit), publish and unpublish exams. When false these tools are not registered at all. Leave off unless you mean it.ICTEXAM_TIMEOUT_MSPer request timeout in milliseconds. Defaults to 60000 (AI parsing can be slow).ICTEXAM_TLS_INSECURESkip TLS certificate verification. Only for a self-signed test server.
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- ictexam_list_exams
- List exam papers with id, title, status, class and subject.
- ictexam_get_exam
- One paper's settings, share links and questions.
- ictexam_list_classes
- List classes.
- ictexam_list_subjects
- List subjects, each tied to a class.
- ictexam_gradebook
- Per-exam totals and student marks.
- ictexam_item_analysis
- Per-question difficulty, p-value and average mark.
- ictexam_parse_question_paper
- Upload a local PDF or DOCX and AI-extract the questions; writes only.
- ictexam_publish_exam
- Publish a paper and return share URLs; writes only.
- ictexam_unpublish_exam
- Set a paper back to draft; writes only.
What it does
- Exam listing
- Lists papers with status, class and subject.
- Exam details
- Shows settings, share links and questions for one paper.
- Gradebook
- Reads per-exam totals and student marks.
- Item analysis
- Reports difficulty, p-value and average mark per question.
- AI paper parsing
- Extracts questions from a PDF or DOCX when writes are enabled.
- Publish and unpublish
- Makes an exam live or returns it to draft.
Good for
- Review which questions students found hardest
- Summarise a class's gradebook
- Turn a local question paper into a structured exam
- Publish an exam and get student and teacher links
- Check classes and subjects before building a paper
Pricing
Open source
Server is MIT licensed; needs an ICTExam site and account
Prices change. Check ictlms.net before you buy.
Ictexam MCP FAQ
Can it change anything by default?
No. The three write tools are not registered unless ICTEXAM_MCP_ALLOW_WRITE is true.
Does parsing cost anything?
It spends AI credit on the ICTExam server.
What account does it use?
A teacher or admin email and password for your ICTExam site.
What licence is it?
MIT.
Is Ictexam MCP free?
Yes. Ictexam MCP is open source, so you can use and self-host it for free.
How do I add Ictexam MCP to Claude Code?
Run this command in your terminal: claude mcp add ictexam-mcp --env ICTEXAM_BASE_URL='<ICTEXAM_BASE_URL>' --env ICTEXAM_EMAIL='<ICTEXAM_EMAIL>' --env ICTEXAM_PASSWORD='<ICTEXAM_PASSWORD>' -- npx -y ictexam-mcp
What are the best alternatives to Ictexam MCP?
The closest alternatives to Ictexam MCP are Born Then, FreeDict, Extraudinary, Scormbusters and Dengdeng Chinese Dictionary.
Alternatives to Ictexam MCP
Born Then
MCP serverFree MCP server that rolls random historical births weighted by real demographics
- 2 tools
- Remote
- Free
- Education and exams

FreeDict
MCP serverDictionary lookups, synonyms, rhymes, slang and word search for AI apps and games
Not checked yet- Remote
- Freemium
- Language learning

Extraudinary
MCP serverReview speaking-practice feedback and save scripts to rehearse from an assistant
- Remote
- Freemium
- Education and exams

Scormbusters
MCP serverRemote MCP server for building and exporting SCORM, cmi5 and xAPI courses
- 6 tools
- Remote
- Free trial
- Education and exams

Dengdeng Chinese Dictionary
MCP serverFree Chinese-English dictionary MCP server with HSK 3.0 lists and embeddable widgets
- 4 tools
- Remote
- Free
- Language learning

Rilmo
MCP serverRead-only access to a student's recorded classes, notes, slides and concept map
Not checked yet- Remote
- Paid
- Education and exams