Skip to main content
Glama

✨ Por qué

Armar una evaluación en Orbits es redactar preguntas, ajustar alternativas, revisar, subir y publicar. Con orbits-mcp, ese trabajo lo hace tu agente de código, con tus permisos y sin salir de la terminal:

  • Sin instalar nada. Es un servidor MCP remoto en https://prod.orbits.cl/mcp.

  • Login con un click. El agente abre Orbits en el navegador y tú autorizas. Tu contraseña nunca pasa por el agente.

  • Seguro por defecto. Todo lo que el agente crea queda como borrador y solo se publica cuando tú lo pides.

  • Análisis real. Usa las mismas estadísticas del panel de monitoreo: notas, distribución de puntajes, % de acierto por pregunta y alternativas más elegidas.

Related MCP server: Erstan Agent Tools Beta

🚀 Conéctalo en 30 segundos

claude mcp add --transport http --scope user orbits https://prod.orbits.cl/mcp

Después, en Claude Code: /mcp → orbits → Authenticate.

Con --scope project se guarda en un .mcp.json del proyecto que puedes commitear para tu equipo.

codex mcp add orbits --url https://prod.orbits.cl/mcp
codex mcp login orbits

También puedes agregarlo a mano en ~/.codex/config.toml:

[mcp_servers.orbits]
url = "https://prod.orbits.cl/mcp"

Créalo en .omp/mcp.json (solo en ese proyecto) o en ~/.omp/agent/mcp.json (en todos):

{
  "mcpServers": {
    "orbits": { "type": "http", "url": "https://prod.orbits.cl/mcp" }
  }
}

Después, escribe /mcp en omp. omp también lee la configuración de Claude Code y Codex: si ya lo agregaste ahí con alcance de usuario, no tienes que hacer nada más.

Agrega un servidor MCP remoto (HTTP) con la URL https://prod.orbits.cl/mcp. El cliente detecta el login OAuth automáticamente.

La primera vez se abre Orbits en el navegador. Revisa qué cliente pide acceso y autoriza:

💬 Qué puedes hacer

Habla con tu agente como lo harías con un colega:

Pídele…

Qué hace

"Crea un test de 12 preguntas de fracciones para Matemática 4° Básico, con dos niveles de dificultad"

Lee el formato, revisa los temas del curso y crea el test como borrador

"Exporta el test 383, cambia las preguntas ambiguas y vuelve a subirlo"

Exporta, edita el test.json y lo reimporta

"¿Qué preguntas del test 383 tuvieron peor resultado y qué alternativa incorrecta eligieron más?"

Análisis por pregunta con la distribución de respuestas

"Resume cómo va el curso: promedios por test y quiénes no han rendido"

Resumen del curso a partir del monitoreo

"Publica el test 383"

Lo hace visible para los alumnos. Solo si lo pides, y tu cliente te pide confirmar

Si el test tiene errores, Orbits responde con cada problema y su ubicación (questionSets[0].questionsToShow: …). El agente los corrige y vuelve a intentarlo solo.

Tool

Tipo

Descripción

whoami

lectura

Usuario, rol y URL

list_courses, course_topics

lectura

Cursos y temas

list_tests, get_test, export_test

lectura

Tests, preguntas con solución y bundle exportable

test_results, course_results, student_results, tag_summary, list_attempts

lectura

Resultados y estadísticas

import_test, append_questions

escritura

Crea un test (borrador) o agrega preguntas; imágenes en base64

update_question

escritura

Corrige enunciado, solución o dificultad de una pregunta existente

set_test_published

destructiva

Publica o despublica un test

Recurso: orbits://docs/import-format, con el formato completo de test.json.

🛡️ Administración (solo rol ADMIN)

Con una sesión de administrador, el agente también gestiona cuentas e inscripciones:

Pídele…

Qué hace

"Crea estas 40 cuentas y déjalas en la tag de la Sección B"

Detecta los repitentes (no les toca la clave), te muestra los correos nuevos y, cuando confirmas, crea e inscribe

"Dale acceso al curso de Código a los de Diagramas de este semestre"

Asocia las tags del semestre al otro curso

"Cámbiale la clave a gfuenzalida26@…"

Te pide confirmar y la fija sin pasar por el correo

"Borra la tag de prueba"

Muestra cuántos alumnos y cursos pierden el acceso y espera tu confirmación

Lo que no se puede deshacer pide confirmación: crear cuentas (la API no tiene borrado de usuarios), cambiar claves, borrar tags o cursos y acreditar edubits retroactivos. Si tu cliente soporta elicitation, la pregunta te aparece directamente; si no, la tool responde confirmation_required con un resumen y un confirmToken firmado, válido 5 minutos y solo para esa acción y esos argumentos. Lo reversible (asociar o quitar tags, roles de curso, editar nombres) se ejecuta directo y devuelve cómo revertirlo.

Tool

Tipo

Descripción

