# Study materials

`list_study_materials`

- Read-only

Lists the olympiad’s study materials by category: past papers as opaque material handles, and published study links as plain URLs. A student sees only the papers for their own grade — the platform filters by grade before this service sees the list — while a supervisor or partner sees every grade. Some olympiads publish none, and then the list is simply empty. Pass a handle to get_study_material to read the paper itself; never build a file name.

- **For**: Students, teachers and 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`
- `category`string

  Show only the category whose name contains this text, matched without case.

  min length`1`max length`60`

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