Oases MCP by usefulapi

Read students, parents, sessions and invoices; add notes and update fields in Oases.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
99%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,714Tokens (tool definitions)
~1.1 KBTypical response size
Moderate attention impact (1.34% of 128k context)

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-http

What it can do

Tool inventory

Tools (11)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools