# Ictexam MCP

> Ictexam MCP is an open-source MCP server for education and exams. Read exams, gradebooks and item analysis from ICTExam, and publish papers when allowed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://www.ictlms.net
- **Repository:** https://github.com/ictinnovations/ictexam-mcp
- **MCP Registry name:** io.github.ictinnovations/ictexam-mcp
- **Categories:** education and exams
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [FreeDict](https://ai-powered.com/mcp/freedict): FreeDict is a freemium MCP server for language learning.
- [Extraudinary](https://ai-powered.com/mcp/extraudinary): Extraudinary is a freemium MCP server for education and exams.
- [Scormbusters](https://ai-powered.com/mcp/scormbusters): Scormbusters is an MCP server for education and exams.
- [Dengdeng Chinese Dictionary](https://ai-powered.com/mcp/dengdeng-chinese-dictionary): Dengdeng Chinese Dictionary is a free MCP server for language learning.
- [Rilmo](https://ai-powered.com/mcp/rilmo): Rilmo is a paid MCP server for education and exams.
- [Linkedin Learning](https://ai-powered.com/mcp/linkedin-learning): Linkedin Learning is a paid MCP server for education and exams.
- [Google Scholar](https://ai-powered.com/mcp/google-scholar): Google Scholar is a paid MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/ictexam-mcp
