Teachers
Register new students
register_students
- Writes
- Needs confirmation
Registers new students for this teacher, up to fifty in one call, each on one to five olympiads at once, and enters them for the exams their row names on each. Every row needs the student’s own e-mail address, one no other Main Team account uses, and its olympiads, each one this account works on as a teacher; at most 100 student-olympiad pairs a call. The platform e-mails each new student their username and a generated password, and the student confirms the address the first time they sign in; neither the teacher nor this assistant ever sees the username or the password. The first call checks every row on every olympiad. If anything is wrong it answers needs_changes with the problems by row, column and olympiad, and nobody is registered; correct the rows with the teacher and call again, and never guess an address. Otherwise it answers a summary and a confirmation value, and nothing is created until the same call is repeated with that confirmation. The answer gives each new student’s handle on each olympiad, for the other student tools, and what each exam entry did. A student who already has an account is not registered again: they link themselves to the teacher with link_my_teacher. The columns come from get_student_registration_template, the exam ids from find_exams_for_grade.
- For
- Teachers
- Needs
- Read and write access (
mcp:write) - What it changes
- Writes. The first call only shows what would change and returns a confirmation handle. Nothing changes until the agent calls again with that handle, after you agree.
- Repeating it
- Not safe: the same call twice can change data twice.
Inputs
studentsarray of objectrequiredOne entry per new student, at most 50, in the order of the sheet: a problem names its row by its place here, counting from 0.
min items
1max items5010 fields of each item
first_namestringrequiredAs the student writes it.
min length
1max length60last_namestringrequiredAs the student writes it.
min length
1max length60emailstringrequiredThe student’s own address, which no other Main Team account uses. Their username and a generated password are sent here, and they confirm it at their first sign-in. Never a guess.
format
emailmin length3max length254birth_datestringrequiredDD/MM/YYYY.
pattern
^\d{2}/\d{2}/\d{4}$min length10max length10sexstringrequiredf or m.
one of
fmgradestringrequiredThe student’s school grade, "1" to "12".
one of
123456789101112phonestringOptional: digits, + ( ) - and spaces. Leave it out, or blank, when there is none.
max length
30citystringOptional: leave it out, or blank, for the teacher’s own city.
max length
80schoolstringOptional: leave it out, or blank, for the teacher’s own school. Required when city is given.
max length
120olympiadsarray of objectrequiredThe olympiads to register this student on, each named once, at most 5. The account is made on the first; the student is linked to this teacher on each.
min items
1max items52 fields of each item
brandstringrequiredAn olympiad this account works on as a teacher.
one of
codinggmathhilinguaneostemexam_idsarray of stringOptional: the exam ids find_exams_for_grade answers on this olympiad for this student’s grade, at most 20.
max items
20
confirmationstringThe
confirmationvalue from this tool’s ownconfirmation_requiredanswer. Send it back with exactly the same other arguments to go ahead; never invent one.pattern
^cfm_[A-Za-z0-9._-]{1,4000}$min length5max length4096
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_allowed_hereconfirmation_requiredconfirmation_expired