# Your challenge groups

`list_my_project_groups`

- Read-only

Lists this teacher’s groups in group challenges on one olympiad, newest first — of one challenge when project_id is given — each with its status, grade group, how many members and submitted steps it has, and whether its fee is paid (payment_status, amount in the currency’s main unit). Deleted groups are listed too, with the status deleted. Filter by status; page through it with page and limit.

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

  Only the groups of this challenge (project_id from list_my_group_projects).

  pattern`^[a-f0-9]{24}$`min length`24`max length`24`
- `status`string

  Only groups in this status: awaiting_payment, draft, finalized (confirmed), completed (work sent) or deleted.

  one of`awaiting_payment``draft``finalized``completed``deleted`
- `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`**
- **`not_found`**