Log inSubmit server
Ictexam MCP logo

Ictexam MCP

Connects AI assistants to ICTExam for exam data, grading analysis, AI paper parsing, and controlled publishing.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Ictexam MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ictexam-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictexam-mcp"
      ],
      "env": {
        "ICTEXAM_BASE_URL": "YOUR_VALUE_HERE",
        "ICTEXAM_EMAIL": "YOUR_VALUE_HERE",
        "ICTEXAM_PASSWORD": "YOUR_VALUE_HERE",
        "ICTEXAM_API_PREFIX": "YOUR_VALUE_HERE",
        "ICTEXAM_MCP_ALLOW_WRITE": "YOUR_VALUE_HERE",
        "ICTEXAM_TIMEOUT_MS": "YOUR_VALUE_HERE",
        "ICTEXAM_TLS_INSECURE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 6 tools correctly (3d ago).

Overview

The ictexam-mcp MCP server connects AI assistants to an ICTExam installation through its REST API. It authenticates with a teacher or admin account, maintains a session, and exposes exam, class, subject, gradebook, and item-analysis data. Optional write tools can parse local PDF or DOCX papers with AI and publish or unpublish exams. Reach for it when an agent needs to inspect assessment data or manage ICTExam papers with writes explicitly enabled.

Use cases

  • Review exam papers and their questions
  • Inspect student marks and gradebook totals
  • Analyze per-question difficulty and average marks
  • Parse PDF or DOCX question papers
  • Publish or unpublish exams with writes enabled

Key features

  • Exam, class, and subject lookup
  • Gradebook and item analysis access
  • AI extraction from local PDF and DOCX papers
  • Controlled exam publishing and unpublishing
  • Session-based ICTExam REST API authentication
  • Read-only default configuration

Tools6

What Ictexam MCP lets your agent do. Expand a tool for its parameters.

Verified live~461 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 41d

What it can do

From the 6 tools this server returned when we ran it; 6 declare their own safety hints.

Makes network requests · 6Read-only tools · 6
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age49 days
Maintainers1

Observed 2026-10-20 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · ictexam-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars17Stargazers on the source repository.
npm downloads123Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Ictexam MCP works

What ictexam-mcp MCP server does

The ictexam-mcp MCP server gives an MCP client access to an ICTExam account, the AI exam authoring, delivery, and auto-grading platform from ICT Innovations. It supports reading exam papers, classes, subjects, gradebooks, and question-level analysis. The available data includes exam identifiers, titles, statuses, class and subject associations, paper settings, share links, questions, student marks, totals, difficulty, p-values, and average marks.

Read operations are available after the server connects to the configured ICTExam site. They can help an assistant locate a paper, inspect its questions, review marks, or examine item performance without changing platform data.

How it works

The ictexam-mcp MCP server signs in to the ICTExam FastAPI backend using the configured email and password. It keeps the returned session cookie for the process lifetime and sends requests to the REST API, using /api by default. The API prefix can be changed for installations that expose the backend at another path. No separately provisioned API key is required.

The server runs through Node.js and can be started with npx -y ictexam-mcp or installed globally with npm. Node.js 18 or newer is required. MCP client configuration supplies the command and environment variables; the README includes a Claude Desktop configuration example.

Setup and configuration

Set ICTEXAM_BASE_URL to the ICTExam site, without a trailing /api, and provide ICTEXAM_EMAIL and ICTEXAM_PASSWORD for a teacher or administrator account. Optional settings include ICTEXAM_API_PREFIX, ICTEXAM_MCP_ALLOW_WRITE, ICTEXAM_TIMEOUT_MS, and ICTEXAM_TLS_INSECURE.

By default, ICTEXAM_MCP_ALLOW_WRITE is false. Set it to true to register the tools that upload and parse question papers, publish exams, or return published exams to draft status. The timeout defaults to 60,000 milliseconds, which accommodates slower AI parsing requests. TLS verification can be disabled for self-signed test servers, but this is controlled separately through ICTEXAM_TLS_INSECURE.

Tools and capabilities

The ictexam-mcp MCP server exposes these read tools:

  • ictexam_list_exams lists papers with identifiers, titles, statuses, classes, and subjects.
  • ictexam_get_exam retrieves a paper's settings, share links, and questions.
  • ictexam_list_classes lists course groups.
  • ictexam_list_subjects lists subjects and their associated classes.
  • ictexam_gradebook returns exam totals and student marks.
  • ictexam_item_analysis returns per-question difficulty, p-value, and average mark.

When writes are enabled, three additional tools become available:

  • ictexam_parse_question_paper uploads a local PDF or DOCX and uses AI to extract its questions.
  • ictexam_publish_exam publishes a paper and returns student and teacher share URLs.
  • ictexam_unpublish_exam changes a paper back to draft status.

Limitations and notes

Write access is opt-in and the write tools are not registered in the default configuration. Parsing a paper consumes AI credit on the ICTExam server, while publishing makes the exam live for students. The account used by the server determines the authenticated session and available access.

The server does not store or log the password beyond the environment supplied to it. Use ICTEXAM_TLS_INSECURE only for self-signed test servers because it skips TLS certificate verification. The documented client setup targets Claude Desktop; other clients require their own MCP server configuration format.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Ictexam MCP

ictexam-mcp is an MCP server that connects AI assistants to the ICTExam exam authoring, delivery, and auto-grading platform. Its main tools list and inspect exams, classes, subjects, gradebooks, and item analysis, while optional write tools parse PDF or DOCX papers and publish or unpublish exams.

Install it with `npx -y ictexam-mcp` or run `npm install -g ictexam-mcp`. Node.js 18 or newer is required. Add the command to your MCP client configuration and provide the required ICTExam environment variables.

Set `ICTEXAM_BASE_URL`, `ICTEXAM_EMAIL`, and `ICTEXAM_PASSWORD` in the MCP client configuration or a `.env` file. The base URL should omit `/api`; use `ICTEXAM_API_PREFIX` only when the API is mounted elsewhere.

Set `ICTEXAM_MCP_ALLOW_WRITE=true` to register the write tools. This enables AI parsing of local PDF or DOCX papers, exam publishing, and returning published exams to draft status; writes remain disabled by default.

Related MCP servers

All in Education All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewIctexam MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ictexam-mcp?style=directory)](https://allmcps.com/mcp/ictexam-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/ictexam-mcp"><img src="https://allmcps.com/api/badge/ictexam-mcp?style=directory" alt="Ictexam MCP on AllMCPs" /></a>