STARS: Personal planner and audit MCP tools
Service overview · CLI reference · All MCP tools · Data types
Personal planner and audit
Inputs are required only where marked. A required output field may still be null if its type allows it. See data types for nested objects.
stars_auth_status
Report whether WISH credentials are configured and whether this process has verified a session.
Inputs: none. Does not log in.
Returns: whether a shared keyring account is stored, credential_storage of os_keyring, a sanitized credential_error when unavailable, whether this process has verified a WISH session, its last verification time, and personal-cache settings. No credential or cookie values are returned.
credentials_configured: null means the store could not be read; it does not mean the account was never saved. false means a readable store has no account.
Inputs
None.
Output
| Field | Type | Required | Details |
|---|---|---|---|
credentials_configured |
boolean or null |
Yes | — |
credential_storage |
"os_keyring" |
Yes | — |
credential_error |
string or null |
Yes | — |
session_verified |
boolean |
Yes | — |
last_verified_at |
string or null |
Yes | — |
session_storage |
string |
Yes | — |
personal_cache_ttl_seconds |
integer |
Yes | — |
stars_get_stars_planner
Get registered courses, the published term, and saved Plans 1–3 with indexes and timetables. Use refresh after editing a plan.
Input: optional refresh, default false. Requires credentials.
Returns: the published Planner term, registered courses and timetable information, and saved Plans 1–3 with their course/index lists and sessions. Registered courses and saved plans are separate sections. Status fields distinguish empty, parsed, and unavailable data. Use refresh: true after editing a plan.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
refresh |
boolean |
No | default: false |
Output
| Field | Type | Required | Details |
|---|---|---|---|
service |
string |
Yes | — |
page_title |
string or null |
Yes | — |
academic_year |
integer or null |
Yes | — |
semester |
integer or null |
Yes | — |
registration_notice |
string or null |
Yes | — |
registered_courses |
array of object of string |
Yes | — |
registered_courses_status |
string |
Yes | — |
planner_tables |
array of PersonalTable |
Yes | — |
timetable_tables |
array of PersonalTable |
Yes | — |
timetable_status |
string |
Yes | — |
saved_plans |
array of SavedPlan |
Yes | — |
source_url |
string |
Yes | — |
retrieved_at |
string |
Yes | — |
from_cache |
boolean |
Yes | — |
cache_age_seconds |
integer |
Yes | — |
stars_get_degree_audit
Get your degree requirements, examination results, and registered courses from Degree Audit.
Inputs: none. Requires credentials.
Returns: published degree/AU requirements, examination results, registered courses, and status/source/cache metadata. Academic tables retain their published headers and records. Identity/contact tables are excluded; unknown or missing academic information is not inferred.
Inputs
None.
Output
| Field | Type | Required | Details |
|---|---|---|---|
service |
string |
Yes | — |
page_title |
string or null |
Yes | — |
requirements |
array of PersonalTable |
Yes | — |
requirements_status |
string |
Yes | — |
examination_results |
array of PersonalTable |
Yes | — |
examination_results_status |
string |
Yes | — |
courses_registered |
array of PersonalTable |
Yes | — |
courses_registered_status |
string |
Yes | — |
source_url |
string |
Yes | — |
retrieved_at |
string |
Yes | — |
from_cache |
boolean |
Yes | — |
cache_age_seconds |
integer |
Yes | — |
stars_save_stars_plan
Replace saved Plan 1, 2, or 3 with the complete supplied course/index list for the current Planner term. Omitted courses are removed from that plan. Verifies persistence by loading the saved plan. Does not perform course registration, dropping, or index swapping.
Inputs: plan_number of 1–3, the complete courses list of 1–13 course/index pairs, academic_year, and semester of 1 or 2. Requires credentials, and the term must match the Planner's current term.
Returns: the saved plan and verification time after reloading it. This replaces the plan's entire course/index list; omitted courses are removed. It does not register, drop, or swap registered courses. If persistence is uncertain, refresh the Planner before retrying; an uncertain save is not automatically repeated.
{"plan_number":1,"academic_year":2030,"semester":1,"courses":[{"course_code":"ZZ0001","index":"00001"}]}
MCP host confirmation is required before this action.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
plan_number |
1, 2, 3 |
Yes | — |
courses |
array of PlannedIndex |
Yes | minimum items: 1; maximum items: 13 |
academic_year |
integer |
Yes | — |
semester |
1, 2 |
Yes | — |
Output
| Field | Type | Required | Details |
|---|---|---|---|
status |
string |
Yes | — |
academic_year |
integer |
Yes | — |
semester |
integer |
Yes | — |
saved_plan |
SavedPlan |
Yes | — |
verified_at |
string |
Yes | — |
source_url |
string |
Yes | — |
See the MCP data types for nested object fields.