Oases MCP by usefulapi
Read students, parents, sessions and invoices; add notes and update fields in Oases.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
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-httpQué puede hacer
Inventario de herramientas
Herramientas (11)
🟢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
Evidencia