UTMAX MCP

OK   Node.js version — v22.14.0
OK   Package — @iexdevs/utmax-mcp 0.2.0
OK   Codex config — /home/you/.codex/config.toml
OK   Codex skill — /home/you/.agents/skills/utmax/SKILL.md
OK   MCP handshake — initialize + listTools + listResources succeeded (20 tools, 8 resources)
OK   UTMAX API reachability — https://utmax.tech

All required checks passed.

doctor checks the Node version, each client’s config and skill files, a real MCP initialize/listTools/listResources handshake, and (unless --offline is passed) whether the hosted UTMAX API is reachable. A network warning never marks the local install as broken — availability is reported separately from install success.

Rendered response, with a nextActions hint

{
  "schemaVersion": "1.0",
  "ok": true,
  "data": {
    "term": { "termCode": "20269", "label": "Fall 2026" },
    "sections": [
      { "uniqueNumber": "54905", "courseCode": "C S 312", "professor": "BEASLEY, ANGELA CHAPPELL", "status": "closed" }
    ]
  },
  "meta": {
    "source": "utmax_search_courses",
    "generatedAt": "2026-09-06T06:04:08.785Z",
    "nextActions": [
      "Compare the strongest candidates with utmax_rank_sections before recommending one.",
      "Use utmax_get_course_details for the exact section a user wants to lock in."
    ]
  }
}

nextActions only appears on a handful of tools (course search, schedule generation, registration payload export, and calendar export/publish) so it doesn’t repeat the same promotional text on every response.

Sanitized agent transcript

A real planning session, condensed and with the live calendar feed ID redacted.

> can you make me a schedule and give me the ICS link for it I want to do M408C, SDS313, GOV310L, UGS303 and CS303E

Which term should I use — Fall 2026 (20269), Spring 2027, or another term? Once confirmed, I'll
generate the best conflict-free schedule and publish its live ICS subscription link.

> prioritize it being close to each other, make it best professors best grade distribution and
also short walks or reasonable ones, online is okay and reduce amt of days/time on campus

I'll use Fall 2026 (20269). I'll rank schedules by professor quality, grade distribution, compact
campus days, and walking distance, with online sections allowed, then publish a live ICS feed.

Called utmax_generate_schedules({ "term": "20269", "courseCodes": [...], "criteria": [...] })
  Input validation error: buildPreferences.gapWeight: Too big: expected number to be <=1

The generator caps preference weights at 1, so I'm retrying with the maximum allowed emphasis on
fewer days and tighter gaps. No course data was changed.

[... several bounded retries as the agent relaxes an infeasible 3-day cap, checks section
availability with utmax_search_courses, and compares the two open GOV 310L professors with
utmax_compare_professors before finalizing a plan ...]

The final set has comfortable transition buffers — the tightest is 70 minutes. I'm publishing the
live ICS subscription for these five sections now.

Called utmax_publish_live_calendar_feed({ "term": "20269", "uniqueNumbers": [...] })
  { "ok": true, "data": { "feedUrl": "https://utmax.tech/api/schedule/feed/«redacted»/....ics" } }

## Validation
 Course      Unique    Professor             Status
 M 408C      58365     Cesar Meza            Open
 SDS 313     62740     Su Chen               Closed
 GOV 310L    40300     Shannon O'Brien       Open
 UGS 303     68695     Marina Alexandrova    Open
 C S 303E    54620     Elahe Sadeghi         Open

- No time conflicts · Four campus days, Friday free · Smallest transition buffer: 70 minutes
- O'Brien: 4.2/5 professor rating, 78.1% would take again · Feed expires March 5, 2027

## Risks / Next steps
SDS 313 currently has no open Fall 2026 sections, so this schedule is not fully
registration-ready. The feed creates a calendar subscription; it does not register you or save
the schedule inside UTMAX's browser planner.