Orah MCP by usefulapi is an MCP server published by io.usefulapi, hosted at orah.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 25 tools, including orah_list_students, orah_get_student, orah_list_houses, orah_list_student_contacts, orah_list_groups.
Read students, rolls and attendance; create and update students, contacts and houses in Orah.
4,173 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| group_ids | array | Orah ids (any of them). |
| house_ids | array | Orah ids (any of them). |
| page_size | integer | Records per page (1-1000, default 200). |
| page_index | integer | Zero-based page number (default 0). Keep paging while full pages return. |
| sort_order | string | Sort by student id when paging (default ASC). |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| deactivated | boolean | true lists deactivated students (default false). |
| year_levels | array | Exact year level values, e.g. 'Year 11'. |
| group_sis_ids | array | SIS ids (any of them). |
| house_sis_ids | array | SIS ids (any of them). |
| student_types | array |
{
"name": "orah_list_students",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"group_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"minItems": 1,
"description": "Orah ids (any of them)."
},
"house_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"minItems": 1,
"description": "Orah ids (any of them)."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Records per page (1-1000, default 200)."
},
"page_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based page number (default 0). Keep paging while full pages return."
},
"sort_order": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort by student id when paging (default ASC)."
},
"deactivated": {
"type": "boolean",
"description": "true lists deactivated students (default false)."
},
"year_levels": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Exact year level values, e.g. 'Year 11'."
},
"group_sis_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "SIS ids (any of them)."
},
"house_sis_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "SIS ids (any of them)."
},
"student_types": {
"type": "array",
"items": {
"enum": [
"Boarding",
"Day",
"Remote",
"FlexiBoarding"
],
"type": "string"
},
"minItems": 1
}
}
},
"annotations": {
"title": "List students",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id | integer | Orah id. |
| sis_id | string | SIS id from the school's student information system. |
{
"name": "orah_get_student",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah id.",
"exclusiveMinimum": 0
},
"sis_id": {
"type": "string",
"minLength": 1,
"description": "SIS id from the school's student information system."
}
}
},
"annotations": {
"title": "Get student",
"readOnlyHint": true
}
}List all houses (student groupings) at the school. Use the ids in the student filters. Orah route: POST /open-api/house/list.
No parameters.
{
"name": "orah_list_houses",
"description": "List all houses (student groupings) at the school. Use the ids in the student filters. Orah route: POST /open-api/house/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List houses",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| student_id | integer | Orah id. |
| student_sis_id | string | SIS id from the school's student information system. |
{
"name": "orah_list_student_contacts",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"student_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah id.",
"exclusiveMinimum": 0
},
"student_sis_id": {
"type": "string",
"minLength": 1,
"description": "SIS id from the school's student information system."
}
}
},
"annotations": {
"title": "List student contacts",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| types | array | Group types, e.g. ['Academics']. Values combine with OR. |
| page_size | integer | Records per page (1-1000, default 200). |
| page_index | integer | Zero-based page number (default 0). Keep paging while full pages return. |
{
"name": "orah_list_groups",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"types": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Group types, e.g. ['Academics']. Values combine with OR."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Records per page (1-1000, default 200)."
},
"page_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based page number (default 0). Keep paging while full pages return."
}
}
},
"annotations": {
"title": "List groups",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| sis_ids | array | SIS ids (any of them). |
| page_size | integer | Records per page (1-1000, default 200). |
| page_index | integer | Zero-based page number (default 0). Keep paging while full pages return. |
| reason_types | array |
{
"name": "orah_list_reason_codes",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sis_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "SIS ids (any of them)."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Records per page (1-1000, default 200)."
},
"page_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based page number (default 0). Keep paging while full pages return."
},
"reason_types": {
"type": "array",
"items": {
"enum": [
"excused",
"unexcused",
"notExpected"
],
"type": "string"
},
"minItems": 1
}
}
},
"annotations": {
"title": "List reason codes",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| nested | boolean | true nests child locations; false returns a flat list. |
{
"name": "orah_list_locations",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"nested": {
"type": "boolean",
"description": "true nests child locations; false returns a flat list."
}
}
},
"annotations": {
"title": "List locations",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| student_ids | array | Orah ids (any of them). |
| student_sis_ids | array | SIS ids (any of them). |
{
"name": "orah_list_current_locations",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"student_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"minItems": 1,
"description": "Orah ids (any of them)."
},
"student_sis_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "SIS ids (any of them)."
}
}
},
"annotations": {
"title": "List current student locations",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| end_date | string | Exclusive upper bound. Default: now. |
| page_size | integer | Records per page (1-1000, default 200). |
| page_index | integer | Zero-based page number (default 0). Keep paging while full pages return. |
| start_date | string | ISO 8601 date-time, e.g. 2026-11-01T00:00:00.000Z. |
| student_id | integer | Orah id. |
| student_sis_id | string | SIS id from the school's student information system. |
{
"name": "orah_list_location_records",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$",
"description": "Exclusive upper bound. Default: now."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Records per page (1-1000, default 200)."
},
"page_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based page number (default 0). Keep paging while full pages return."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$",
"description": "ISO 8601 date-time, e.g. 2026-11-01T00:00:00.000Z."
},
"student_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah id.",
"exclusiveMinimum": 0
},
"student_sis_id": {
"type": "string",
"minLength": 1,
"description": "SIS id from the school's student information system."
}
}
},
"annotations": {
"title": "List location record history",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| end_date | string | Exclusive upper bound. Default: now. |
| page_size | integer | Records per page (1-1000, default 200). |
| page_index | integer | Zero-based page number (default 0). Keep paging while full pages return. |
| start_date | string | Inclusive lower bound. |
| student_id | integer | Orah id. |
| updated_since | string | Only entries created or changed since this time. |
| student_sis_id | string | SIS id from the school's student information system. |
| nested_category | boolean | true nests the parent category under the category. |
{
"name": "orah_list_pastoral",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$",
"description": "Exclusive upper bound. Default: now."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Records per page (1-1000, default 200)."
},
"page_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based page number (default 0). Keep paging while full pages return."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$",
"description": "Inclusive lower bound."
},
"student_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah id.",
"exclusiveMinimum": 0
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$",
"description": "Only entries created or changed since this time."
},
"student_sis_id": {
"type": "string",
"minLength": 1,
"description": "SIS id from the school's student information system."
},
"nested_category": {
"type": "boolean",
"description": "true nests the parent category under the category."
}
}
},
"annotations": {
"title": "List pastoral records",
"readOnlyHint": true
}
}List roll types (Daily, Emergency, Attendance) with whether each is manual or automatic and active. Orah route: POST /open-api/roll-type/list.
| Parameter | Type | Description |
|---|---|---|
| type | string | one of ["Daily","Emergency","Attendance"] |
| is_active | boolean |
{
"name": "orah_list_roll_types",
"description": "List roll types (Daily, Emergency, Attendance) with whether each is manual or automatic and active. Orah route: POST /open-api/roll-type/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"Daily",
"Emergency",
"Attendance"
],
"type": "string"
},
"is_active": {
"type": "boolean"
}
}
},
"annotations": {
"title": "List roll types",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| status | string | Life-cycle status (default Complete). |
| end_date | string | Exclusive upper bound. Default: now. |
| page_size | integer | Records per page (1-1000, default 200). |
| page_index | integer | Zero-based page number (default 0). Keep paging while full pages return. |
| start_date | string | ISO 8601 date-time, e.g. 2026-11-01T00:00:00.000Z. |
{
"name": "orah_list_rolls",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"status": {
"enum": [
"Complete",
"Active",
"All"
],
"type": "string",
"description": "Life-cycle status (default Complete)."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$",
"description": "Exclusive upper bound. Default: now."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Records per page (1-1000, default 200)."
},
"page_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based page number (default 0). Keep paging while full pages return."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$",
"description": "ISO 8601 date-time, e.g. 2026-11-01T00:00:00.000Z."
}
}
},
"annotations": {
"title": "List rolls",
"readOnlyHint": true
}
}Get one roll with its codes and every student's mark, reason and note. Orah route: POST /open-api/roll/get-single.
| Parameter | Type | Description |
|---|---|---|
| roll_id * | integer | Orah roll id (from orah_list_rolls). |
{
"name": "orah_get_roll",
"description": "Get one roll with its codes and every student's mark, reason and note. Orah route: POST /open-api/roll/get-single.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"roll_id"
],
"properties": {
"roll_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah roll id (from orah_list_rolls).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get roll",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| end_date | string | Date, yyyy-mm-dd. |
| page_size | integer | Records per page (1-1000, default 200). |
| page_index | integer | Zero-based page number (default 0). Keep paging while full pages return. |
| start_date * | string | Date, yyyy-mm-dd. |
| student_ids | array | Orah ids (any of them). |
| student_sis_ids | array | SIS ids (any of them). |
| attendance_codes | array | Only these daily codes (any of them), e.g. ['Unexcused Absent']. |
{
"name": "orah_list_daily_attendance",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Records per page (1-1000, default 200)."
},
"page_index": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based page number (default 0). Keep paging while full pages return."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"student_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"minItems": 1,
"description": "Orah ids (any of them)."
},
"student_sis_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "SIS ids (any of them)."
},
"attendance_codes": {
"type": "array",
"items": {
"enum": [
"Present",
"Unexcused Late",
"Excused Late",
"Unexcused Absent",
"Excused Absent",
"Not Expected"
],
"type": "string"
},
"minItems": 1,
"description": "Only these daily codes (any of them), e.g. ['Unexcused Absent']."
}
}
},
"annotations": {
"title": "List daily attendance",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| date * | string | UTC date, yyyy-mm-dd. |
| group_id | integer | |
| staff_id | integer | |
| student_id | integer |
{
"name": "orah_list_scheduled_classes",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"date"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "UTC date, yyyy-mm-dd."
},
"group_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"staff_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"student_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List scheduled classes",
"readOnlyHint": true
}
}List staff members. Set deactivated to true to list suspended staff. Orah route: POST /open-api/staff/list.
| Parameter | Type | Description |
|---|---|---|
| deactivated | boolean |
{
"name": "orah_list_staff",
"description": "List staff members. Set deactivated to true to list suspended staff. Orah route: POST /open-api/staff/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"deactivated": {
"type": "boolean"
}
}
},
"annotations": {
"title": "List staff",
"readOnlyHint": true
}
}Get one staff member by Orah id or SIS id. Orah route: POST /open-api/staff/get-single.
| Parameter | Type | Description |
|---|---|---|
| id | integer | Orah id. |
| sis_id | string | SIS id from the school's student information system. |
{
"name": "orah_get_staff",
"description": "Get one staff member by Orah id or SIS id. Orah route: POST /open-api/staff/get-single.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah id.",
"exclusiveMinimum": 0
},
"sis_id": {
"type": "string",
"minLength": 1,
"description": "SIS id from the school's student information system."
}
}
},
"annotations": {
"title": "Get staff member",
"readOnlyHint": true
}
}List the active leave types (for example absence categories) and their short codes. Orah route: POST /open-api/leave-type/list.
No parameters.
{
"name": "orah_list_leave_types",
"description": "List the active leave types (for example absence categories) and their short codes. Orah route: POST /open-api/leave-type/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List leave types",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| leave_id * | integer | Orah leave id. |
{
"name": "orah_get_leave",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"leave_id"
],
"properties": {
"leave_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah leave id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get leave",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| string | ||
| gender | string | one of ["Male","Female","Other","Unknown"] |
| sis_id | string | |
| alt_name | string | Preferred name. |
| house_id | any | Orah house id, or null for no house. |
| diet_info | string | |
| last_name * | string | |
| bed_number | string | |
| birth_date | string | Date, yyyy-mm-dd. |
| first_name * | string | |
| year_level | string | |
| deactivated | boolean | true deactivates the student (hides them from active lists). This server does not offer deletes. |
| home_number | string | |
| room_number | string | |
| house_sis_id | string | House SIS id. |
| medical_info | string | |
| reference_id | string | The school's human-known student id. |
| student_type | string | one of ["Boarding","Day","Remote","FlexiBoarding"] |
| mobile_number | string | |
| is_international | boolean |
{
"name": "orah_create_student",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"first_name",
"last_name"
],
"properties": {
"email": {
"type": "string"
},
"gender": {
"enum": [
"Male",
"Female",
"Other",
"Unknown"
],
"type": "string"
},
"sis_id": {
"type": "string"
},
"alt_name": {
"type": "string",
"description": "Preferred name."
},
"house_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Orah house id, or null for no house."
},
"diet_info": {
"type": "string"
},
"last_name": {
"type": "string",
"minLength": 1
},
"bed_number": {
"type": "string"
},
"birth_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"first_name": {
"type": "string",
"minLength": 1
},
"year_level": {
"type": "string"
},
"deactivated": {
"type": "boolean",
"description": "true deactivates the student (hides them from active lists). This server does not offer deletes."
},
"home_number": {
"type": "string"
},
"room_number": {
"type": "string"
},
"house_sis_id": {
"type": "string",
"minLength": 1,
"description": "House SIS id."
},
"medical_info": {
"type": "string"
},
"reference_id": {
"type": "string",
"description": "The school's human-known student id."
},
"student_type": {
"enum": [
"Boarding",
"Day",
"Remote",
"FlexiBoarding"
],
"type": "string"
},
"mobile_number": {
"type": "string"
},
"is_international": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Create student",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| string | ||
| gender | string | one of ["Male","Female","Other","Unknown"] |
| sis_id | string | |
| alt_name | string | Preferred name. |
| house_id | any | Orah house id, or null for no house. |
| diet_info | string | |
| last_name | string | |
| bed_number | string | |
| birth_date | string | Date, yyyy-mm-dd. |
| first_name | string | |
| student_id | integer | Orah id. |
| year_level | string | |
| deactivated | boolean | true deactivates the student (hides them from active lists). This server does not offer deletes. |
| home_number | string | |
| room_number | string | |
| house_sis_id | string | House SIS id. |
| medical_info | string | |
| reference_id | string | The school's human-known student id. |
| student_type | string | one of ["Boarding","Day","Remote","FlexiBoarding"] |
| mobile_number | string | |
| current_sis_id | string | SIS id from the school's student information system. |
| is_international | boolean |
{
"name": "orah_update_student",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string"
},
"gender": {
"enum": [
"Male",
"Female",
"Other",
"Unknown"
],
"type": "string"
},
"sis_id": {
"type": "string"
},
"alt_name": {
"type": "string",
"description": "Preferred name."
},
"house_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Orah house id, or null for no house."
},
"diet_info": {
"type": "string"
},
"last_name": {
"type": "string",
"minLength": 1
},
"bed_number": {
"type": "string"
},
"birth_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"first_name": {
"type": "string",
"minLength": 1
},
"student_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah id.",
"exclusiveMinimum": 0
},
"year_level": {
"type": "string"
},
"deactivated": {
"type": "boolean",
"description": "true deactivates the student (hides them from active lists). This server does not offer deletes."
},
"home_number": {
"type": "string"
},
"room_number": {
"type": "string"
},
"house_sis_id": {
"type": "string",
"minLength": 1,
"description": "House SIS id."
},
"medical_info": {
"type": "string"
},
"reference_id": {
"type": "string",
"description": "The school's human-known student id."
},
"student_type": {
"enum": [
"Boarding",
"Day",
"Remote",
"FlexiBoarding"
],
"type": "string"
},
"mobile_number": {
"type": "string"
},
"current_sis_id": {
"type": "string",
"minLength": 1,
"description": "SIS id from the school's student information system."
},
"is_international": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Update student",
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| string | ||
| title | string | Formal title, e.g. Mr. or Mrs. |
| sis_id | string | |
| address | string | |
| last_name * | string | |
| first_name * | string | |
| student_id | integer | Orah id. |
| home_number | string | |
| relationship | string | Relationship to the student, e.g. Mother. |
| mobile_number | string | |
| student_sis_id | string | SIS id from the school's student information system. |
{
"name": "orah_create_contact",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"first_name",
"last_name"
],
"properties": {
"email": {
"type": "string"
},
"title": {
"type": "string",
"description": "Formal title, e.g. Mr. or Mrs."
},
"sis_id": {
"type": "string"
},
"address": {
"type": "string"
},
"last_name": {
"type": "string",
"minLength": 1
},
"first_name": {
"type": "string",
"minLength": 1
},
"student_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah id.",
"exclusiveMinimum": 0
},
"home_number": {
"type": "string"
},
"relationship": {
"type": "string",
"description": "Relationship to the student, e.g. Mother."
},
"mobile_number": {
"type": "string"
},
"student_sis_id": {
"type": "string",
"minLength": 1,
"description": "SIS id from the school's student information system."
}
}
},
"annotations": {
"title": "Create contact",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| string | ||
| title | string | Formal title, e.g. Mr. or Mrs. |
| sis_id | string | |
| address | string | |
| last_name | string | |
| contact_id | integer | |
| first_name | string | |
| student_id | integer | Orah id. |
| home_number | string | |
| relationship | string | Relationship to the student, e.g. Mother. |
| mobile_number | string | |
| contact_sis_id | string | |
| student_sis_id | string | SIS id from the school's student information system. |
{
"name": "orah_update_contact",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string"
},
"title": {
"type": "string",
"description": "Formal title, e.g. Mr. or Mrs."
},
"sis_id": {
"type": "string"
},
"address": {
"type": "string"
},
"last_name": {
"type": "string",
"minLength": 1
},
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"first_name": {
"type": "string",
"minLength": 1
},
"student_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Orah id.",
"exclusiveMinimum": 0
},
"home_number": {
"type": "string"
},
"relationship": {
"type": "string",
"description": "Relationship to the student, e.g. Mother."
},
"mobile_number": {
"type": "string"
},
"contact_sis_id": {
"type": "string",
"minLength": 1
},
"student_sis_id": {
"type": "string",
"minLength": 1,
"description": "SIS id from the school's student information system."
}
}
},
"annotations": {
"title": "Update contact",
"idempotentHint": true,
"destructiveHint": true
}
}Create a house (a student grouping). Orah route: POST /open-api/house/create.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| sis_id | string |
{
"name": "orah_create_house",
"description": "Create a house (a student grouping). Orah route: POST /open-api/house/create.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"sis_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Create house",
"destructiveHint": true
}
}Rename a house or change its SIS id. Give the house's Orah id or SIS id. Orah route: POST /open-api/house/update.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| sis_id | string | |
| house_id | integer | |
| house_sis_id | string |
{
"name": "orah_update_house",
"description": "Rename a house or change its SIS id. Give the house's Orah id or SIS id. Orah route: POST /open-api/house/update.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"sis_id": {
"type": "string"
},
"house_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"house_sis_id": {
"type": "string",
"minLength": 1
}
}
},
"annotations": {
"title": "Update house",
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Orah, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which students are in Year 11 boarding houses?"; "Show me the roll marks for yesterday's first lesson."; "Who is currently on grounds and where are they?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Orah data. Free plan: 50 tool calls per month. Run orah_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run orah_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run orah_upgrade without a plan: it returns both plans, each with a payment link for the user to open. orah_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.