Search exercises
search_exercises
Section titled “search_exercises”Use this to search exercises 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": { "age": { "anyOf": [ { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, { "type": "null" } ] }, "labels": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ] }, "language": { "anyOf": [ { "enum": [ "english", "hungarian", "german", "french", "spanish", "italian" ], "type": "string" }, { "type": "null" } ] }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "maxDifficulty": { "anyOf": [ { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, { "type": "null" } ] }, "minDifficulty": { "anyOf": [ { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, { "type": "null" } ] }, "needsFix": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Match exercises with invalid LaTeX or, when enabled, at least one active quality issue." }, "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" }, "semanticSearch": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "seriesPath": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "seriesPaths": { "anyOf": [ { "items": { "minLength": 1, "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" }, { "type": "null" } ] }, "status": { "anyOf": [ { "items": { "enum": [ "verified", "unverified", "invalid" ], "type": "string" }, "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": { "exercises": { "items": { "additionalProperties": false, "properties": { "difficulty": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "distance": { "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": { "description": "Whether the exercise has at least one active quality issue visible under the current feature rollout.", "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" }, "matchingSources": { "items": { "additionalProperties": false, "properties": { "assignments": { "items": { "additionalProperties": false, "properties": { "editionYear": { "maximum": 9999, "minimum": 1000, "type": "integer" }, "seriesPath": { "minLength": 1, "type": "string" } }, "required": [ "seriesPath", "editionYear" ], "type": "object" }, "type": "array" }, "orderIndex": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "sheetId": { "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" }, "sheetNames": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" } }, "required": [ "sheetId", "sheetNames", "orderIndex", "assignments" ], "type": "object" }, "type": "array" }, "max_age": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "metadata": {}, "min_age": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "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" }, "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": {}, "propertyNames": { "type": "string" }, "type": "object" } }, "required": [ "id", "difficulty", "min_age", "max_age", "status", "organization_id", "is_public", "source", "subject", "figures", "metadata", "text", "labels", "translations", "hasActiveQualityIssues" ], "type": "object" }, "type": "array" }, "textSearchWarning": { "type": "string" }, "totalCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "exercises", "totalCount" ], "type": "object"}