Skip to content
AI connections
View as MarkdownOpen in ClaudeAdd to CursorAdd to VS Code

Teachers

Exams for a new student’s grade

find_exams_for_grade

  • Read-only

Lists the exams a new student of one grade could be entered for on one olympiad, with the category, the sitting, the language and the fee: what find_exams_for_student offers a student of that grade who holds no exam yet, narrowed by this account’s country. Use it before register_students to turn the exam names on a registration sheet into exam ids, once per grade and olympiad on the sheet rather than once per student. session_date is the sitting’s calendar day (YYYY-MM-DD, no time and no time zone), and for a sitting run over more than one day, which its name shows, it is the last one. For a student already on the list, use find_exams_for_student instead.

For
Teachers
Needs
Read access (mcp:read)
What it changes
Read-only. It only reads. Nothing changes.

Inputs

  • brandstring

    Which olympiad this is about. Required unless the connection covers exactly one, in which case that one is used.

    one ofcodinggmathhilinguaneostem

  • gradestringrequired

    The grade of the students to be registered, "1" to "12".

    one of123456789101112

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_connected
insufficient_scope
rate_limited
writes_disabled
temporarily_unavailable
upstream_error
brand_not_allowed
role_required
tenant_account_missing

Search the API documentation

Guides, endpoints by name, path or permission, and error codes such as not_found.