tixuz avatar

Openemis Pro

tixuz/openemis-mcp-pro

Bridges Claude and other MCP clients to OpenEMIS, the UNESCO-backed open-source school management system used by kindergartens, primary schools, and universities worldwide. Wraps 675 resources and 3,355 REST endpoints behind nine high-level tools: health checks, domain discovery, playbook retrieval, and full CRUD operations (read, create, update, delete). The `openemis_get` tool handles filtered queries across students, staff, attendance, exams, and infrastructure using CakePHP-style parameters. Write operations work for non-workflow resources; workflow-controlled entities like staff leave redirect to curated playbooks. Tested against Core 5.10.0 and the public demo instance at demo.openemis.org. Includes per-user authentication and supports both stdio and HTTP server modes for ChatGPT Custom GPT integration.

GitHub stars
1
tools
9
auth
Secret needed
transport
STDIO
env vars
6
last updated
May 15, 2026

Tools

9 tools

Public tool metadata for what this MCP can expose to an agent.

openemis_healthPings the configured instance and reports reachability. Performs a real login round-trip — if this passes, CRUD will work.

Pings the configured instance and reports reachability. Performs a real login round-trip — if this passes, CRUD will work.

No parameter schema in public metadata yet.

openemis_list_domainsLists the curated OpenEMIS domains — Attendance, Assessment, Staff, Student, Institution, Schedule, Examination, Report — each with a one-line summary.

Lists the curated OpenEMIS domains — Attendance, Assessment, Staff, Student, Institution, Schedule, Examination, Report — each with a one-line summary.

No parameter schema in public metadata yet.

openemis_discoverInput: a topic string. Output: up to 30 endpoints relevant to that topic, drawn from the domain knowledge pack and the per-instance manifest.

Input: a topic string. Output: up to 30 endpoints relevant to that topic, drawn from the domain knowledge pack and the per-instance manifest.

No parameter schema in public metadata yet.

openemis_list_playbooksLists all 40 curated workflow playbooks with id, title, domain, and audience.

Lists all 40 curated workflow playbooks with id, title, domain, and audience.

No parameter schema in public metadata yet.

openemis_get_playbookInput: a playbook id. Output: the full playbook — resources, ordered steps, guidance notes, and example queries.

Input: a playbook id. Output: the full playbook — resources, ordered steps, guidance notes, and example queries.

No parameter schema in public metadata yet.

openemis_getUnified read tool. { resource, id?, params? } — if id is present, fetches the singleton; otherwise lists with any combination of _fields, _conditions, orderby, order, page, limit, plus any ad-hoc filter key.

Unified read tool. { resource, id?, params? } — if id is present, fetches the singleton; otherwise lists with any combination of _fields, _conditions, orderby, order, page, limit, plus any ad-hoc filter key.

No parameter schema in public metadata yet.

openemis_createCreate a new record. { resource, body } — non-workflow resources only.

Create a new record. { resource, body } — non-workflow resources only.

No parameter schema in public metadata yet.

openemis_updateUpdate an existing record by id. { resource, id, body } — non-workflow resources only.

Update an existing record by id. { resource, id, body } — non-workflow resources only.

No parameter schema in public metadata yet.

openemis_deleteDelete a record by id. { resource, id } — non-workflow resources only.

Delete a record by id. { resource, id } — non-workflow resources only.

No parameter schema in public metadata yet.

Sponsors

Configuration

OPENEMIS_BASE_URL*

Base URL of your OpenEMIS instance (e.g., https://demo.openemis.org/core)

OPENEMIS_API_KEY*secret

OpenEMIS API key (issued by the OpenEMIS admin). Required for every upstream login.

OPENEMIS_USERNAME

OpenEMIS login username. Optional — if unset, server fails closed and requires openemis_login at runtime.

OPENEMIS_PASSWORDsecret

OpenEMIS login password. Pairs with OPENEMIS_USERNAME for env-default auth.

OPENEMIS_TIMEOUT_MS

Request timeout in milliseconds (default 30000)

OPENEMIS_CORE_IN_OPERATOR

Set to 1 to enable native IN-operator batch GETs once your OpenEMIS Core has POCOR-9660 deployed.

Readme

openemis-mcp-pro logo — read and write AI bridge for OpenEMIS school management

openemis-mcp-pro — Read + Write AI Bridge for OpenEMIS School Management

A natural-language bridge between MCP-aware agents (Claude, Codex, Cursor, etc.) and any OpenEMIS school — with full read + write access.

OpenEMIS is a free, open-source school management information system developed by UNESCO and KORDIT. It runs the day-to-day administration of every kind of educational institution — kindergartens, primary schools, secondary schools, secondary vocational institutions, technical colleges, and universities — managing students, staff, attendance, assessment, infrastructure, meals, scholarships, examinations, training, and ministry-level reporting. This MCP-pro server adds full read + write access plus per-user authentication on top of any OpenEMIS school.

Translations: Русский · Español · हिन्दी · العربية


View the full README on GitHub

Details

Repository
github.com/tixuz/openemis-mcp-pro
Package
openemis-mcp-pro
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from tixuz