Librus Read-only MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_ACCESS_TOKEN | No | Bearer token required for remote Streamable HTTP mode. Must be at least 32 characters. Not needed for stdio mode. | |
| ALLOW_INSECURE_HTTP | No | Set to 'true' to allow insecure HTTP for local testing only. Must not be used in public deployments. | |
| LIBRUS_PORTAL_EMAIL | Yes | Email address of the LIBRUS parent account. | |
| LIBRUS_ATTACHMENT_DIR | No | Directory where message attachments are saved. Used in stdio mode. Defaults to ~/Documents/LibrusAttachments on macOS. | |
| LIBRUS_PORTAL_PASSWORD | Yes | Password for the LIBRUS parent account. | |
| LIBRUS_MAX_ATTACHMENT_BYTES | No | Maximum attachment size in bytes. Default is 10485760 (10 MiB). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_studentsA | Lista wszystkich dzieci powiązanych z Kontem LIBRUS. Nie zwraca tokenów. |
| get_student_profileB | Profil jednego dziecka. |
| get_gradesA | Oceny dziecka w podanym zakresie dat. |
| get_attendanceB | Frekwencja dziecka w podanym zakresie dat. |
| get_timetableA | Plan lekcji dziecka; zakres maksymalnie 31 dni, z zastępstwami zwracanymi przez Librus. |
| get_calendarB | Terminarz i dni wolne dziecka w podanym zakresie dat. |
| get_homeworkC | Zadania domowe i przypisane prace dziecka. |
| get_announcementsB | Ogłoszenia szkolne (oddzielne od wiadomości). |
| list_messagesB | Lista wiadomości dziecka, wyłącznie odczyt. |
| get_messageC | Treść pojedynczej wiadomości, wyłącznie odczyt. |
| download_message_attachmentB | Pobiera załącznik należący do wskazanej wiadomości do prywatnego katalogu lokalnego. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Each tool targets a clear and distinct aspect: list_students for all children, get_timetable for schedule, get_grades, get_attendance, etc. No overlaps exist between listing messages and announcements or between fetching a single message and downloading its attachment.
The naming follows a predictable pattern: list_ for multiple items (students, messages) and get_ for single items or specific resources (timetable, profile, grades). The download_message_attachment is also clear and consistent with the rest.
With 11 tools, the server covers all standard read-only facets of a student management system without being excessive. Each tool has a clear and non-redundant purpose, making the count well-scoped.
Given the persistent read-only nature, the tool surface covers all necessary areas: attendance, timetable, grades, homework, calendar, announcements, messages, and attachments. There are no critical missing operations that would prevent typical workflows.