find_users, get_user

lectura

Usuarios de cualquier rol, con sus tags y roles de curso

list_tags, get_tag, course_access

lectura

Tags (la inscripción), y quién accede a cada curso

create_users

confirma

Crea cuentas en lote y las inscribe en una tag; salta las que ya existen

update_user

escritura

Nombre, apellido, nickname o institución (devuelve los valores previos)

set_user_password

confirma

Fija la clave de otro usuario

create_tag, add_students_to_tag, link_tag_to_course

escritura

Inscripción

remove_students_from_tag, unlink_tag_from_course

reversible

Quitan acceso

delete_tag

confirma

Borra una tag; con remove_associations la vacía antes

create_course, update_course

escritura

Cursos

delete_course

confirma

Borra un curso (soft delete)

grant_course_role, revoke_course_role

escritura / reversible

Roles docentes (REVIEWER, TEST_CREATOR, COURSE_MANAGER)

assign_monitor_tag, remove_monitor_tag

escritura / reversible

Alumnos que ve un monitor

retroactive_awards_preview, retroactive_awards_execute

lectura / confirma

Edubits que no se acreditaron

La API no permite borrar usuarios ni cambiar su email o su rol global, así que el MCP tampoco.

🔐 Cómo funciona el login

sequenceDiagram
    autonumber
    participant A as Tu agente
    participant M as orbits-mcp
    participant W as orbits.cl
    A->>M: conectar (sin token)
    M-->>A: 401 + cómo autenticarse (OAuth 2.1)
    A->>W: abre el navegador
    Note over W: Inicias sesión y<br/>haces click en Autorizar
    W->>M: autorizado
    M-->>A: código → token personal (90 días)
    A->>M: tools con tu token
  • Tus permisos, no más. El agente actúa como tú: un profe ve los cursos donde tiene rol, y un admin, todo.

  • Revocable. Cada conexión es un token personal que aparece en tu perfil, en Tokens de acceso. Si lo revocas, el agente pierde el acceso de inmediato.

  • Sin contraseñas en el agente. El login ocurre siempre en orbits.cl.

  • El servidor no toca archivos. En modo remoto las imágenes viajan como contenido (base64) y no hay acceso al disco del servidor.

💻 Correrlo localmente

Esta opción sirve para desarrollo, o para que el servidor lea imágenes directamente de tu disco (image_paths). Requiere uv.

claude mcp add orbits -- uvx --from git+https://github.com/osc-ltda/orbit-mcp orbits-mcp
uvx --from git+https://github.com/osc-ltda/orbit-mcp orbits-mcp login   # abre el navegador; guarda el token en ~/.config/orbits

Variable

Uso

ORBITS_URL

