Skip to main content
Glama
USC WebReg/Course Catalog MCP

USC WebReg/Course Catalog MCP

by shreeyachand

USC WebReg/Course Catalog MCP

MCP 服务器,为 AI 代理提供南加州大学(USC)公开课程目录 API(classes.usc.edu)的访问。允许你提出诸如"周二/周四中午之后开始的 GE B 选项有哪些?"之类的问题。

设置

构建一次:

npm install
npm run build

opencode

添加到 ~/.config/opencode/opencode.jsonc:

{
  "mcp": {
    "usc-courses": {
      "type": "local",
      "command": ["node", "/absolute/path/to/usc-webreg-mcp/dist/index.js"],
      "enabled": true
    }
  }
}

Claude Code

在项目根目录添加 .mcp.json(或运行 claude mcp add):

{
  "mcpServers": {
    "usc-courses": {
      "command": "node",
      "args": ["/absolute/path/to/usc-webreg-mcp/dist/index.js"]
    }
  }
}

Related MCP server: Brown Courses MCP Server

工具

工具

描述

list_terms

所有学期,含季节/年份/状态

get_term

按 termCode 获取单个学期详情(例如 20263)

list_schools

某学期的学院/学校及其专业

list_programs

某学期的专业(系)及其所属学院

get_program

专业详情/备注(D-clearance 信息)

list_course_prefixes

目录中的所有学科前缀

list_sessions

注册时段和退课日期

check_course_exists

课程代码是否存在于目录中

get_syllabus_index

某学期的 SimpleSyllabus 索引 URL

get_section_fees

按 sisSectionId 获取课程段费用

search_courses

目录关键词搜索(代码/标题/描述)

get_course

完整课程记录,包括所有课程段、先修要求和限制

list_courses_by_program

某学院+专业的所有课程

list_ge_requirements

GE 结构(要求 + 类别前缀)

list_courses_by_ge

满足某 GE 类别的课程

get_ge_category_details

某 GE 类别的名称/详情

时间表筛选

search_courses、list_courses_by_program 和 list_courses_by_ge 接受可选的课程段筛选条件:days(["Mon","Wed"])、startAfter/startBefore("12:00")和 openOnly。

示例:周一+周三中午及之后上课的 GE B 课程:

list_courses_by_ge(termCode=20263, geRequirementPrefix=ACORELIT,
  geCategoryPrefix=HINQ, days=["Mon","Wed"], startAfter="12:00")

Available Tools

16 tools
check_course_existsA
Read-onlyIdempotent

Check whether a course code exists anywhere in the USC catalog (not limited to a single term). Accepts codes like 'CSCI-103'. Returns true/false.

Inputs: course (required).

get_courseA
Read-onlyIdempotent

Get the full record for a single USC course in a term by its course code (e.g. 'CSCI-103'). Includes description, units, GE code, prerequisites, corequisites, restrictions, and all sections with schedule, instructor, seats, fees, and syllabus URL. Supports optional section filters (days, startAfter, startBefore, openOnly) applied client-side.

Inputs: termCode (required), courseCode (required), days, openOnly, +2 more.

get_ge_category_detailsA
Read-onlyIdempotent

Get the name and details of a single General Education (GE) category within a requirement for a term. Useful to confirm what a GE category prefix means (e.g. what 'HINQ' covers).

Inputs: termCode (required), geCategoryPrefix (required), geRequirementPrefix (required).

get_programA
Read-onlyIdempotent

Get details for a single USC program in a term, including program-specific notes (e.g. enrollment or D-clearance instructions). Requires the program's school prefix (find via list_programs) and the program prefix.

Inputs: school (required), program (required), termCode (required).

get_section_feesA
Read-onlyIdempotent

Get the fees for a single course section by its SIS section id (the 'sisSectionId' field on a section, e.g. '29934'). Returns any tuition/fee items attached to the section.

Inputs: sectionId (required).

get_syllabus_indexA
Read-onlyIdempotent

Get the SimpleSyllabus index URL for a term, which can be used to look up published syllabi for that term's sections. Individual sections also carry a 'syllabus' URL directly.

Inputs: termCode (required).

get_termA
Read-onlyIdempotent

Get details for a single academic term by its numeric termCode (e.g. 20263 = Fall 2026). Returns season, year, status, and activation date.

