Skip to main content
Glama
fuxam-student-mcp

fuxam-student-mcp

Fuxam Student MCP

Use Codex, Claude, and other local MCP clients to explore your Fuxam modules, learning units, progress, schedule, and semester options.

The server runs on your computer and talks directly to Fuxam. It gives the agent useful source facts and composable tools instead of trying to choose a semester for you.

Let your agent set it up

Copy this prompt into a new chat with Codex or Claude:

Set up Fuxam Student MCP for me using this documentation:
https://codecampus.tools/docs/fuxam-student-mcp

Detect which supported MCP client I am using and follow only its current instructions. Install the latest public release locally and configure it as a stdio MCP server. Complete every step you can directly, and pause only for a client UI or secret-entry action I must perform.

Never ask me to paste my Fuxam `__client` cookie into this chat, and never print or log it. When the credential is required, tell me exactly how to enter it directly into the client's local MCP configuration or secure installer prompt.

After configuration:
1. Verify the MCP entry exists without displaying the credential.
2. Start the server and confirm its tools are available.
3. Tell me if I need to restart the client or open a new chat.
4. Run one read-only check: show the module categories and learning units I can currently choose from.

Do not book or unbook courses, or join or leave waitlists, during setup.

Prefer to install it yourself? Follow the manual steps below.

Related MCP server: MCP UJI Academic Server

Requirements

  • A CODE University Fuxam account

  • Node.js 26 or newer for command-line installation

  • Codex, Claude Code, or Claude Desktop

Fuxam's short-lived session tokens are renewed from its Clerk __client cookie.

  1. Sign in at fuxam.app in your browser.

  2. Open the browser developer tools.

  3. In the application/storage cookie view, select https://clerk.fuxam.app.

  4. Copy the value of the __client cookie.

Treat this value like a password. Do not paste it into chat, commit it, or include it in screenshots.

Install

ChatGPT/Codex app and Codex CLI

The installed ChatGPT/Codex app and Codex CLI share the local Codex MCP configuration:

codex mcp add fuxam \
  --env FUXAM_CLERK_CLIENT='<your __client cookie>' \
  -- npx -y fuxam-student-mcp

Open a new Codex task after adding the server.

Claude Code

claude mcp add --scope user \
  -e FUXAM_CLERK_CLIENT='<your __client cookie>' \
  fuxam -- npx -y fuxam-student-mcp

Claude Desktop

Download the .mcpb file from the matching GitHub Release, open it with Claude Desktop, and paste the Clerk cookie when prompted. The bundle runs the same MCP locally and marks the cookie as sensitive configuration.

Other local MCP clients

Configure a stdio server with this executable and environment variable:

{
  "command": "npx",
  "args": ["-y", "fuxam-student-mcp"],
  "env": {
    "FUXAM_CLERK_CLIENT": "<your __client cookie>"
  }
}

The outer configuration key differs between clients. Use the client's normal local stdio MCP settings.

Try it

Good first prompts include:

  • “Show me the module categories and learning units I can currently choose from.”

  • “Help me compare these three modules, including requirements, progress, instructors, dates, and workload.”

  • “Look at my study plan and current progress, then help me assemble a realistic semester.”

  • “Check whether this proposed set of learning units has scheduling conflicts.”

  • “What deadlines and appointments do I have over the next month?”

The agent can browse by category/tag or text, batch-inspect modules and learning units, compare the result with your progress, and check a proposed course set for conflicts.

Capabilities

Planning and discovery:

  • explore_learning_options

  • search_fuxam

  • get_study_plan

  • list_enrolled_courses

  • list_bookable_courses

  • get_learning_unit_details

  • get_module_details

  • get_module_attempts

  • get_exam_details

Schedule and workload:

  • list_student_appointments

  • list_course_appointments

  • list_course_deadlines

  • list_applicable_excluded_dates

  • list_todos

  • list_pinned_courses

  • get_layer_path

  • check_course_conflicts

Account changes:

  • book_course

  • unbook_course

  • join_waitlist

  • leave_waitlist

The four account-change tools affect your real Fuxam account. They are marked as write operations for MCP clients, and each mutation verifies the resulting Fuxam state. Booking does not silently run a conflict check first.

How agents should use it

For open-ended planning, start with explore_learning_options and list_enrolled_courses. Narrow by category or search query, then batch the shortlist through get_module_details, get_learning_unit_details, and get_module_attempts. Check the complete proposed set with check_course_conflicts before presenting the tradeoffs.

