# 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

- `brand`string

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

  one of`coding``gmath``hilingua``neo``stem`
- `grade`stringrequired

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

  one of`1``2``3``4``5``6``7``8``9``10``11``12`

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`**