Skip to main content
Glama
illlilililiililll

LearnUs local MCP server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LEARNUS_IDYes로컬 프로세스 인증정보
LEARNUS_PASSWORDYes로컬 프로세스 인증정보
LEARNUS_INTEGRATIONNo실계정 read-only 검증 opt-in0
LEARNUS_CACHE_ENABLEDNo0은 일반 TTL cache 비활성화, 기능별 cache 유지1
LEARNUS_DOWNLOAD_ROOTNo다운로드 루트 디렉터리 (미설정 시 ~/Documents/LearnUS)~/Documents/LearnUS
LEARNUS_MAX_DOWNLOAD_BYTESNo최대 다운로드 바이트 수52428800
LEARNUS_DOWNLOAD_INTEGRATIONNo별도 다운로드 integration opt-in0
LEARNUS_MAX_CONCURRENT_REQUESTSNo최대 동시 요청 수 (1~32)4
LEARNUS_COURSE_CONTEXT_OVERRIDESNo선택적 course ID별 audienceTags JSON

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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
learnus_auth_statusA

Reports whether the current MCP process has an authenticated LearnUs session. Use only when the user explicitly asks whether LearnUs is logged in or whether the session is alive. Do not use it as a prerequisite for a data request; data Tools authenticate automatically and a false status does not imply manual browser login is needed.

learnus_list_coursesA

Lists the user’s current LearnUs courses and canonical Moodle course IDs. Use when the user asks which courses/classes they are taking or when another LearnUs Tool needs an exact course ID. Do not use it for activity, assignment or file details inside a known course.

learnus_get_courseA

Gets one known LearnUs course with its normalized structure and activities. Use when an exact course is known and the user asks for that course’s contents or structure. Do not use it to discover all enrolled courses or to fetch full assignment/announcement details.

learnus_list_activitiesA

Lists assignments, VODs, resources, folders, boards and unknown activity types in one course. Use when the user asks what activities or learning materials exist in a known course, or when a cmid must be discovered. Do not use it for full activity details or cross-course coursework summaries.

learnus_get_assignmentA

Gets one assignment’s instructions, due date, attachments and submission/grading status by canonical activity cmid. Use when the user asks for details or status of a specific known assignment. Do not use it to search for assignments across courses or to submit/edit an assignment.

learnus_upcomingA

Lists canonical LearnUs calendar events and deadlines in a date range, optionally for one course. Use when the user asks for calendar events, schedules or deadlines between specific dates. Do not use it to infer task completion or required attendance; use learnus_get_weekly_tasks for actionable weekly coursework. Date-only values use Asia/Seoul; timestamps require a timezone.

learnus_list_announcementsA

Lists normalized LearnUs ubboard announcement summaries, newest dated items first. Use when the user asks for recent course notices or announcements, optionally in one known course. Do not use it for a full announcement body; use learnus_get_announcement with known module/article IDs.

learnus_get_announcementA

Gets one normalized LearnUs announcement body and registers its attachments as fileIds. Use when the user asks to read a specific announcement already identified by moduleId and articleId. Do not use it to list or search announcements, or to mark a notice read.

learnus_list_notificationsA

Lists normalized LearnUs account notifications without marking them read. Use when the user asks about recent LearnUs alerts or notifications. Do not use it to infer a required task merely from a new-file notice; notifications are informational without explicit action evidence.

learnus_list_videosA

Lists VOD activities in one course with canonical IDs, audience applicability and separate availability/instructional deadlines. Use when the user asks what course videos exist or for video metadata in a known course. Do not use it to determine actual attendance/progress status; use learnus_get_video_attendance or learnus_get_learning_overview.

learnus_get_video_attendanceA

Gets canonical completion, viewing progress, attendance target and attendance status for a course or one known video. Use when the user asks whether a specific course video was watched, completed or counted for attendance. Do not use it to play a video or infer attendance from its title.

learnus_get_learning_overviewA

Summarizes required incomplete, completed, optional/excluded and unknown VOD learning states. Use when the user asks about course video learning, completion or attendance across a course or week. Do not use it for broad non-video coursework or to treat an unknown target/deadline as a confirmed obligation.

learnus_list_filesA

Discovers safe downloadable course materials, PDFs and attachments and returns opaque fileIds plus Moodle completion state. Use when the user explicitly asks for course files, lecture materials, PDFs, attachments or downloads. Do not use it to download arbitrary URLs or to assume an existing/new file still needs review.

learnus_download_fileA

Downloads one previously discovered LearnUs fileId into the configured local LearnUS directory. Use only when the user explicitly asks to download that file. Prefer this Tool over browser download for supported fileIds. It reads remote LearnUs data but creates a local file without overwriting; it does not modify LearnUs. Do not pass URLs or guessed IDs. Browser fallback is allowed only when MCP reports the file/capability unsupported or explicit visual interaction is required.

learnus_get_overviewA

Gets a configurable broad LearnUs coursework summary covering assignments, calendar deadlines, announcements, notifications and optional learning/attendance. Use as the default broad LearnUs retrieval Tool when a request spans multiple categories or the exact underlying resource is not yet known, such as what is new, what matters or what is happening across classes. Do not use it solely for generic personal to-do/calendar questions or for a focused request that maps cleanly to a narrower Tool. For weekly actionable coursework specifically, prefer learnus_get_weekly_tasks. Informational, completed and unknown items remain distinct.

learnus_get_weekly_tasksA

Gets actionable Yonsei LearnUs coursework for the current or requested week: assignments, deadlines, required incomplete learning and attendance items. Use as the default LearnUs Tool when a request clearly concerns Yonsei coursework, classes, assignments, academic deadlines, required lecture videos, incomplete learning or attendance obligations, even without the words LearnUs/런어스. Do not use it for unrelated personal to-do/calendar questions or to treat informational/completed/optional/unknown items as required tasks. Typical requests ask what coursework remains this week, which assignments are due, or whether required videos are incomplete. Calendar entries alone do not prove an unfinished task.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 16 tools

Disambiguation4/5

Tools mostly target distinct resource+action pairs (list courses, get assignment, list videos), and descriptions explicitly state when not to use them. However, several summary tools (learnus_get_overview, learnus_get_weekly_tasks, learnus_upcoming) and announcement/notification tools overlap in purpose, requiring careful reading to avoid misselection.

Naming Consistency4/5

All tools use the learnus_ prefix and snake_case, with most following a verb_noun pattern (list_, get_, download_). Exceptions like learnus_upcoming and learnus_auth_status are minor deviations from the verb_noun convention. Consistent enough for predictability.

Tool Count4/5

16 tools is slightly above the typical 3–15 range but justified by the breadth of LMS resources (courses, activities, assignments, videos, files, notifications, summaries). Each tool appears to serve a specific retrieval granularity, though the set is on the heavy side.

Completeness4/5

The surface covers course discovery, activity/assignment details, calendar, announcements, notifications, videos, files with download, and aggregated overviews. Missing grade retrieval or assignment submission, but those may be outside the stated retrieval scope; minor gaps only.

Maintenance

ActivityMaintained
ResponsivenessNo issues