Search Courses
search-coursesFind a course on Studocu by name or code, to get its course_id for search-documents, get-course-syllabus, or get-course-mastery. Pass institution_id from search-institutions when you know the school. For a high school, pass degree_id and grade_id from list-degrees. Those ids are national, so a school is optional. With a school, the level filter is added to that school search. Ids only, not names. Pass include_levels: true to include degree and grade on every course. A course whose institution_id is null cannot be used to create or update a project. Prefer a course with an institution_id, or ask the user to pick their school. Show the user the name, code, school, degree, and grade, not the ids. If several results are plausible, ask the user to pick.
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": {
"query": "<query>"
},
"name": "search-courses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many courses to return. Integer from 1 to 10. Default 3. | |
| query | Yes | Course name or code, 1-200 characters after trimming. Example: "ECON101" or "Introduction to Psychology". | |
| grade_id | No | Numeric national high-school grade id, taken from list-degrees (grades[].id) or from grade.id on a search-courses result. Never guess it and never pass the grade name. A school is optional. Omit if unknown. | |
| degree_id | No | Numeric national high-school degree id, taken from list-degrees (the id field) or from degree.id on a search-courses result. Never guess it and never pass the degree name. A school is optional. Matches courses of that degree and courses of its grades. Omit if unknown. | |
| include_levels | No | Set true to include degree and grade on every course. Omit for the legacy payload. | |
| institution_id | No | Numeric school id from search-institutions (the id field). Example: 42. Omit to search every school. Prefer setting it when you already know the school. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| courses | Yes |