Get sheet
get_sheet
Section titled “get_sheet”Use this to fetch full details for one exercise sheet 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": { "sheet": { "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" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "exercises": { "items": { "additionalProperties": false, "properties": { "created_at": { "type": "string" }, "descriptionGenerationLanguages": { "items": { "enum": [ "english", "hungarian", "german", "french", "spanish", "italian" ], "type": "string" }, "type": "array" }, "difficulty": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "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" } ] }, "score_points": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "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" ], "type": "object" }, "type": "array" }, "folder_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" } ] }, "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" }, "name": { "type": "string" }, "organization_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" }, "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" } ] }, "readinessSummary": { "additionalProperties": false, "properties": { "hasIssues": { "type": "boolean" }, "issueCounts": { "additionalProperties": false, "properties": { "exercise_quality_issue": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "invalid_latex": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "missing_score": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "missing_solution": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "missing_translation": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "missing_translation", "missing_solution", "invalid_latex", "missing_score", "exercise_quality_issue" ], "type": "object" }, "status": { "enum": [ "empty", "ok", "needs_work" ], "type": "string" }, "totalIssueCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "status", "hasIssues", "totalIssueCount", "issueCounts" ], "type": "object" }, "scoring_enabled": { "type": "boolean" }, "seriesAssignments": { "items": { "additionalProperties": false, "properties": { "editionYear": { "maximum": 9999, "minimum": 1000, "type": "integer" }, "seriesPath": { "minLength": 1, "type": "string" } }, "required": [ "seriesPath", "editionYear" ], "type": "object" }, "type": "array" }, "subject": { "enum": [ "math", "physics", "chemistry" ], "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "translations": { "additionalProperties": { "additionalProperties": false, "properties": { "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name", "title", "description" ], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" }, "translationStatuses": { "additionalProperties": { "additionalProperties": false, "properties": { "status": { "enum": [ "ready", "preparing", "failed" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" }, "updated_at": { "type": "string" } }, "required": [ "id", "created_at", "updated_at", "name", "title", "description", "organization_id", "folder_id", "is_public", "scoring_enabled", "subject", "private_notes", "readinessSummary", "translations", "translationStatuses", "exercises", "owner", "currentUserAccess", "seriesAssignments" ], "type": "object" } }, "required": [ "sheet" ], "type": "object"}