Skip to content
AI connections
View as MarkdownOpen in ClaudeAdd to CursorAdd to VS Code

Partners

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

  • brandstring

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

    one ofcodinggmathhilinguaneostem

  • searchstring

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

    min length1max length60

  • gradestring

    Show only students in this grade.

    one of123456789101112

  • pageinteger

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

    min1max200

  • limitinteger

    How many rows to read, at most 50.

    min1max50

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

Search the API documentation

Guides, endpoints by name, path or permission, and error codes such as not_found.