Identifier names matter:

  • course id is used for booking, waitlists, and conflict checks;

  • layerId or layer_id is used for appointments and deadlines;

  • courseModuleId is the stable module ID;

  • moduleVersionId identifies one curriculum version;

  • organizationTermId identifies an academic term.

Fuxam import-derived completion totals can occasionally lag behind concrete attempt or gradedAt records. Agents should prefer the concrete records when they disagree.

Troubleshooting

FUXAM_AUTH_REQUIRED

: Sign in to Fuxam again, copy the current Clerk __client cookie, remove the old MCP entry, and add it again with the new value.

codex mcp remove fuxam
claude mcp remove --scope user fuxam

FUXAM_UNSUPPORTED_INSTITUTION

: This release supports the CODE University Fuxam environment.

FUXAM_CONTEXT_REQUIRED

: The server could not identify one active cohort and study-program context. Include the full error when opening an issue, but never include your cookie, headers, or raw Fuxam response data.

Partial results

: Some curated reads combine several Fuxam sections. If an optional upstream section is temporarily unavailable, the MCP returns the sections it could retrieve with partial: true and identifies what can be retried.

Privacy

Version 0.1 collects no telemetry. Your Fuxam credential and student data remain on your computer except for direct requests from the local MCP to Fuxam and Clerk. Tool results are sent to the MCP client you chose, subject to that client's own data controls.

License

Noncommercial use is licensed under the PolyForm Noncommercial License 1.0.0. Commercial use requires a separate written license from Maximilian Spitzer; contact the author through GitHub.

Development

npm ci
npm run check
npm run test:package
npm run package:mcpb

The package smoke test installs the generated npm tarball in a clean temporary directory, negotiates MCP over stdio, lists its tools, and verifies the credential-free startup behavior. Tests never use a live student credential or perform a Fuxam mutation.

Project status

This is an unofficial student-built client, published with permission from CODE University and Fuxam. Fuxam remains the source of truth for academic records, requirements, availability, and account state.

Available Tools

21 tools
book_courseBook CourseA

Book one learning-unit course ID on the real student account and verify it with a fresh enrolled-course read. This does not implicitly check conflicts; call check_course_conflicts first when schedule compatibility matters.

Inputs: courseId (required).

check_course_conflictsCheck Course ConflictsA
Read-onlyIdempotent

Ask Fuxam to evaluate a proposed set of learning-unit course IDs against one another and known appointments. An empty upstream array means Fuxam reported no conflict. This tool does not book or modify anything.

Inputs: courseIds (required), includeAppointmentsForCourseIds.

explore_learning_optionsExplore Learning OptionsA
Read-onlyIdempotent

Explore the catalog when the student does not yet know module or LU names. With no filters, returns the complete raw study plan, elective-group facets with module/current-LU counts, and concise summaries of all current bookable LUs. It tolerates an unavailable study-plan or catalog section and reports partial results in warnings. Call it again with electiveGroupIds to browse those categories or with query for thematic text search. Then use get_module_details and get_learning_unit_details for the shortlist.

Inputs: query, electiveGroupIds.

get_exam_detailsGet Exam DetailsB
Read-onlyIdempotent

Drill into one assessment attempt. Returns dates, scheduling, submission eligibility, published outcome, request history, alternative-assessment state, and academic gates unchanged. Omit cohortId to use the configured student's cohort.

Inputs: examId (required), moduleVersionId (required), organizationTermId (required), cohortId, +1 more.

get_layer_pathGet Layer PathA
Read-onlyIdempotent

Resolve a Fuxam layer ID to its structural hierarchy. This is useful for understanding where a course, module, or content layer sits in the curriculum or organization tree.

Inputs: layerId (required).

get_learning_unit_detailsGet Learning Unit DetailsA
Read-onlyIdempotent

Batch-inspect several learning-unit course IDs. Returns each complete current course record plus a large page of its appointments and deadlines, preserving upstream fields. Missing IDs are reported separately; schedule or deadline sections report unavailable when Fuxam exposes the catalog LU but withholds that course endpoint. Use this after narrowing a semester shortlist; it does not rank, check conflicts, or mutate anything.

Inputs: courseIds (required), language, includeDeadlines, includeAppointments.

get_module_attemptsGet Module AttemptsA
Read-onlyIdempotent

Batch attempt history, assessment requirements, attendance fulfillment, grades, and academic rules for several module versions. Each module is returned independently so one unavailable record does not discard the others. Use moduleVersionIds from the study plan or courses' connectedModule records.

Inputs: moduleVersionIds (required).

