learnJCU 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., "@learnJCU MCP what's due in the next 14 days across my subjects?"
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.
learnJCU MCP
English | 简体中文
An unofficial MCP server and command-line tool for James Cook University's student sites. You sign in yourself in a real browser window, and the tools reuse that session.
LearnJCU (
learn.jcu.edu.au, Blackboard Learn Ultra): your subjects, announcements, content, grades, deadlines and calendar, through Blackboard's REST API. Submitting files or text to an Ultra assignment is the only action that changes anything.MyStudent (
jcu.t1cloud.com, JCU's student administration portal): the dashboard, and every page behind it in full: personal details and contacts, educational background, sanctions, course structure and overview, census and withdrawal dates, class registrations, finances (amounts payable, transactions, receipts, payment preferences), tasks, calendar, forms and your form responses, applications and offers.StudentFirst (
studentfirst.jcu.edu.sg, JCU Singapore): classes in the next 8 days, class and campus attendance, the attendance of every session, leave applications and notices.
MyStudent and StudentFirst are read-only here.
Security
Sign-in happens in your system default browser (Edge, Chrome, Brave and other Chromium browsers), on JCU's own sign-in pages. You type your password there yourself; the code never sees it. StudentFirst has its own user name and password; if you let the browser save it in the sign-in window, it stays in that account's browser profile and later refreshes use it without you.
Each saved account has its own browser profile (
~/.learnjcu-mcp/accounts/<account>/browser-profile), separate from your everyday profile. The tools never read your normal browser's cookies or saved passwords.Sessions are saved per account in
~/.learnjcu-mcp/accounts/<account>/(session.jsonfor LearnJCU,mystudent.json,studentfirst.json), so several people's sign-ins never mix. None of this is inside the project folder.Each session only goes to its own site:
learn.jcu.edu.au,jcu.t1cloud.comorstudentfirst.jcu.edu.sg. When a file download redirects to Blackboard's file host, the session cookie is dropped. The one exception is the update check: a single request toapi.github.comper start, with no cookies or account data (see Updates).MyStudent's dashboard is read with the two POST requests its own page uses to load its tiles; they only read. Other MyStudent pages are rendered in a hidden browser with a fresh, empty profile: it opens the page, clicks only the section tabs listed in
src/mystudent.js, and reads the text. It never presses a button, so nothing is saved, requested, paid or submitted. StudentFirst pages are read with GET requests only.On LearnJCU, only GET requests, except submitting to an assignment:
In the CLI,
submitshows what it will send and asks[y/N]first.--dry-runonly shows the plan.In MCP,
learnjcu_submitneedsconfirm: true, and the agent is told to show you a dry run and get your yes first. Withoutconfirm: truenothing is sent.
There is no telemetry.
Related MCP server: NCCU Moodle MCP
Usage
Run these commands inside this folder:
npm install
npm run login # opens a browser; sign in to LearnJCU and the window closes itself
npm run check # prints your name and current subjectsThe login opens your default browser at LearnJCU, which sends you to JCU's sign-in page.
MyStudent and StudentFirst are signed in for the same account afterwards:
npm run login -- --service mystudent # JCU single sign-on; usually no window at all
npm run login -- --service studentfirst # StudentFirst's own user name and passwordFor StudentFirst, let the browser save the password when it offers to: later refreshes then sign in again by themselves.
Sessions expire after a few hours, but you rarely need to sign in again:
Silent refresh. Every login first tries a hidden window. If the sign-in page still remembers you (or, for StudentFirst, the browser has the saved password), the session is renewed in a few seconds with no window.
CLI. When a
learnjcucommand finds its session expired, it refreshes silently and retries. If you have to sign in, it asks whether to open the sign-in page.Agent. When an MCP tool finds its session expired, the server first renews it silently with that account's browser profile and runs the call again, so you usually notice nothing. A submission is not re-run by itself; the agent calls it again. Only if that doesn't work does the tool report the expired session, and the agent (any MCP client) then calls
learnjcu_login, which opens the sign-in page and asks you to finish.
Several accounts
Each account is saved apart from the others: its session and its own browser profile live in ~/.learnjcu-mcp/accounts/<username>/.
npm run login # first account (named after your LearnJCU username)
npm run login -- --new-account # sign in someone else and save them as another account
learnjcu accounts # list saved accounts
learnjcu upcoming --account jc123456 # use one account for a command (or set LEARNJCU_ACCOUNT)With one saved account, everything uses it.
With several and none chosen, a command in a terminal asks which one to use; without a terminal it stops and asks for
--account.In MCP, the server asks you through your client's prompt (if the client supports MCP elicitation) and keeps your answer for the session. Otherwise the agent is told to ask you, then passes
account.learnjcu_list_accountsandlearnjcu_select_accountlist and switch accounts.A sign-in for an existing account that turns out to be a different person is refused, so one account's folder never holds someone else's session.
LearnJCU CLI
npm link makes the learnjcu command available everywhere. Or run node src/learnjcu-cli.js.
learnjcu login # sign in (same as npm run login)
learnjcu upcoming --days 14 # gradebook items due soon, across your subjects
learnjcu submissions AB1001 Essay # an assignment's settings and your attempts on it
learnjcu submit AB1001 Essay report.pdf --dry-run # show what would be sent
learnjcu submit AB1001 Essay report.pdf # submit as a new attempt (asks first)
learnjcu submit AB1001 Reflection -m "My answer" # text only
learnjcu mystudent # MyStudent dashboard
learnjcu mystudent finances transactions # one page (or one section of it) in full
learnjcu study-plan # your course and the status of each subject
learnjcu classes # StudentFirst: next 8 days and overall attendance
learnjcu attendance AB1001 # every session of a subject's classes
learnjcu leave # your StudentFirst leave applications<course>can be a subject code likeAB1001(matched to your newest subject site with that code), a full code like26-AB1001-CNS-INT-TR1, or a course id like_123456_1.<assignment>is a unique part of its title, or its content or column id.submitworks on Ultra assignments without questions (the ones where you add files or text and press Submit). Each run is a new attempt, so check how many attempts the assignment allows:submissionsshows it.Files are uploaded as they are. Assignments with questions, group assignments, and ones that need a password or a secure browser are refused; use the browser for those. So are items that link to an external tool (such as Turnitin).
After submitting, the command checks that the receipt lists the uploaded files.
Updates
Each time the MCP server starts, it checks once whether GitHub's main branch has a newer version than the copy it runs from. If it does, the first tool answer tells the agent which changes are new; the agent explains them and asks whether you want to update. It only updates after your yes: learnjcu_update shows a dry run, then fetches main, switches to it and runs npm install. Restart your MCP client afterwards.
The check is one request to
api.github.comwith the commit id this copy runs. No cookies or account data are sent.It needs a git checkout of the GitHub repository. Other copies are never flagged.
Set
LEARNJCU_NO_UPDATE_CHECK=1to turn it off.
Add to an MCP client
Most MCP clients accept a stdio server in this JSON form (in the client's MCP settings file, or a project's .mcp.json):
{
"mcpServers": {
"learnjcu": {
"command": "node",
"args": ["<absolute path to this folder>/src/server.js"]
}
}
}Restart the client afterwards.
Add to Codex
codex mcp add learnjcu -- node "<absolute path to this folder>/src/server.js"Or add it to ~/.codex/config.toml:
[mcp_servers.learnjcu]
command = "node"
args = ["<absolute path>/src/server.js"]
tool_timeout_sec = 300 # waiting for a sign-in can take longer than Codex's 60 s defaultMCP tools
Tool | What it does |
| List saved accounts and which one this session uses |
| Choose the account for the rest of the session (after asking the user) |
| Check whether you're signed in and when the session expires (lists every account when none is chosen) |
| Refresh or start a sign-in; opens your default browser if you need to act |
| Show the signed-in user |
| List your subjects and other sites, subject sites first |
| Announcements for a subject |
| Subject outline and folder contents |
| Full text of one content item, plus its attachments and files embedded in the page |
| Download an attachment or embedded file to |
| Gradebook: due dates, submission status, scores and feedback |
| Items due in the next N days across all current subjects |
| Calendar events |
| An assignment's submission settings and your attempts, with receipts and files |
| Submit files or text to an Ultra assignment (needs |
| GET any |
| Check or refresh the MyStudent session (JCU single sign-on) |
| MyStudent dashboard: contact details, study plan, class registrations, payments, tasks, calendar, forms |
| Your course and every subject in it: enrolled, completed, exempt or planned, plus advanced standing (about 20 s) |
| Any MyStudent page in full (details, study, class_registrations, finances, tasks, calendar, forms, form_responses, applications), or one section of it |
| Check or refresh the StudentFirst session (its own user name and password) |
| Classes in the next 8 days, overall class and campus attendance, attendance per class |
| Every session of your classes and whether you were marked present or absent |
| Your leave applications and their status |
| StudentFirst notices, such as student contract updates and public holidays |
| Check GitHub for a newer version and list what it adds |
| Update this copy to the latest version (needs |
Environment variables
LEARNJCU_BROWSER: the browser for sign-in, as a path to its executable or a channel (msedge,chrome). Defaults to your system default browser. If that is Firefox or Safari, which can't be automated, an installed Edge or Chrome is used instead.LEARNJCU_MCP_HOME: the session folder. Defaults to~/.learnjcu-mcp.LEARNJCU_DOWNLOAD_DIR: the download folder. Defaults to~/Downloads/learnjcu.LEARNJCU_ACCOUNT: the saved account to use, instead of being asked. Same as--account.LEARNJCU_NO_AUTO_LOGIN: set to1to stop the CLI and the MCP server from refreshing an expired session by themselves.LEARNJCU_NO_UPDATE_CHECK: set to1to stop the MCP server from checking GitHub for a newer version when it starts.
Known limitations
The LearnJCU API was checked with a student account: profile, enrolled subjects, gradebook columns, content, announcements and calendar.
Sign-in needs a computer with a screen; there is no terminal-only sign-in.
StudentFirst is JCU Singapore's site; students at other campuses have no StudentFirst account.
Nothing in MyStudent or StudentFirst is changed: enrolment, withdrawal, forms, payments, report requests (academic record, enrolment advice), class requests and leave applications stay on their websites.
A MyStudent page takes 10 to 20 seconds to read, longer with all its sections; in clients with a short tool timeout, read one section at a time.
Submitting has not been sent for real on LearnJCU yet. It sends the same requests as the Blackboard Ultra web page, but check with a dry run first.
Content inside third-party LTI tools such as Turnitin and Echo360 is not available.
Please use this responsibly and follow JCU's IT and academic integrity policies.
Contributing
Issues and pull requests are welcome. Read CONTRIBUTING.md first. Security problems go through SECURITY.md.
License
Available Tools
29 toolslearnjcu_api_getARead-only
Read-only escape hatch: GET any Blackboard Learn public REST endpoint under /learn/api/public/.
Inputs: path (required), params, account.
learnjcu_calendarBRead-only
List LearnJCU calendar items (course events, due dates, personal events) between two dates. Default: next 4 weeks.
Inputs: since, until, account.
learnjcu_check_updateARead-only
Check whether a newer version of learnjcu-mcp is on GitHub, and list what it adds. Use when the user asks about updates or what is new.
Inputs: no named parameters.
learnjcu_download_attachmentA
Download a file from a content item (an attachment id, or an "embedded-N" id from learnjcu_get_content) into the local Downloads/learnjcu folder and return its path.
Inputs: courseId (required), contentId (required), attachmentId (required), account.
learnjcu_get_contentARead-only
Get one content item with its full text and the list of its files, including files embedded in the page (ids like "embedded-0"). Use when the user asks for the details of an assignment or other item: its brief, instructions and attached files.
Inputs: courseId (required), contentId (required), account.
learnjcu_list_accountsARead-only
List the saved University accounts (each has its own sign-in) and which one is chosen for this session. Use when the user asks which accounts are saved, or before asking them which account to use.
Inputs: no named parameters.
learnjcu_list_announcementsARead-only
List recent announcements for a course, newest first.
Inputs: courseId (required), limit, account.
learnjcu_list_contentsARead-only
List items in a course outline. Omit contentId for the top level; pass a folder/learning module id to list its children. Use when the user asks what is in a course, or to find an assignment or other item in it.
Inputs: courseId (required), account, contentId.
learnjcu_list_coursesARead-only
List the modules/courses you are enrolled in on LearnJCU, most recently accessed first. Use when the user asks about their courses or modules, or you need a course id for another LearnJCU tool.
Inputs: search, account, includeUnavailable.
learnjcu_list_submissionsARead-only
Show a LearnJCU assignment's submission settings (due date, attempts allowed, file/text allowed) and every attempt you have made, newest first, with status, receipt and files. Use when the user asks for an assignment's details (due date, attempts left, what can be submitted) or what they have already submitted, and before submitting.
Inputs: courseId (required), assignment (required), account.
learnjcu_loginARead-only
Sign in to LearnJCU or refresh an expired session. Call this whenever a LearnJCU tool says the session expired or you are not signed in. Each saved account has its own sign-in; with several, pass account (the user is asked when you leave it out). It first refreshes silently (a few seconds, no window). If the user has to sign in, it opens the sign-in page in their default browser: tell the user a browser window opened and ask them to sign in there. If the result says waitingForUser, call again after the user says they are done. Never ask the user for their password; they type it in the browser.
Inputs: account, newAccount, waitSeconds.
learnjcu_my_gradesARead-only
Show the gradebook for a course: each assessment with due date, your submission status, grade and feedback. Use when the user asks about a course's assignments, their grades or feedback.
Inputs: courseId (required), account.
learnjcu_select_accountARead-only
Choose which saved account the other tools use for the rest of this session. Call it after the user has said which account they mean; never pick one for them.
Inputs: account (required).
learnjcu_statusARead-only
Check whether a LearnJCU session is saved and when it expires. With several saved accounts and none chosen, it lists them all.
Inputs: account.
learnjcu_submitADestructive
Submit files (and optional text) to a LearnJCU Ultra assignment as a new attempt. Course staff see it at once, and it may count as your graded attempt. Use when the user asks to submit an assignment on LearnJCU. If the item links to an external tool, submit there instead. Always call with dryRun: true first, show the plan, and wait for the user to confirm.
Inputs: courseId (required), assignment (required), text, files, +3 more.
learnjcu_upcoming_deadlinesARead-only
Scan all current courses for gradebook items due in the next N days (default 14), with your submission status.
Inputs: days, account, includePast.
learnjcu_updateAIdempotent
Update this copy of learnjcu-mcp to the latest version from GitHub (git fetch, switch to main and fast-forward, npm install). Only use after the user has said yes to updating. Always call with dryRun: true first, show the plan, then call with confirm: true. The user must restart the MCP client afterwards.
Inputs: dryRun, confirm.
learnjcu_whoamiBRead-only
Show the signed-in LearnJCU user.
Inputs: account.
mystudent_loginARead-only
Sign in to MyStudent or refresh an expired session. Call this whenever a MyStudent tool says the session expired or you are not signed in. MyStudent uses the same JCU single sign-on as LearnJCU, so this is usually silent. Each saved account has its own sign-in; with several, pass account (the user is asked when you leave it out). Accounts are created by learnjcu_login; sign in to LearnJCU first if none is saved. It first refreshes silently (a few seconds, no window). If the user has to sign in, it opens the sign-in page in their default browser: tell the user a browser window opened and ask them to sign in there. If the result says waitingForUser, call again after the user says they are done. Never ask the user for their password; they type it in the browser.
Inputs: account, waitSeconds.
mystudent_overviewARead-only
Show the MyStudent dashboard (JCU's student administration portal): your contact details, study plan, class registrations, outstanding payments, tasks to complete, today's calendar, and forms in progress or available. Use when the user asks about their enrolment, fees, tasks or forms in MyStudent, or their student record.
Inputs: account.
mystudent_pageARead-only
Read one MyStudent page in full, in a hidden browser (about 10 s, plus 3-5 s for each section). Pages: details (personal details, contacts and addresses, educational background, sanctions, communications, forms); study (course structure, course overview, self-service reports on offer, withdrawal: census and last-withdrawal dates per subject); class_registrations; finances (summary, outstanding transactions and amounts payable, payment receipts, forms, payment preferences); tasks (enrolment tasks still to do); calendar (this week); forms (forms you can fill out); form_responses (your draft and submitted forms); applications (course applications and offers). Sections: details (summary, contacts, education, sanctions, communication, forms); study (course, overview, reports, withdrawal); class_registrations; finances (summary, transactions, receipts, forms, preferences); tasks; calendar; forms; form_responses; applications. Pass section to read only one (faster). This only reads: it never saves, requests, pays, enrols, withdraws or submits anything; tell the user to do those on the MyStudent website. Use when the user asks for something in MyStudent that mystudent_overview does not show in full.
Inputs: page (required), account, section.
mystudent_statusARead-only
Check whether a MyStudent session is saved and when it expires. With several saved accounts and none chosen, it lists them all.
Inputs: account.
mystudent_study_planARead-only
Show your course in MyStudent and every subject in its structure with its status: enrolled (and in which study period), completed, exempt or credited, or planned for a later period, plus advanced standing. Takes about 10 seconds (the page is rendered in a hidden browser). Use when the user asks about their degree progress, which subjects are left, or what they are enrolled in.
Inputs: account.
studentfirst_class_attendanceARead-only
List every session of your StudentFirst classes with date, time, room and whether attendance was recorded as present, absent or not yet recorded. Use when the user asks which classes they missed or the attendance of one subject.
Inputs: account, classCode.
studentfirst_leave_applicationsARead-only
List your StudentFirst leave applications with dates and status. Use when the user asks about leave they applied for. This tool does not apply for leave; the user does that on the StudentFirst website.
Inputs: account.
studentfirst_loginARead-only
Sign in to StudentFirst or refresh an expired session. Call this whenever a StudentFirst tool says the session expired or you are not signed in. StudentFirst (JCU Singapore) has its own user name and password, not the JCU single sign-on. When a window opens, ask the user to sign in there and to let the browser save the password, so later refreshes need nothing from them. Each saved account has its own sign-in; with several, pass account (the user is asked when you leave it out). Accounts are created by learnjcu_login; sign in to LearnJCU first if none is saved. It first refreshes silently (a few seconds, no window). If the user has to sign in, it opens the sign-in page in their default browser: tell the user a browser window opened and ask them to sign in there. If the result says waitingForUser, call again after the user says they are done. Never ask the user for their password; they type it in the browser.
Inputs: account, waitSeconds.
studentfirst_noticesARead-only
Show the StudentFirst notices, such as updates to the JCU Singapore student contract and public holidays.
Inputs: account.
studentfirst_overviewARead-only
Show StudentFirst (JCU Singapore): classes in the next 8 days with time and room, overall class and campus attendance against the 90% minimum, and each class with how many sessions were attended. Use when the user asks about their timetable, next classes, rooms or attendance at JCU Singapore.
Inputs: account.
studentfirst_statusBRead-only
Check whether a StudentFirst session is saved. With several saved accounts and none chosen, it lists them all.
Inputs: account.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
The triple-prefix scheme (learnjcu_/mystudent_/studentfirst_) cleanly separates the three portals, and within each portal most tools target a distinct resource or action. A few boundaries blur: learnjcu_my_grades, learnjcu_list_submissions and learnjcu_upcoming_deadlines all surface due dates plus submission status, and mystudent_study_plan overlaps mystudent_page with section=study. The descriptions do mitigate this (e.g. mystudent_page is explicitly framed as the fallback for what overview doesn't show), so an agent can still choose correctly.
Almost everything follows a predictable snake_case pattern of portal + verb + noun (learnjcu_list_courses, learnjcu_get_content, studentfirst_class_attendance). Minor deviations exist: noun-only names like learnjcu_status, learnjcu_calendar, mystudent_overview, and the bare mystudent_page, plus the possessive learnjcu_my_grades. These are readable and group logically, but the pattern isn't exactly uniform.
29 tools is heavy for a single MCP server, though the count is explained by covering three separate university systems plus auth and self-update tooling. Most tools earn their place, but there is some redundancy (three MyStudent readers, paired check_update/update, paired grades/submissions/deadlines). It sits at the upper edge of what an agent can scan without losing track.
The surface covers the full lifecycle for its stated purpose: per-account auth for all three portals, course/content/attachment access, gradebook and deadlines, submission inspection plus actual assignment submission, and broad read coverage of MyStudent and StudentFirst. Remaining gaps are largely deliberate (MyStudent and StudentFirst are read-only; leave applications, payments and enrolment are explicitly deferred to the websites), which can produce dead ends but not silent failures. Minor gaps like no announcement detail view or discussion tools are workable around.
Maintenance
Related MCP Connectors
PLATO (Pusan National University LMS) MCP server via Moodle Web Service API + ubboard scraping
LearnUpon MCP server for ChatGPT, Claude and any AI agent: list users, invite users, add users to group, enroll group on course, enroll users on course, unenroll users, set enrollment complete and disable user in your own LearnUpon account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to LearnUpon yourself; Cotlet does not store your password and you need no LearnUpon API key. About the official LearnUpon API: LearnUpon has a REST API and a reporting MCP server, but neither covers day-to-day admin work from an AI agent (checked 20 Oct 2026). The REST API uses API keys that an admin generates under Settings > Integrations > API Keys, and Support grants them when the option is missing. Setup and FAQ: https://cotlet.dev/integrations/learnupon-api-mcp-server
Absorb LMS MCP server for ChatGPT, Claude and any AI agent: list users, list course enrollments, list overdue learners, approve enrollment request, enroll users in a course, message learners, create user and deactivate user in your own Absorb LMS account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Absorb LMS yourself; Cotlet does not store your password and you need no Absorb LMS API key. About the official Absorb LMS API: Absorb LMS has an Integration API, a REST API with JSON for learners, courses, departments and grades, but it needs a private key tied to your portal that your Absorb account team provides, and your own code (checked 20 Oct 2026). Absorb's Aura MCP for Claude and ChatGPT is planned for 27 Oct 2026 and is read and answer only. Setup and FAQ: https://cotlet.dev/integrations/absorb-lms-api-mcp-server
Study from your own classes: synced Canvas coursework, notes, flashcards and study progress.
Related MCP Servers
- AlicenseAqualityBmaintenanceGives Claude, Codex, Cursor and any other MCP client read access to your courses, content, files, grades, deadlines, announcements and discussions, using your own browser session.3116 npm5MIT
- FlicenseAqualityBmaintenanceEnables students to access Moorle courses, assignments, grades, announcements, and notifications through authenticated MCP tools.11-
- AlicenseNot gradedqualityBmaintenanceEnables users to retrieve Modeus schedules, iStudent grade/rating data, and eLearn course listings, content, and files through local MCP tools while using their university service login.1Apache 2.0
- AlicenseAqualityBmaintenanceEnables read-only access to University of Leeds Minerva (Blackboard Learn Ultra) and Gradescope through a browser-authenticated session. Supports listing courses, announcements, contents, grades, deadlines and calendar events, downloading attachments, and querying Gradescope assignments and submissions.36ISC