orbits-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@orbits-mcp Create a 12-question fractions quiz for 4th grade math with two difficulty levels"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
✨ 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/mcpDespué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 orbitsTambié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 |
"¿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 |
| lectura | Usuario, rol y URL |
| lectura | Cursos y temas |
| lectura | Tests, preguntas con solución y bundle exportable |
| lectura | Resultados y estadísticas |
| escritura | Crea un test (borrador) o agrega preguntas; imágenes en base64 |
| escritura | Corrige enunciado, solución o dificultad de una pregunta existente |
| 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 |
| lectura | Usuarios de cualquier rol, con sus tags y roles de curso |
| lectura | Tags (la inscripción), y quién accede a cada curso |
| confirma | Crea cuentas en lote y las inscribe en una tag; salta las que ya existen |
| escritura | Nombre, apellido, nickname o institución (devuelve los valores previos) |
| confirma | Fija la clave de otro usuario |
| escritura | Inscripción |
| reversible | Quitan acceso |
| confirma | Borra una tag; con |
| escritura | Cursos |
| confirma | Borra un curso (soft delete) |
| escritura / reversible | Roles docentes (REVIEWER, TEST_CREATOR, COURSE_MANAGER) |
| escritura / reversible | Alumnos que ve un monitor |
| 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 tokenTus 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/orbitsVariable | Uso |
| URL de la API (por defecto |
| Token personal |
🛠️ 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 toolsadd_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 AccessBRead-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 ResultsCRead-only
Resultados agregados de un curso (monitor).
Inputs: course_id (required). Returns: object
course_topicsCourse TopicsCRead-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 UsersADestructive
(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 CourseBDestructive
(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 TagADestructive
(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 TestARead-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 UsersBRead-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 TagCRead-only
(Admin) Una tag con sus cursos, sus usuarios y sus monitores.
Inputs: tag_id (required). Returns: object
get_testGet TestBRead-only
Detalle de un test y todas sus preguntas (con solución e imagen).
Inputs: test_id (required). Returns: object
get_userGet UserBRead-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
link_tag_to_courseLink Tag To CourseB
(Admin) Da acceso al curso a todos los alumnos de la tag. Reversible con unlink_tag_from_course.
Inputs: tag_id (required), course_id (required). Returns: object
list_attemptsList AttemptsCRead-only
Intentos de tests con filtros opcionales.
Inputs: test_id, end_date, course_id, max_score, +3 more. Returns: result
list_coursesList CoursesBRead-only
Lista los cursos accesibles para el usuario.
Inputs: search. Returns: object
list_tagsList TagsBRead-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 TestsARead-only
Lista tests, opcionalmente filtrados por curso y/o nombre (coincidencia parcial).
Inputs: name, course_id. Returns: object
loginLoginAIdempotent
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 TagBDestructiveIdempotent
(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 TagADestructiveIdempotent
(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 ExecuteADestructive
(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 PreviewARead-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 RoleADestructiveIdempotent
(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 PublishedBDestructiveIdempotent
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 PasswordADestructive
(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 ResultsCRead-only
Resultados de un alumno en sus cursos (monitor).
Inputs: student_id (required). Returns: object
tag_summaryTag SummaryCRead-only
Resumen de resultados de un tag (grupo de alumnos/cursos).
Inputs: tag_id (required). Returns: object
test_resultsTest ResultsCRead-only
Resultados agregados de un test (monitor).
Inputs: test_id (required). Returns: object
unlink_tag_from_courseUnlink Tag From CourseADestructiveIdempotent
(Admin) Quita a los alumnos de la tag el acceso al curso. Reversible con link_tag_to_course.
Inputs: tag_id (required), course_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 QuestionADestructiveIdempotent
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
whoamiWhoamiARead-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
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.
Maintenance
Related MCP Connectors
Discover, plan and run tools across your connected business systems through one OAuth MCP endpoint
Efficient, MCP-native headless CMS. Agents draft entries and roll back revisions over OAuth.
Query, browse, and automate OmegaAI workspaces from any MCP client. Streamable HTTP with OAuth 2.0.
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to access Canvas LMS academic data such as courses, assignments, grades, and events via MCP tools.-

Erstan Agent Tools Betaofficial
AlicenseNot gradedqualityCmaintenanceEnables building, optimizing, reviewing, and running AI agents and skills, plus managing authorized work items, in Erstan's QA environment via OAuth-authenticated MCP.Apache 2.0- AlicenseAqualityBmaintenanceEnables AI coding agents to read TeamStorm tasks, comments, attachments, and links, and to perform limited write operations such as adding comments and updating task names, descriptions, or statuses through MCP.153MIT

Ridian MCP Serviceofficial
AlicenseNot gradedqualityCmaintenanceEnables authorized users to manage calendars, availability, tasks, contacts, sync operations, and Agent Mailbox email tools through an OAuth-scoped MCP connection.MIT