Inputs: termCode (required).

list_course_prefixesA
Read-onlyIdempotent

List every USC subject prefix in the catalog (e.g. CSCI, MATH, AHIS) across all terms, with its name. Useful for discovering what subjects exist.

Inputs: no named parameters.

list_courses_by_geA
Read-onlyIdempotent

List all courses in a term that satisfy a General Education (GE) category, with their sections. Requires the GE requirement prefix and category prefix, which can be discovered via list_ge_requirements (e.g. GE B 'Humanistic Inquiry' = geRequirementPrefix 'ACORELIT', geCategoryPrefix 'HINQ'). Supports optional section filters (days, startAfter, startBefore, openOnly) applied client-side.

Inputs: termCode (required), geCategoryPrefix (required), geRequirementPrefix (required), days, +3 more.

list_courses_by_programA
Read-onlyIdempotent

List all courses offered by a USC program (department) in a term. Requires the school prefix and program prefix, which can be discovered via list_programs. For example, Computer Science is school 'ENGV' and program 'CSCI'. Returns courses with their sections. Supports optional section filters (days, startAfter, startBefore, openOnly) applied client-side.

Inputs: school (required), program (required), termCode (required), days, +3 more.

list_ge_requirementsA
Read-onlyIdempotent

List USC General Education (GE) requirements for a term. Returns the GE structure grouped by requirement era ('Fall2015OrLater' for current students, 'BeforeFall2015' for older catalogs). Each requirement has a prefix and categories with prefixes (e.g. GE B 'Humanistic Inquiry' is category prefix 'HINQ' under requirement 'ACORELIT'). Use the prefixes with list_courses_by_ge.

Inputs: termCode (required).

list_programsA
Read-onlyIdempotent

List all USC programs (departments/majors) in a term, each with its prefix, name, and the school prefix(es) it belongs to. Use this to find the school+program pair needed for list_courses_by_program (e.g. Computer Science is program 'CSCI' under school 'ENGV').

Inputs: termCode (required).

list_schoolsA
Read-onlyIdempotent

List all USC schools/colleges offering classes in a term, each with its prefix (e.g. 'ENGV' = Viterbi, 'DRNS' = Dornsife) and the programs (departments) it contains. Useful for navigating the catalog structure.

Inputs: termCode (required).

list_sessionsA
Read-onlyIdempotent

List USC enrollment sessions (e.g. regular session '001', summer sessions) with their term, session code, description, last drop date, and RNR session id. Useful for understanding session codes shown on sections.

Inputs: no named parameters.

list_termsA
Read-onlyIdempotent

List all USC academic terms available in the course catalog, each with season, year, term code, and status. Use this to find the termCode for a given semester (e.g. 20263 = Fall 2026).

Inputs: no named parameters.

search_coursesA
Read-onlyIdempotent

Search the USC course catalog for a term by keyword. Matches course codes, titles, and descriptions (e.g. 'machine learning', 'CSCI', 'art history'). Returns matching courses with their sections, including schedule, instructor, and seat availability. Supports optional section filters (days, startAfter, startBefore, openOnly) applied client-side.

Inputs: termCode (required), searchTerm (required), days, openOnly, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools cleanly separate listing, detail lookup, and course discovery, but a few overlaps exist: check_course_exists is similar to get_course/search_courses, and the multiple list_courses_* variants all return courses with sections. Descriptions are specific enough that an agent can usually pick correctly, though some boundary cases require close reading.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern: list_* for collections, get_* for single records, and search_courses/check_course_exists as clear special cases. All names are snake_case, and related tools are predictably grouped.

    Tool Count4/5

    16 tools is slightly above the ideal range but justifiable given the domain's breadth: terms, schools, programs, course prefixes, sessions, GE requirements, fees, and syllabi all need coverage. A couple of tools like check_course_exists or get_syllabus_index feel auxiliary, but they do not make the set bloated.

    Completeness4/5

    The catalog surface is well covered: term navigation, program/school structure, course search and detail, GE lookup, sections, fees, sessions, and syllabi are all represented. Minor gaps include lack of a direct single-section lookup, no search by instructor, and no registration/enrollment actions, but for a read-only catalog the core workflows are complete.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers