Oases MCP by usefulapi

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

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
99%
Calidad de los nombres
80%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~1,714Tokens (definiciones de herramientas)
~1.1 KBTamaño de respuesta típico
Impacto moderado en la atención (1.34% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "oases": {
      "url": "https://oases.usefulapi.io/mcp"
    }
  }
}

Puntos de conexión remotos

https://oases.usefulapi.io/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (11)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢oases_get_student(student_id)

Get one student record by id. Oases API: GET /v2/student/{id}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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).

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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"
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada11 herramientas