Get exercise
get_exercise
Section titled “get_exercise”Use this to fetch full details for one exercise visible to the selected organization.
Contract metadata
Section titled “Contract metadata”{ "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "fileParams": [], "requiredPermission": "read", "security": { "type": "oauth2", "scopes": [ "chalksurf:read" ] }}Input schema
Section titled “Input schema”The server advertises this JSON Schema to MCP clients. Runtime authorization and business-rule checks still apply.
{ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "id": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "organizationId": { "description": "The ChalkSurf organization ID to use for this request.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "id", "organizationId" ], "type": "object"}Output schema
Section titled “Output schema”{ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exercise": { "additionalProperties": false, "properties": { "created_at": { "type": "string" }, "currentUserAccess": { "additionalProperties": false, "properties": { "role": { "enum": [ "owner", "editor", "viewer" ], "type": "string" }, "via": { "enum": [ "ownership", "organization_membership", "shared", "public" ], "type": "string" } }, "required": [ "role", "via" ], "type": "object" }, "deleted_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "descriptionGenerationLanguages": { "items": { "enum": [ "english", "hungarian", "german", "french", "spanish", "italian" ], "type": "string" }, "type": "array" }, "difficulty": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "exercise_sheet_count": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "figures": { "items": { "additionalProperties": false, "properties": { "exerciseFigureId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "orderIndex": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "provenance": { "additionalProperties": false, "properties": { "byteLength": { "maximum": 104857600, "minimum": 0, "type": "integer" }, "createdBy": { "enum": [ "agent", "user", "import" ], "type": "string" }, "mimeType": { "maxLength": 100, "minLength": 1, "type": "string" }, "originalFileName": { "maxLength": 255, "minLength": 1, "type": "string" }, "pixelHeight": { "maximum": 100000, "minimum": 1, "type": "integer" }, "pixelWidth": { "maximum": 100000, "minimum": 1, "type": "integer" }, "renderQualityStatus": { "enum": [ "passed", "needs_revision", "unchecked" ], "type": "string" }, "renderSpecHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "sourceKind": { "enum": [ "local_file", "mcp_file", "https_url", "base64_image", "rendered_figure", "user_upload", "import", "unknown" ], "type": "string" } }, "required": [ "sourceKind", "createdBy" ], "type": "object" }, "rotationClockwiseDegrees": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 90, "type": "number" }, { "const": 180, "type": "number" }, { "const": 270, "type": "number" } ] }, "type": { "enum": [ "text", "solution" ], "type": "string" }, "url": { "format": "uri", "type": "string" }, "widthInCm": { "maximum": 20, "minimum": 1, "type": "number" } }, "required": [ "type", "url", "widthInCm", "exerciseFigureId", "orderIndex", "rotationClockwiseDegrees" ], "type": "object" }, "type": "array" }, "hasActiveQualityIssues": { "type": "boolean" }, "id": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "is_public": { "type": "boolean" }, "labels": { "items": { "type": "string" }, "type": "array" }, "max_age": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "metadata": { "anyOf": [ {}, { "type": "null" } ] }, "min_age": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "order_index": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "organization_id": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ] }, "owner": { "additionalProperties": false, "properties": { "displayName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "isCurrentOrganization": { "type": "boolean" }, "isCurrentUser": { "type": "boolean" }, "kind": { "enum": [ "user", "organization" ], "type": "string" } }, "required": [ "kind", "id", "displayName", "isCurrentUser", "isCurrentOrganization" ], "type": "object" }, "private_notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "score_points": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "enum": [ "verified", "unverified", "invalid" ], "type": "string" }, "subject": { "enum": [ "math", "physics", "chemistry" ], "type": "string" }, "text": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "translations": { "additionalProperties": { "additionalProperties": false, "properties": { "answer": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "detailed_solution": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "exercise_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scaffold": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "enum": [ "verified", "unverified", "invalid" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" }, "updated_at": { "type": "string" } }, "required": [ "id", "created_at", "updated_at", "difficulty", "min_age", "max_age", "figures", "metadata", "organization_id", "is_public", "source", "subject", "labels", "translations", "text", "status", "private_notes", "exercise_sheet_count", "owner", "currentUserAccess" ], "type": "object" } }, "required": [ "exercise" ], "type": "object"}