Search sheets
search_sheets
Section titled “search_sheets”Use this to search exercise sheets visible to the authenticated ChalkSurf 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": { "hasIssues": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "issueTypes": { "anyOf": [ { "items": { "enum": [ "missing_translation", "missing_solution", "invalid_latex", "missing_score", "exercise_quality_issue" ], "type": "string" }, "type": "array" }, { "type": "null" } ] }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "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" }, "ownership": { "default": "own", "enum": [ "own", "shared", "public", "all" ], "type": "string" }, "seriesPath": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "seriesPaths": { "anyOf": [ { "items": { "minLength": 1, "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" }, { "type": "null" } ] }, "subject": { "anyOf": [ { "enum": [ "math", "physics", "chemistry" ], "type": "string" }, { "type": "null" } ] }, "text": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "yearFilter": { "anyOf": [ { "additionalProperties": false, "properties": { "fromYear": { "maximum": 9999, "minimum": 1000, "type": "integer" }, "toYear": { "maximum": 9999, "minimum": 1000, "type": "integer" } }, "type": "object" }, { "type": "null" } ] } }, "required": [ "organizationId" ], "type": "object"}Output schema
Section titled “Output schema”{ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exerciseSheets": { "items": { "additionalProperties": false, "properties": { "exerciseCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "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" }, "matchingSeriesAssignments": { "items": { "additionalProperties": false, "properties": { "editionYear": { "maximum": 9999, "minimum": 1000, "type": "integer" }, "seriesPath": { "minLength": 1, "type": "string" } }, "required": [ "seriesPath", "editionYear" ], "type": "object" }, "type": "array" }, "name": { "type": "string" }, "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" }, "subject": { "enum": [ "math", "physics", "chemistry" ], "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "subject", "name", "exerciseCount", "readinessSummary", "updatedAt" ], "type": "object" }, "type": "array" }, "totalCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "exerciseSheets", "totalCount" ], "type": "object"}