list_courses_by_ge
Find courses that satisfy a GE category for a term, including sections and filters for days, times, and open classes. Supply GE prefixes from list_ge_requirements.
Instructions
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"termCode": "<termCode>",
"geRequirementPrefix": "<geRequirementPrefix>",
"geCategoryPrefix": "<geCategoryPrefix>"
},
"name": "list_courses_by_ge"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Section must meet on all of the given days (e.g. ['Mon', 'Wed']). A section matches if any of its schedule entries covers every listed day. | |
| openOnly | No | When true, only include sections that are not cancelled and not full (have seats available). | |
| termCode | Yes | Numeric USC term code, e.g. 20263 (Fall 2026). Use list_terms to discover codes. | |
| startAfter | No | Only sections whose start time is at or after this zero-padded HH:MM time (e.g. '12:00'). | |
| startBefore | No | Only sections whose start time is at or before this zero-padded HH:MM time (e.g. '17:00'). | |
| geCategoryPrefix | Yes | GE category prefix from list_ge_requirements (e.g. 'HINQ' for GE B Humanistic Inquiry). | |
| geRequirementPrefix | Yes | GE requirement prefix from list_ge_requirements (e.g. 'ACORELIT' for Core Literacies). |