Teachers
Which of your students can join a challenge group
list_group_project_students
- Read-only
Lists this teacher’s own students for one group challenge, each as an opaque student handle with their name and grade, whether their grade can take part (eligible) and the group they are already in, if any (in_group, with mine when it is one of this teacher’s groups). availability narrows it: available (the default) is the eligible students in no group yet, eligible every eligible one, in_group those already grouped, all everybody. grade_group_id narrows it to one grade group; search matches names only. Use the handles with add_project_group_members.
- For
- Teachers
- Needs
- Read access (
mcp:read) - What it changes
- Read-only. It only reads. Nothing changes.
Inputs
brandstringWhich olympiad this is about. Required unless the connection covers exactly one, in which case that one is used.
one of
codinggmathhilinguaneostemproject_idstringrequiredThe project_id from list_my_group_projects.
pattern
^[a-f0-9]{24}$min length24max length24grade_group_idstringA grade_group_id from get_group_project_overview, to list only that grade group’s students.
pattern
^[a-f0-9]{24}$min length24max length24availabilitystringavailable (the default): eligible and in no group yet; eligible: every eligible student; in_group: those already in a group; all: every one of this teacher’s students.
one of
alleligibleavailablein_groupsearchstringShow only students whose first or last name contains this text. Names only.
min length
1max length64pageintegerWhich page to read, counting from 1. Read page 1 first; the result says whether there is another.
min
1max200limitintegerHow many rows to read, at most 50.
min
1max50
The server refuses a call that carries any field not listed here, and says which one.
Answers instead of a result
What the tool says when it cannot do what was asked, and what to do about it.
not_connectedinsufficient_scoperate_limitedwrites_disabledtemporarily_unavailableupstream_errorbrand_not_allowedrole_requiredtenant_account_missingnot_found