Skip to content
MCP server

Ictexam MCP

Read exams, gradebooks and item analysis from ICTExam, and publish papers when allowed

Runs locallyStatus and history
Install
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-mcp

Add 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).Required
  • ICTEXAM_EMAILA teacher or admin account email.Required
  • ICTEXAM_PASSWORDPassword for the account.Required
  • ICTEXAM_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

  1. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  2. FreeDict

    MCP server

    Dictionary lookups, synonyms, rhymes, slang and word search for AI apps and games

    Not checked yet
    • Remote
    • Freemium
    • Language learning
  3. Extraudinary

    MCP server

    Review speaking-practice feedback and save scripts to rehearse from an assistant

    • Remote
    • Freemium
    • Education and exams
  4. Scormbusters

    MCP server

    Remote MCP server for building and exporting SCORM, cmi5 and xAPI courses

    • 6 tools
    • Remote
    • Free trial
    • Education and exams
  5. Free Chinese-English dictionary MCP server with HSK 3.0 lists and embeddable widgets

    • 4 tools
    • Remote
    • Free
    • Language learning
  6. Rilmo

    MCP server

    Read-only access to a student's recorded classes, notes, slides and concept map

    Not checked yet
    • Remote
    • Paid
    • Education and exams