Oases MCP by usefulapi
Read students, parents, sessions and invoices; add notes and update fields in Oases.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"oases": {
"url": "https://oases.usefulapi.io/mcp"
}
}
}Remote endpoints
https://oases.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢oases_get_student(student_id)
Get one student record by id. Oases API: GET /v2/student/{id}.
Input Schema
{
"type": "object",
"properties": {
"student_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The student id (numeric)."
}
},
"required": [
"student_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oases_get_parent(parent_id)
Get one parent record by id. Oases API: GET /v2/parent/{id}.
Input Schema
{
"type": "object",
"properties": {
"parent_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The parent id (numeric)."
}
},
"required": [
"parent_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oases_get_staff(staff_id)
Get one staff member record (tutor or staff) by id. Oases API: GET /v2/staff/{id}.
Input Schema
{
"type": "object",
"properties": {
"staff_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The staff member id (numeric)."
}
},
"required": [
"staff_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oases_get_session(session_id)
Get one tutoring session record by id. Oases API: GET /v2/session/{id}.
Input Schema
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The session id (numeric)."
}
},
"required": [
"session_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oases_get_invoice(invoice_id)
Get one invoice by id, with its line items. Oases API: GET /v2/invoice/{id}.
Input Schema
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The invoice id (numeric)."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oases_get_payment(payment_id)
Get one payment record by id. Oases API: GET /v2/payment/{id}.
Input Schema
{
"type": "object",
"properties": {
"payment_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The payment id (numeric)."
}
},
"required": [
"payment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oases_get_notes(note_type, note_parent)
List the notes on one student, parent or tutor, or schedule. Oases API: GET /v2/note/{note_type}/{note_parent}.
Input Schema
{
"type": "object",
"properties": {
"note_type": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 5
}
],
"description": "Record type of the note parent: 1 = student, 2 = tutor or parent, 5 = schedule."
},
"note_parent": {
"type": "string",
"pattern": "^\\d+$",
"description": "The note parent (student, parent, tutor or schedule) id (numeric)."
}
},
"required": [
"note_type",
"note_parent"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oases_get_list(name)
Read one reference list, such as states, schools, grades, session types or custom fields. Oases API: GET /v2/lists/{name}.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"enum": [
"states",
"schools",
"districts",
"grades",
"subjlev",
"sesstype",
"assignstat",
"stafftags",
"studenttags",
"parenttags",
"instrfocus",
"customfields_student",
"customfields_session",
"customfields_schedule",
"customfields_parent",
"customfields_staff"
],
"description": "The reference list to read."
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oases_create_note(note_type, note_parent, note_date, note_owner, note_subject, ...)
Add a note to a student, parent or tutor, or schedule. This creates a new record each time it runs. Oases API: PUT /v2/note (form data).
Input Schema
{
"type": "object",
"properties": {
"note_type": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 5
}
],
"description": "Record type of the note parent: 1 = student, 2 = tutor or parent, 5 = schedule."
},
"note_parent": {
"type": "string",
"pattern": "^\\d+$",
"description": "The note parent (student, parent, tutor or schedule) id (numeric)."
},
"note_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Date and time of the note, for example 2026-11-10 09:30:00."
},
"note_owner": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Name of the person who writes the note."
},
"note_subject": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Subject of the note."
},
"note_text": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "Text of the note."
},
"note_category": {
"type": "string",
"enum": [
"PH",
"MTG",
"OB",
"OTH",
"AUD"
],
"description": "Category: PH = phone call, MTG = meeting, OB = onboarding, OTH = other, AUD = audit."
}
},
"required": [
"note_type",
"note_parent",
"note_date",
"note_owner",
"note_subject",
"note_text",
"note_category"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oases_update_student(student_id, fieldname, value)
Change one field of a student record. Oases API: POST /v2/student/{id} with fieldname and value.
Input Schema
{
"type": "object",
"properties": {
"student_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The student id (numeric)."
},
"fieldname": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The record field to change, as Oases names it."
},
"value": {
"type": "string",
"maxLength": 5000,
"description": "The new value for the field."
}
},
"required": [
"student_id",
"fieldname",
"value"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oases_update_parent(parent_id, fieldname, value)
Change one field of a parent record. Oases API: POST /v2/parent/{id} with fieldname and value.
Input Schema
{
"type": "object",
"properties": {
"parent_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The parent id (numeric)."
},
"fieldname": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The record field to change, as Oases names it."
},
"value": {
"type": "string",
"maxLength": 5000,
"description": "The new value for the field."
}
},
"required": [
"parent_id",
"fieldname",
"value"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence