schoolpass-mcp

Servidor MCP para SchoolPass — lee Y cambia la llegada y salida escolar de tu hijo desde una cuenta de padre. Habla con la API REST de SchoolPass utilizada por las aplicaciones web y móviles de SchoolPass, autenticando en el servidor con tu propio correo y contraseña de padre (sin navegador, sin extensión).

Desarrollado y mantenido por IA (Claude Code). Úsalo bajo tu propio criterio.

Alcance de padre: herramientas de lectura más una escritura/cancelación de cambio de salida con confirmación.

Herramientas

Configuración

Cómo encontrar tu id de escuela y host regional: inicia sesión en el portal <school>.school-pass.net de tu escuela, abre la nueva aplicación SchoolPass y lee appCode (el id) y apiUrl (el host) desde su localStorage del navegador.

Instalación

{
  "mcpServers": {
    "schoolpass": {
      "command": "npx",
      "args": ["-y", "schoolpass-mcp"],
      "env": {
        "SCHOOLPASS_EMAIL": "you@example.com",
        "SCHOOLPASS_PASSWORD": "your-password",
        "SCHOOLPASS_SCHOOL_CODE": "1183"
      }
    }
  }
}

Notas

• Solo alcance de padre. Un token de padre no puede acceder a rutas de administración (gestión de visitantes, operaciones de carline, informes, enrutamiento de autobuses); esas devuelven 403.

• Nunca reintentes un inicio de sesión rechazado. SchoolPass protege su inicio de sesión con reCAPTCHA; los fallos repetidos pueden hacer que la cuenta sea cuestionada.

• Sin credenciales, aún arranca. El servidor se inicia sin configuración y responde a tools/list; el error de configuración aparece en la primera llamada a una herramienta.

Sin el servidor: curl

La API de SchoolPass es accesible desde el servidor, por lo que una lectura puntual desde la shell no necesita un proceso MCP: consulta la habilidad schoolpass-curl incluida (skills/schoolpass-curl/) para un conjunto de recetas con curl + jq.

Desarrollo

npm install
npm test            # unit + boot tests
npm run build       # tsc + esbuild bundle
node --env-file=.env scripts/live-check.mjs   # live read-only check (needs .env)

Licencia

MIT