orbits-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_SECRET | No | Secreto usado al ejecutar el servidor en modo remoto con OAuth (serve-http), por ejemplo en desarrollo. | |
| ORBITS_URL | No | URL de la API de Orbits (por defecto https://prod.orbits.cl/api/v1). | https://prod.orbits.cl/api/v1 |
| ORBITS_TOKEN | No | Token personal orb_..., para CI o máquinas sin navegador. | |
| MCP_PUBLIC_URL | No | URL pública del servidor al ejecutarlo en modo remoto con OAuth (serve-http), por ejemplo en desarrollo. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Orbits es una plataforma de evaluaciones. Sesión: si una tool responde que no hay sesión de Orbits, llama la tool login y muestra al usuario el enlace (verificationUriComplete) y el código (userCode); cuando autorice en el navegador, vuelve a llamar login para confirmar. Flujo para crear tests:
Antes de redactar un test lee el recurso orbits://docs/import-format (formato de test.json).
Usa list_courses y course_topics para obtener el course_id y reutilizar los nombres de temas existentes.
import_test crea el test como BORRADOR (no visible para alumnos). append_questions agrega preguntas a un test existente. update_question corrige enunciado, solución o dificultad de una pregunta (parte del texto actual de get_test).
Si el resultado trae ok=false con problems [{path, message}], corrige exactamente esos puntos y reintenta.
set_test_published hace visible el test a los alumnos: úsalo SOLO si el usuario lo pide explícitamente. Análisis: test_results, course_results, student_results, tag_summary y list_attempts. Todos los ids son enteros. Administración (solo rol ADMIN): usuarios (find_users, get_user, create_users, update_user, set_user_password), inscripción por tags (list_tags, get_tag, create_tag, add_students_to_tag, remove_students_from_tag, link_tag_to_course, unlink_tag_from_course, delete_tag), cursos (course_access, create_course, update_course, delete_course), roles docentes y de monitor, y edubits retroactivos. Un alumno ve un curso si comparte una tag con él. Si una tool responde status=confirmation_required, NO repitas la llamada por tu cuenta: muestra el summary al usuario, espera su confirmación explícita y solo entonces repite la llamada con confirm_token.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| loginA | Inicia sesión en Orbits desde el navegador. Si ya hay sesión devuelve el usuario (status ok). Si no, devuelve status pending con un enlace y un código que debes mostrar al usuario; cuando autorice, vuelve a llamar login para confirmar. Llamarla mientras está pendiente no inicia otro flujo. |
| whoamiA | Usuario autenticado en Orbits (id, email, nombre, rol) y URL de la API. |
| list_coursesB | Lista los cursos accesibles para el usuario. |
| course_topicsC | Temas (topics) de un curso. |
| list_testsA | Lista tests, opcionalmente filtrados por curso y/o nombre (coincidencia parcial). |
| get_testB | Detalle de un test y todas sus preguntas (con solución e imagen). |
| update_questionA | Corrige el enunciado, la solución o la dificultad de una pregunta existente (lo omitido no cambia). Reemplaza el texto completo del campo: parte del valor actual (get_test) y conserva saltos de línea e indentación del código. Los alumnos ven el cambio de inmediato; las notas no cambian. |
| import_testA | Crea un test nuevo (BORRADOR, no publicado) en un curso a partir de un test.json. Lee antes orbits://docs/import-format. Si ok=false con problems, corrígelos y reintenta. |
| append_questionsA | Agrega preguntas a un test existente (mismo formato test.json; solo se leen formatVersion y questionSets). |
| export_testA | Exporta un test en formato de importación: devuelve test.json y los nombres de sus imágenes. |
| set_test_publishedB | Publica (visible para los alumnos) o despublica un test. Úsalo SOLO si el usuario lo pide explícitamente. |
| test_resultsC | Resultados agregados de un test (monitor). |
| course_resultsC | Resultados agregados de un curso (monitor). |
| student_resultsC | Resultados de un alumno en sus cursos (monitor). |
| tag_summaryC | Resumen de resultados de un tag (grupo de alumnos/cursos). |
| list_attemptsC | Intentos de tests con filtros opcionales. |
| find_usersB | (Admin) Busca usuarios de cualquier rol por correo o nombre (coincidencia parcial). Devuelve eduserId, email, role, fullName y sus tags. Sin query lista los primeros |
| get_userB | (Admin) Detalle de un usuario: datos, rol, tags y roles de curso. |
| list_tagsB | (Admin) Todas las tags. Las tags son la inscripción: un alumno ve un curso si comparte una tag con él. |
| get_tagC | (Admin) Una tag con sus cursos, sus usuarios y sus monitores. |
| course_accessB | (Admin) Quién accede a un curso: sus tags (con cantidad de alumnos) y los roles docentes. |
| create_usersA | (Admin) Crea cuentas y, opcionalmente, las inscribe en una tag. Pide confirmación (no hay borrado de usuarios). Los correos que ya existen NO se recrean ni se les cambia la clave (repitentes): solo se agregan a la tag. |
| update_userA | (Admin) Cambia nombre, apellido, nickname o institución de un usuario. Devuelve los valores previos. La API no permite cambiar email ni rol global. |
| set_user_passwordA | (Admin) Fija la clave de otro usuario sin pasar por el correo. Pide confirmación (la clave anterior se pierde). Pisa cualquier clave que el usuario haya puesto con «olvidé mi contraseña». Si la nueva clave es un RUT, Orbits le pedirá cambiarla al iniciar sesión. La clave nunca se devuelve ni se registra. |
| create_tagA | (Admin) Crea una tag (p. ej. «Solución Algorítmica 2027-1 - Sección A»). Revisa list_tags antes para no duplicar. |
| link_tag_to_courseB | (Admin) Da acceso al curso a todos los alumnos de la tag. Reversible con unlink_tag_from_course. |
| unlink_tag_from_courseA | (Admin) Quita a los alumnos de la tag el acceso al curso. Reversible con link_tag_to_course. |
| add_students_to_tagB | (Admin) Inscribe usuarios existentes (eduserId) en una tag. Los que ya estaban quedan en skipped. |
| remove_students_from_tagA | (Admin) Saca usuarios de una tag (pierden el acceso a sus cursos). Reversible con add_students_to_tag. |
| delete_tagA | (Admin) Borra una tag. Pide confirmación. La API solo borra tags sin alumnos ni cursos. Con remove_associations=true primero los desasocia (los alumnos pierden el acceso que les daba esa tag) y devuelve la lista para poder rehacerlo. |
| create_courseA | (Admin) Crea un curso. Para que los alumnos lo vean, asócialo a una tag con link_tag_to_course. |
| update_courseA | (Admin) Cambia nombre, descripción, profesor o institución de un curso. Devuelve los valores previos. |
| delete_courseB | (Admin) Borra un curso (soft delete: deja de aparecer; la API no permite restaurarlo). Pide confirmación. |
| grant_course_roleA | (Admin) Da un rol docente en un curso (REVIEWER, TEST_CREATOR, COURSE_MANAGER). No sirve para alumnos: usa tags. |
| revoke_course_roleA | (Admin) Quita un rol docente de un curso. Reversible con grant_course_role. |
| assign_monitor_tagB | (Admin) Asigna una tag a un usuario MONITOR (verá a esos alumnos en su panel). |
| remove_monitor_tagB | (Admin) Quita una tag a un monitor. Reversible con assign_monitor_tag. |
| retroactive_awards_previewA | (Admin) Simula los edubits que faltan acreditar de un test en un rango (ISO UTC, p. ej. 2026-08-01T00:00:00Z). La deuda real es la suma de awardedAmount > 0 en |
| retroactive_awards_executeA | (Admin) Acredita en edubank los edubits pendientes de un test en un rango. Pide confirmación. Recomendado: rangos de un intento ([finishedAt - 1 s, finishedAt + 1 s]) en orden cronológico, así se respeta el tope por alumno. Los ya acreditados se saltan solos. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| login | Iniciar sesión en Orbits |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| import_format | Formato del bundle de importación de tests (test.json + images/). |
TDQS
Scored across 39 tools
Most tools target a distinct resource+action: course, tag, user, test, question, and result operations are cleanly separated, and preview/execute and link/unlink pairs are explicitly distinguished in their descriptions. Minor overlap remains among the reporting tools (test_results, course_results, student_results, tag_summary, list_attempts) and between course_topics and course_access, where an agent could hesitate about which aggregate view to use.
Names are uniformly snake_case and mostly follow verb_noun (create_course, update_course, delete_tag, list_tests, get_test, find_users). The main deviation is the noun-first convention used for reporting/lookup tools (course_topics, course_access, test_results, tag_summary), which is internally fairly consistent but breaks the verb_noun pattern; create_users plural vs create_tag singular is a small inconsistency.
39 tools is heavy for an LMS admin surface and many are near-mechanical reversible pairs (link/unlink_tag_to_course, add/remove_students_from_tag, assign/remove_monitor_tag, grant/revoke_course_role) that could be consolidated into single tools with an action parameter. The breadth of the domain (users, tags, courses, tests, questions, results, edubits) justifies a large surface, but the count still exceeds a comfortable agent-facing set.
Coverage is broad: auth, user creation/update/password, tag lifecycle plus membership and monitor assignment, course CRUD with roles and access inspection, test import/export/append/publish, question update, and multiple result views plus edubit retroactive crediting. Remaining gaps are modest and partly API-imposed: no test deletion, no single-question creation or removal, and no user deletion, but agents can work around these via import/export and append operations.