URL de la API (por defecto https://prod.orbits.cl/api/v1)

ORBITS_TOKEN

Token personal orb_..., para CI o máquinas sin navegador

🛠️ Desarrollo

uv run pytest
uv run orbits-mcp --help
MCP_SECRET=dev MCP_PUBLIC_URL=http://localhost:8000 uv run orbits-mcp serve-http   # modo remoto (OAuth)

Hecho con FastMCP sobre la API REST de Orbits. Cada push a main publica la imagen ghcr.io/osc-ltda/orbit-mcp:sha-<commit>, y producción se despliega desde orbit-ops.

📄 Licencia

GPL-3.0: úsalo libremente. Si distribuyes una versión modificada, comparte su código bajo la misma licencia.

Available Tools

39 tools
add_students_to_tagAdd Students To TagB

(Admin) Inscribe usuarios existentes (eduserId) en una tag. Los que ya estaban quedan en skipped.

Inputs: tag_id (required), student_ids (required). Returns: object

append_questionsAppend QuestionsA

Agrega preguntas a un test existente (mismo formato test.json; solo se leen formatVersion y questionSets).

Inputs: test (required), test_id (required), images, image_paths. Returns: object

assign_monitor_tagAssign Monitor TagB

(Admin) Asigna una tag a un usuario MONITOR (verá a esos alumnos en su panel).

Inputs: tag_id (required), user_id (required). Returns: object

course_accessCourse AccessB
Read-only

(Admin) Quién accede a un curso: sus tags (con cantidad de alumnos) y los roles docentes.

Inputs: course_id (required). Returns: object

course_resultsCourse ResultsC
Read-only

Resultados agregados de un curso (monitor).

Inputs: course_id (required). Returns: object

course_topicsCourse TopicsC
Read-only

Temas (topics) de un curso.

Inputs: course_id (required). Returns: result

create_courseCreate CourseA

(Admin) Crea un curso. Para que los alumnos lo vean, asócialo a una tag con link_tag_to_course.

Inputs: name (required), description (required), teacher_id, institution_id. Returns: object

create_tagCreate TagA

(Admin) Crea una tag (p. ej. «Solución Algorítmica 2027-1 - Sección A»). Revisa list_tags antes para no duplicar.

Inputs: name (required), description. Returns: object

create_usersCreate UsersA
Destructive

(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.

Inputs: users (required), tag_id, confirm_token. Returns: object

delete_courseDelete CourseB
Destructive

(Admin) Borra un curso (soft delete: deja de aparecer; la API no permite restaurarlo). Pide confirmación.

Inputs: course_id (required), confirm_token. Returns: object

delete_tagDelete TagA
Destructive

(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.

Inputs: tag_id (required), confirm_token, remove_associations. Returns: object

export_testExport TestA
Read-only

Exporta un test en formato de importación: devuelve test.json y los nombres de sus imágenes.

Inputs: test_id (required), save_zip_to. Returns: object

find_usersFind UsersB
Read-only

(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 limit.

Inputs: role, limit, query. Returns: object

get_tagGet TagC
Read-only

(Admin) Una tag con sus cursos, sus usuarios y sus monitores.

Inputs: tag_id (required). Returns: object

get_testGet TestB
Read-only

Detalle de un test y todas sus preguntas (con solución e imagen).

Inputs: test_id (required). Returns: object

get_userGet UserB
Read-only

(Admin) Detalle de un usuario: datos, rol, tags y roles de curso.

Inputs: user_id (required). Returns: object

grant_course_roleGrant Course RoleA

(Admin) Da un rol docente en un curso (REVIEWER, TEST_CREATOR, COURSE_MANAGER). No sirve para alumnos: usa tags.

Inputs: role (required), user_id (required), course_id (required). Returns: object

import_testImport 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.

Inputs: test (required), course_id (required), images, image_paths. Returns: object

list_attemptsList AttemptsC
Read-only

Intentos de tests con filtros opcionales.

Inputs: test_id, end_date, course_id, max_score, +3 more. Returns: result

list_coursesList CoursesB
Read-only

Lista los cursos accesibles para el usuario.

Inputs: search. Returns: object

list_tagsList TagsB
Read-only

(Admin) Todas las tags. Las tags son la inscripción: un alumno ve un curso si comparte una tag con él.

Inputs: no named parameters. Returns: object

list_testsList TestsA
Read-only

Lista tests, opcionalmente filtrados por curso y/o nombre (coincidencia parcial).

Inputs: name, course_id. Returns: object

loginLoginA
Idempotent

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.

Inputs: no named parameters. Returns: object

remove_monitor_tagRemove Monitor TagB
DestructiveIdempotent

(Admin) Quita una tag a un monitor. Reversible con assign_monitor_tag.

Inputs: tag_id (required), user_id (required). Returns: object

remove_students_from_tagRemove Students From TagA
DestructiveIdempotent

(Admin) Saca usuarios de una tag (pierden el acceso a sus cursos). Reversible con add_students_to_tag.

Inputs: tag_id (required), student_ids (required). Returns: object

retroactive_awards_executeRetroactive Awards ExecuteA
Destructive

(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.

Inputs: test_id (required), to_date (required), from_date (required), confirm_token, +1 more. Returns: object

retroactive_awards_previewRetroactive Awards PreviewA
Read-only

(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 eligible; eligibleCount incluye nota 0 y topados.

Inputs: test_id (required), to_date (required), from_date (required), coins_per_question_override. Returns: object

revoke_course_roleRevoke Course RoleA
DestructiveIdempotent

(Admin) Quita un rol docente de un curso. Reversible con grant_course_role.

Inputs: role (required), user_id (required), course_id (required). Returns: object

set_test_publishedSet Test PublishedB
DestructiveIdempotent

Publica (visible para los alumnos) o despublica un test. Úsalo SOLO si el usuario lo pide explícitamente.

Inputs: test_id (required), published (required). Returns: object

set_user_passwordSet User PasswordA
Destructive

(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.

Inputs: user_id (required), new_password (required), confirm_token. Returns: object

student_resultsStudent ResultsC
Read-only

Resultados de un alumno en sus cursos (monitor).

Inputs: student_id (required). Returns: object

tag_summaryTag SummaryC
Read-only

Resumen de resultados de un tag (grupo de alumnos/cursos).

Inputs: tag_id (required). Returns: object

test_resultsTest ResultsC
Read-only

Resultados agregados de un test (monitor).

Inputs: test_id (required). Returns: object

update_courseUpdate CourseA

(Admin) Cambia nombre, descripción, profesor o institución de un curso. Devuelve los valores previos.

Inputs: course_id (required), name, teacher_id, description, +1 more. Returns: object

update_questionUpdate QuestionA
DestructiveIdempotent

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.

Inputs: question_id (required), difficulty, question_text, step_by_step_solution. Returns: object

update_userUpdate 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.

Inputs: user_id (required), nickname, last_name, first_name, +1 more. Returns: object

whoamiWhoamiA
Read-only

Usuario autenticado en Orbits (id, email, nombre, rol) y URL de la API.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 39 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers