Skip to content
MCP server

Orah MCP by usefulapi

Read students, rolls and attendance; create and update students, contacts and houses in…

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About Orah MCP by usefulapi

Orah MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read students, rolls and attendance; create and update students, contacts and houses in Orah.

Install

Run in a terminal

claude mcp add --transport http orah https://orah.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://orah.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "orah": {
      "url": "https://orah.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "orah": {
      "type": "http",
      "url": "https://orah.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "orah": {
      "serverUrl": "https://orah.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "orah": {
      "type": "http",
      "url": "https://orah.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (25)

Read directly from the server.

orah_list_students
List students with optional filters (house, group, year level, student type, deactivated). Without filters it returns all active students; set page_size to page the list. Orah route: POST /open-api/student/list.
orah_get_student
Get one student with contact-relevant fields, house and dietary or medical notes. Give the Orah id or the SIS id. Orah route: POST /open-api/student/get-single.
orah_list_houses
List all houses (student groupings) at the school. Use the ids in the student filters. Orah route: POST /open-api/house/list.
orah_list_student_contacts
List the contacts (parents, guardians) of one student. Give the student's Orah id or SIS id. Orah route: POST /open-api/contact/list-by-student.
orah_list_groups
List groups: academic classes, advisories, athletics, activities and more. Filter by type, e.g. 'Academics', to find classes. Orah route: POST /open-api/group/list.
orah_list_reason_codes
List the school's attendance reason codes (for example 'Tardy Unexcused'). Use them to read reasons on attendance and roll records. Orah route: POST /open-api/reason-code/list.
orah_list_locations
List the school's location tree (zones, buildings, rooms, floors, outdoor facilities) with each location's state (on grounds, off grounds, home). Orah route: POST /open-api/location/tree.
orah_list_current_locations
List the current location record of each student (one per student; a new student may have none). Limit to some students with ids or SIS ids. Orah route: POST /open-api/location-record/get-current.
orah_list_location_records
List check-in and in-transit location records in time order, for all students or one student, within an optional time range. Paged. Orah route: POST /open-api/location-record/timeline.
orah_list_pastoral
List pastoral entries (discipline, merit, health and other student events written by staff), in date order, for all students or one student. Sensitive entries show only to staff with extra rights. Paged. Orah route: POST /open-api/pastoral/timeline.
orah_list_roll_types
List roll types (Daily, Emergency, Attendance) with whether each is manual or automatic and active. Orah route: POST /open-api/roll-type/list.
orah_list_rolls
List rolls (completed by default) in a time range, without per-student marks. Use orah_get_roll for one roll's marks. Paged. Orah route: POST /open-api/roll/timeline.
orah_get_roll
Get one roll with its codes and every student's mark, reason and note. Orah route: POST /open-api/roll/get-single.
orah_list_daily_attendance
List the daily attendance status per student for a date window (the same status the Orah dashboards show). The window is required: start_date is inclusive, end_date is exclusive and optional (omit it for one day). Maximum 12 months. Orah route: POST /open-api/daily-attendance/timeline.
orah_list_scheduled_classes
List the scheduled class attendance items for one UTC date, optionally for one staff member, group or student. Orah route: POST /open-api/classes/scheduled.
orah_list_staff
List staff members. Set deactivated to true to list suspended staff. Orah route: POST /open-api/staff/list.
orah_get_staff
Get one staff member by Orah id or SIS id. Orah route: POST /open-api/staff/get-single.
orah_list_leave_types
List the active leave types (for example absence categories) and their short codes. Orah route: POST /open-api/leave-type/list.
orah_get_leave
Get one leave record (a student's planned or past absence) with its time, status, type, location and note. Orah route: POST /open-api/leave/get-single.
orah_create_student
Create a student record. first_name and last_name are required. Creates a real student in the school's Orah. Orah route: POST /open-api/student/create.
orah_update_student
Update a student's fields (names, year level, house, dietary or medical notes, contact details). Find the student by student_id or current_sis_id; sis_id sets a new SIS id. To hide a student from active lists, set deactivated to true. This server does not offer Orah's student delete route. Orah route: POST /open-api/student/update.
orah_create_contact
Create a contact (parent or guardian) for one student. Give the student's Orah id or SIS id. Orah route: POST /open-api/contact/create.
orah_update_contact
Update a contact's details. Give the contact's Orah id, or its SIS id together with the student's id or SIS id. Orah route: POST /open-api/contact/update.
orah_create_house
Create a house (a student grouping). Orah route: POST /open-api/house/create.
orah_update_house
Rename a house or change its SIS id. Give the house's Orah id or SIS id. Orah route: POST /open-api/house/update.

Orah MCP by usefulapi FAQ

How do I add Orah MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http orah https://orah.usefulapi.io/mcp