# Students in my scope

`list_country_students`

- Read-only

Lists the registered students this partner is responsible for on one olympiad, each with an opaque student handle, their name, grade, school, city, the teacher they belong to, and their exam applications with whether each is paid. A full partner sees their whole country; a limited partner sees the students of the teachers linked to them — the platform decides which, not this tool. The search matches names only. Page through it for a count or a lookup; for the whole list at once, as a table to write into a spreadsheet, use export_student_list.

- **For**: Partners
- **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`**