fuxam-student-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., "@fuxam-student-mcp Compare these three modules and check my proposed semester for conflicts."
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.
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
Get your Fuxam session cookie
Fuxam's short-lived session tokens are renewed from its Clerk __client cookie.
Sign in at fuxam.app in your browser.
Open the browser developer tools.
In the application/storage cookie view, select
https://clerk.fuxam.app.Copy the value of the
__clientcookie.
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-mcpOpen 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-mcpClaude 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_optionssearch_fuxamget_study_planlist_enrolled_courseslist_bookable_coursesget_learning_unit_detailsget_module_detailsget_module_attemptsget_exam_details
Schedule and workload:
list_student_appointmentslist_course_appointmentslist_course_deadlineslist_applicable_excluded_dateslist_todoslist_pinned_coursesget_layer_pathcheck_course_conflicts
Account changes:
book_courseunbook_coursejoin_waitlistleave_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
idis used for booking, waitlists, and conflict checks;layerIdorlayer_idis used for appointments and deadlines;courseModuleIdis the stable module ID;moduleVersionIdidentifies one curriculum version;organizationTermIdidentifies 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 fuxamFUXAM_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:mcpbThe 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 toolsbook_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 ConflictsARead-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 OptionsARead-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 DetailsBRead-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 PathARead-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 DetailsARead-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 AttemptsARead-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 DetailsARead-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 PlanARead-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 WaitlistADestructive
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 DatesARead-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 CoursesARead-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 AppointmentsARead-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 DeadlinesBRead-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 CoursesARead-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 CoursesARead-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 AppointmentsCRead-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-DosARead-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 FuxamARead-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 CourseADestructive
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
Scored across 21 tools
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.
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.
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.
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
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Model Context Protocol server for Studex tools, notifications, and profile integrations
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Remote MCP for TehProf Booking: browse resources & availability, create & cancel reservations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables querying academic data from Universitat Jaume I, including subjects, degrees, locations, and schedules, via MCP-compatible clients.MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying academic data such as subjects, degrees, locations, and schedules from Universitat Jaume I via MCP tools.MIT
- FlicenseNot gradedqualityDmaintenanceRemote MCP connector providing live, structured access to CMU Courses public data including courses, prerequisites, schedules, instructors, gen-eds, and final-exam times to help students plan schedules.-
- FlicenseNot gradedqualityDmaintenanceMCP server for querying student information, validating result data, and analyzing student results from a local database.-