exams
Read-only
List exams, get all student scores for a specific exam, or retrieve one user's score. Returns exam metadata and results.
Instructions
Query exam metadata and student exam results/scores. Use this for exam catalogs and per-exam student scores. For a specific user's exam history across all exams, use the dashboard tool with get_user_exams action.
Sub-actions:
list: List all exams in the academy. Paginated.
get_students: List all students who took a specific exam with their scores. Requires examId. Paginated.
get_student: Get one user's score for a specific exam. Requires examId and userId.
Returns JSON: { data, _meta: { tool, action, returned, truncated? } }. When truncated is true, apply filters or pagination params to narrow results.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | The sub-action to perform: 'list' for exam catalog, 'get_students' for all scores on an exam, 'get_student' for one user's score | |
| start | No | Starting position for pagination (e.g. 0). Used with list, get_students. | |
| limit | No | Max students per page, up to 100. Default: 100. Used with list, get_students. | |
| examId | No | Exam ID (e.g. 8001). Required for: get_students, get_student. | |
| userId | No | User ID or external ID. Required for: get_student (returns one user's score for a specific exam). |