# My students

`list_my_students`

- Read-only

Lists the students registered to this supervisor on one olympiad, each with an opaque student handle, their name, grade and school, and the exams they have applied for with whether each is paid. The search matches names only — never a username or an e-mail address — so it cannot be used to check whether an address belongs to somebody. Use the handles it returns with get_student, find_exams_for_student and add_exams_for_students; never use a raw id.

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

  Show only students whose first or last name contains this text. Names only.

  min length`1`max length`60`
- `grade`string

  Show only students in this grade.

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

  Which page to read, counting from 1. Read page 1 first; the result says whether there is another.

  min`1`max`200`
- `limit`integer

  How many rows to read, at most 50.

  min`1`max`50`

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