Log inSubmit server
Openemis Pro logo

Openemis Pro

Connects MCP-compatible agents to OpenEMIS v5 for scoped discovery, read queries, and non-workflow CRUD operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Openemis Pro

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

SSE (Remote)
Server URL
https://api.openemis.org/core

Remote servers are added in the app, not the config file: Customize → Connectors → Add custom connector, then paste this URL.

Overview

The openemis-pro MCP server connects MCP-compatible agents to an OpenEMIS school management system through its Core REST API. It narrows a large API surface with domain discovery and workflow playbooks, then provides unified reads plus create, update, and delete operations for supported resources. Use it when an agent needs current OpenEMIS data or must change non-workflow records. Workflow-controlled operations are blocked and redirected to playbooks.

Use cases

  • Query student, staff, institution, attendance, or examination records
  • Discover OpenEMIS endpoints for a topic before answering a question
  • Load a playbook for a multi-step school administration workflow
  • Create supported non-workflow records
  • Update or delete supported records by ID

Key features

  • Domain-scoped endpoint discovery
  • Unified filtered read tool
  • 40 curated workflow playbooks
  • Non-workflow create, update, and delete tools
  • Health checks with a real login round-trip
  • Stdio and HTTP transport modes

Tools9

What Openemis Pro lets your agent do. Expand a tool for its parameters.

Self-reported~386 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 1d ago

Recent health check succeeded.

5/5 checks healthy over the last 32d

Adoption & maintenance

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

GitHub stars2Stargazers on the source repository.
Last commit4mo agoMost recent push to the default branch.
Tools exposed9Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Openemis Pro works

What openemis-pro MCP server does

The openemis-pro MCP server gives AI agents an MCP interface to OpenEMIS v5, a school management information system. It supports read access across the documented OpenEMIS resource surface and write operations for resources that are not controlled by the CakePHP Workflow plugin.

The server covers 678 resources and 3,361 endpoints in the referenced OpenEMIS Core 5.13.0 API. Its subject areas include attendance, assessment, staff, students, institutions, schedules, examinations, and reports. It also includes 40 curated playbooks that describe multi-step tasks, their resources, and example queries.

How it works

Agents can begin with openemis_health, which checks reachability and performs a real login round-trip. openemis_list_domains provides the available subject areas, while openemis_discover accepts a topic and returns up to 30 relevant endpoints from the knowledge pack and instance manifest. This avoids loading the entire OpenEMIS API into the conversation.

For reads, openemis_get handles both collection and single-record requests. Supplying an id fetches one record; omitting it lists records. Query parameters can include field selection, conditions, ordering, pagination, limits, and resource-specific filters. The handler maps these parameters to the OpenEMIS query style.

The openemis-pro MCP server exposes openemis_list_playbooks and openemis_get_playbook for guided workflows. An agent can identify a playbook, load its ordered steps and guidance, and then perform supported write steps with the CRUD tools.

Tools and capabilities

  • Check instance reachability and authentication with openemis_health.
  • List curated OpenEMIS domains with openemis_list_domains.
  • Find topic-specific endpoints with openemis_discover.
  • Browse and load the 40 workflow playbooks.
  • Read singleton records or filtered collections with openemis_get.
  • Create records with openemis_create on non-workflow resources.
  • Modify records by ID with openemis_update on non-workflow resources.
  • Remove records by ID with openemis_delete on non-workflow resources.

Limitations and notes

Create, update, and delete are not general-purpose writes for every OpenEMIS resource. Workflow-controlled resources are blocked at the tool layer and redirected to the relevant playbook; attendance and staff leave are examples identified in the project material. The read tool is broader than the write tools.

The openemis-pro MCP server was tested against OpenEMIS Core 5.13.0 and is described as supporting earlier 5.7 through 5.12 deployments. Batch ID behavior depends on the OpenEMIS Core version: Core 5.10 and later can use the native multi-ID request, while older deployments can use the documented legacy mode. Composite-key and view resources require field conditions instead of the ID batch parameter.

The server supports stdio mode for local MCP clients and an HTTP mode for remote connections and ChatGPT Custom GPT use.

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 Openemis Pro

openemis-pro is an MCP server that connects AI assistants to the OpenEMIS school management system through its Core REST API. Its main tools discover domains and endpoints, load workflow playbooks, read records, and create, update, or delete non-workflow records. It also checks reachability with an authenticated health request.

Yes, openemis-pro works with Cursor in stdio mode and remote HTTP mode. Add the local server through Cursor’s MCP configuration, or provide the remote MCP URL in its settings. The project lists full tool access for the stdio connection.

Yes, it can create records with openemis_create and update records by ID with openemis_update when the resource is not workflow-controlled. Attendance, staff leave, and other workflow-managed operations are blocked and should be handled through the relevant playbook.

It uses openemis_list_domains and openemis_discover to narrow the API by subject and topic. Discovery returns up to 30 relevant endpoints from curated domain notes and the instance manifest, after which openemis_get can retrieve filtered records.

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 PreviewOpenemis Pro AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/openemis-pro?style=directory)](https://allmcps.com/mcp/openemis-pro)
HTML Embed
<a href="https://allmcps.com/mcp/openemis-pro"><img src="https://allmcps.com/api/badge/openemis-pro?style=directory" alt="Openemis Pro on AllMCPs" /></a>