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

Teachers and partners

Exams for one student

find_exams_for_student

  • Read-only

Lists the exams one of this account’s students may still be applied to, with the category, the sitting, the language and the fee. The list accounts for the student’s grade, the caller’s country, what the student already holds and the olympiad’s own same-day rule, so anything it returns is something add_exams_for_students will accept. 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. Students in the same grade get the same list, so call it once per grade rather than once per student.

For
Teachers and partners
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

  • studentstringrequired

    The opaque student handle from list_my_students or list_country_students.

    pattern^stu_[A-Za-z0-9._-]{1,1000}$min length5max length1024

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
not_found

Search the API documentation

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