get_module_detailsGet Module DetailsA
Read-onlyIdempotent

Batch-inspect several module versions. For each module, returns Fuxam's catalog settings and requirements, module information, associated learning units for the optional academic term, and the student's attempt and academic-rule state. In a learning-unit connectedModule record, pass moduleId as courseModuleId and pass moduleVersionId unchanged.

Inputs: modules (required).

get_study_planGet Study PlanA
Read-onlyIdempotent

Return the student's module elections, elective pools, available terms, attempt summaries, and study-plan state unchanged. Use returned organizationTermId and moduleVersion.id values with the drill-down tools.

Inputs: focusId, organizationTermId.

join_waitlistJoin WaitlistB

Join a course waitlist on the real student account and re-read the booking catalog to report the resulting position.

Inputs: courseId (required).

leave_waitlistLeave WaitlistA
Destructive

Leave a course waitlist on the real student account and re-read the booking catalog to verify the resulting state.

Inputs: courseId (required).

list_applicable_excluded_datesList Applicable Excluded DatesA
Read-onlyIdempotent

Return institution-wide excluded dates applicable to the student in an ISO-8601 date or datetime interval, such as holidays or closure periods that affect scheduling.

Inputs: to (required), from (required).

list_bookable_coursesList Bookable CoursesA
Read-onlyIdempotent

Return one upstream page of bookable learning units unchanged, including capacity, enrollment, waitlist state, descriptions, and connected modules. Use id for booking/waitlists, layerId for course schedules, and connectedModule.moduleVersionId for curriculum tools. Follow pageCount to inspect further pages.

Inputs: page, search, perPage.

list_course_appointmentsList Course AppointmentsA
Read-onlyIdempotent

Return one course's appointment page unchanged. Supply layerId from enrolled or bookable course data, not the learning-unit course id.

Inputs: layerId (required), limit, cursor, direction.

list_course_deadlinesList Course DeadlinesB
Read-onlyIdempotent

Return one course's deadline items and pagination metadata unchanged. Supply layerId from enrolled or bookable course data.

Inputs: layerId (required), limit, cursor, language.

list_enrolled_coursesList Enrolled CoursesA
Read-onlyIdempotent

Return the student's enrolled course records unchanged, including descriptions, educators, tags, content blocks, status, and identifiers. A course id and layer_id are different identifiers.

Inputs: search.

list_pinned_coursesList Pinned CoursesA
Read-onlyIdempotent

Return the student's pinned-course records unchanged. Pinned courses can indicate the student's current working set but are not a recommendation signal.

Inputs: no named parameters.

list_student_appointmentsList Student AppointmentsC
Read-onlyIdempotent

Return one page of the student's agenda unchanged, including appointment times, locations, organizers, attendance settings, and pagination state. Use the returned cursor for another page.

Inputs: limit, cursor, direction, showPastAppointments.

list_todosList To-DosA
Read-onlyIdempotent

Return the student's Fuxam content-block workload and current statuses unchanged. This exposes concrete outstanding, in-progress, completed, reviewed, and locked work for planning workload.

Inputs: showLocked, timePeriod, showReviewed, showCompleted, +2 more.

search_fuxamSearch FuxamA
Read-onlyIdempotent

Search Fuxam entities and return the upstream result unchanged. Use this to discover course, module, term, appointment, and exam IDs before calling specialized tools.

Inputs: query (required), limit, types, offset.

unbook_courseUnbook CourseA
Destructive

Unbook one learning-unit course ID from the real student account and verify its absence with a fresh enrolled-course read.

Inputs: courseId (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 21 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose, ranging from search and listing to booking and waitlist management. Overlaps like list_enrolled_courses vs list_bookable_courses are differentiated by their scope (enrolled vs bookable), and get_learning_unit_details vs get_module_details target different entities.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern (list_*, get_*, book_*, unbook_*, join_*, leave_*). Minor inconsistencies exist, such as 'search_fuxam' and 'explore_learning_options' not using the same prefix structure, but the overall naming is coherent and readable.

    Tool Count4/5

    With 21 tools, the set is fairly large but justified by the breadth of student operations: reading data, booking, waitlists, conflict checking, and scheduling. The count is on the higher end but still within a reasonable range for a comprehensive student management server.

    Completeness4/5

    The tool surface covers core student actions: search, list, view details, book/unbook, join/leave waitlists, check conflicts, and access appointments, deadlines, exams, todos, and pinned courses. Minor gaps like a dedicated 'get_student_info' or update operation exist, but the core domain is well represented.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers