Studocu is an MCP server published by com.studocu, hosted at agent-os-mcp.alpha.studocu.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 20 tools, including search-documents, search-institutions, search-courses, list-degrees, get-course-syllabus.
Find Studocu study documents, courses and institutions, and manage study projects and quizzes.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Find Studocu documents such as lecture notes and summaries. Pass topic keywords as query. Prefer numeric course_id from search-courses; it overrides course and institution. Results with match_type: semantic are closest matches, not exact keyword hits, and may be only loosely related.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | How many Studocu documents to return. Integer from 1 to 50. Default 10. |
| query * | string | Topic keywords only. Example: "supply and demand" or "microeconomics midterm 2025". Do not put a course name, course id, or school name here. Use institution, course, and course_id for those. |
| course | string | Course name or code. Example: "Economics" or "ECON101". Use this when you do not have course_id. Do not put a numeric id here. Optional extra when you already have course_id. Omit if unknown. |
| course_id | integer | Numeric course id from search-courses (the course_id field). Example: 1581710. Prefer this: it pins the course and overrides the course name or code. Omit if you only have a name or code. |
| institution | string | School name only. Example: "University of Amsterdam". Not an id. This tool has no institution_id. Use the name from the user or from search-institutions. Omit if unknown. If course_id is also set, course_id wins and the result school is that course's school, not this name. |
| use_no_course_as_fallback | boolean | Only used with course_id. When true and that course has no matching Studocu documents, search again without the course, so results may come from other courses. Check each result's course_id. Default false. Omit for false. |
{
"name": "search-documents",
"title": "Document Search",
"description": "Find Studocu documents such as lecture notes and summaries. Pass topic keywords as query. Prefer numeric course_id from search-courses; it overrides course and institution. Results with match_type: semantic are closest matches, not exact keyword hits, and may be only loosely related.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "How many Studocu documents to return. Integer from 1 to 50. Default 10."
},
"query": {
"type": "string",
"minLength": 1,
"description": "Topic keywords only. Example: \"supply and demand\" or \"microeconomics midterm 2025\". Do not put a course name, course id, or school name here. Use institution, course, and course_id for those."
},
"course": {
"type": "string",
"description": "Course name or code. Example: \"Economics\" or \"ECON101\". Use this when you do not have course_id. Do not put a numeric id here. Optional extra when you already have course_id. Omit if unknown."
},
"course_id": {
"type": "integer",
"maximum": 2147483647,
"description": "Numeric course id from search-courses (the course_id field). Example: 1581710. Prefer this: it pins the course and overrides the course name or code. Omit if you only have a name or code.",
"exclusiveMinimum": 0
},
"institution": {
"type": "string",
"description": "School name only. Example: \"University of Amsterdam\". Not an id. This tool has no institution_id. Use the name from the user or from search-institutions. Omit if unknown. If course_id is also set, course_id wins and the result school is that course's school, not this name."
},
"use_no_course_as_fallback": {
"type": "boolean",
"description": "Only used with course_id. When true and that course has no matching Studocu documents, search again without the course, so results may come from other courses. Check each result's course_id. Default false. Omit for false."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"documents"
],
"properties": {
"documents": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"course": {
"type": "string"
},
"language": {
"type": "string"
},
"course_id": {
"type": "number"
},
"match_type": {
"type": "string",
"const": "semantic"
},
"description": {
"type": "string"
},
"institution": {
"type": "string"
},
"publishedAt": {
"type": "string"
},
"academicYears": {
"type": "array",
"items": {
"type": "number"
}
},
"numberOfPages": {
"type": "number"
},
"institution_id": {
"type": "number"
},
"ratingNegative": {
"type": "number"
},
"ratingPositive": {
"type": "number"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find a school (university or high school) on Studocu by name, to get its id for search-courses. Show the user the name, type, and country, not the id. If several results are plausible, ask the user to pick.
| Parameter | Type | Description |
|---|---|---|
| type | string | Optional filter: UNIVERSITY or HIGH_SCHOOL. Omit to search both. |
| limit | integer | How many schools to return. Integer from 1 to 10. Default 3. |
| query * | string | School name to search, 1-200 characters after trimming. Example: "University of Amsterdam". |
{
"name": "search-institutions",
"title": "Search Institutions",
"description": "Find a school (university or high school) on Studocu by name, to get its id for search-courses. Show the user the name, type, and country, not the id. If several results are plausible, ask the user to pick.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"type": {
"enum": [
"UNIVERSITY",
"HIGH_SCHOOL"
],
"type": "string",
"description": "Optional filter: UNIVERSITY or HIGH_SCHOOL. Omit to search both."
},
"limit": {
"type": "integer",
"default": 3,
"maximum": 10,
"minimum": 1,
"description": "How many schools to return. Integer from 1 to 10. Default 3."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "School name to search, 1-200 characters after trimming. Example: \"University of Amsterdam\"."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"institutions"
],
"properties": {
"institutions": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"type",
"region_code",
"country"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"name": {
"type": "string"
},
"type": {
"enum": [
"UNIVERSITY",
"HIGH_SCHOOL"
],
"type": "string"
},
"country": {
"type": "string"
},
"region_code": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find a course on Studocu by name or code, to get its course_id for search-documents, get-course-syllabus, or get-course-mastery. Pass institution_id from search-institutions when you know the school. For a high school, pass degree_id and grade_id from list-degrees. Those ids are national, so a school is optional. With a school, the level filter is added to that school search. Ids only, not names. Pass include_levels: true to include degree and grade on every course. A course whose institution_id is null cannot be used to create or update a project. Prefer a course with an institution_id, or ask the user to pick their school. Show the user the name, code, school, degree, and grade, not the ids. If several results are plausible, ask the user to pick.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | How many courses to return. Integer from 1 to 10. Default 3. |
| query * | string | Course name or code, 1-200 characters after trimming. Example: "ECON101" or "Introduction to Psychology". |
| grade_id | integer | Numeric national high-school grade id, taken from list-degrees (grades[].id) or from grade.id on a search-courses result. Never guess it and never pass the grade name. A school is optional. Omit if unknown. |
| degree_id | integer | Numeric national high-school degree id, taken from list-degrees (the id field) or from degree.id on a search-courses result. Never guess it and never pass the degree name. A school is optional. Matches courses of that degree and courses of its grades. Omit if unknown. |
| include_levels | boolean | Set true to include degree and grade on every course. Omit for the legacy payload. |
List the degrees taught at a high school, with their ids, so you can pass degree_id to search-courses. The ids are national, so search-courses can use them with no school. Pass institution_id from search-institutions. A university id is not a high school. Each degree may include grades with grade ids. When grades are not listed, take grade_id from a search-courses result. Show the user the degree and grade names, not the ids.
| Parameter | Type | Description |
|---|---|---|
| institution_id * | integer | Numeric high-school id from search-institutions (the id field). Example: 42. A university id does not list degrees. |
{
"name": "list-degrees",
"title": "List Degrees",
"description": "List the degrees taught at a high school, with their ids, so you can pass degree_id to search-courses. The ids are national, so search-courses can use them with no school. Pass institution_id from search-institutions. A university id is not a high school. Each degree may include grades with grade ids. When grades are not listed, take grade_id from a search-courses result. Show the user the degree and grade names, not the ids.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"institution_id"
],
"properties": {
"institution_id": {
"type": "integer",
"maximum": 2147483647,
"description": "Numeric high-school id from search-institutions (the id field). Example: 42. A university id does not list degrees.",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"degrees"
],
"properties": {
"degrees": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"grades"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"grades": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Return Studocu's generated outline for a course as markdown. If none exists yet, the call returns an error; try again in a few minutes.
| Parameter | Type | Description |
|---|---|---|
| course_id * | integer | Numeric course id from search-courses. Example: 1581710. A numeric string such as "1581710" is accepted. |
{
"name": "get-course-syllabus",
"title": "Get Course Syllabus",
"description": "Return Studocu's generated outline for a course as markdown. If none exists yet, the call returns an error; try again in a few minutes.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric course id from search-courses. Example: 1581710. A numeric string such as \"1581710\" is accepted.",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"course_id",
"content"
],
"properties": {
"content": {
"type": "string",
"description": "Published syllabus text for this course."
},
"course_id": {
"type": "string",
"minLength": 1,
"description": "Course id whose published syllabus was loaded."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List public class recordings (lecture audio with a transcript) that students shared for a course. Pass course_id from search-courses. Most recently recorded first; each recording has a recording date and an artifact_id. An empty list means no one has shared a recording for this course yet.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | How many recordings to return. Integer from 1 to 20. Default 10. |
| course_id * | integer | Numeric course id from search-courses. Example: 1581710. A numeric string such as "1581710" is accepted. |
{
"name": "list-course-recordings",
"title": "List Course Recordings",
"description": "List public class recordings (lecture audio with a transcript) that students shared for a course. Pass course_id from search-courses. Most recently recorded first; each recording has a recording date and an artifact_id. An empty list means no one has shared a recording for this course yet.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"course_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "How many recordings to return. Integer from 1 to 20. Default 10."
},
"course_id": {
"type": "integer",
"maximum": 2147483647,
"description": "Numeric course id from search-courses. Example: 1581710. A numeric string such as \"1581710\" is accepted.",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"course_id",
"recordings"
],
"properties": {
"course_id": {
"type": "string",
"minLength": 1,
"description": "Course id whose recordings were listed."
},
"recordings": {
"type": "array",
"items": {
"type": "object",
"required": [
"artifact_id",
"title",
"duration_seconds",
"recorded_at",
"project_id"
],
"properties": {
"title": {
"type": "string",
"description": "Recording title."
},
"project_id": {
"type": "string",
"minLength": 1,
"description": "Id of the public project that holds the recording."
},
"artifact_id": {
"type": "string",
"minLength": 1,
"description": "Artifact id of the recording: studocu://project/{id}/source/{id}."
},
"recorded_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When the lecture was recorded, ISO 8601 in UTC: the date stored in the audio file when it has one, otherwise the upload time. Null when unknown."
},
"duration_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Recording length in seconds. Null when the length is unknown."
}
},
"additionalProperties": false
},
"description": "Public class recordings for this course, most recently recorded first. Empty when none are shared yet."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Show who the current Studocu sign-in belongs to: authenticated, subject, clientId, and scopes. Use only to check that login worked.
No parameters.
{
"name": "agent-os-session",
"title": "Check Studocu Sign-in",
"description": "Show who the current Studocu sign-in belongs to: authenticated, subject, clientId, and scopes. Use only to check that login worked.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"authenticated",
"clientId",
"scopes"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string"
}
},
"subject": {
"type": "string"
},
"clientId": {
"type": "string"
},
"authenticated": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read a project source or creation by its studocu:// id (from get-project-state, add-document-sources, write-artifact, or request-creation). File and image sources also return the image when a viewable copy, or an original upload under 5 MB, exists. A class recording returns its transcript only to its owner; anyone else gets the recording's summary.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Token from a previous read when the result said there is more, for long content. Omit on the first read. Pass it back unchanged with the same artifact_id. |
| artifact_id * | string | Id shaped like studocu://project/{project_id}/{kind}/{uuid}. kind is source (a project source) or creation (a quiz, mock exam, note, or flashcard set). Example: studocu://project/11111111-1111-4111-8111-111111111111/source/22222222-2222-4222-8222-222222222222. |
{
"name": "read-artifact",
"title": "Read Studocu Artifact",
"description": "Read a project source or creation by its studocu:// id (from get-project-state, add-document-sources, write-artifact, or request-creation). File and image sources also return the image when a viewable copy, or an original upload under 5 MB, exists. A class recording returns its transcript only to its owner; anyone else gets the recording's summary.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"artifact_id"
],
"properties": {
"cursor": {
"type": "string",
"minLength": 1,
"description": "Token from a previous read when the result said there is more, for long content. Omit on the first read. Pass it back unchanged with the same artifact_id."
},
"artifact_id": {
"type": "string",
"minLength": 1,
"description": "Id shaped like studocu://project/{project_id}/{kind}/{uuid}. kind is source (a project source) or creation (a quiz, mock exam, note, or flashcard set). Example: studocu://project/11111111-1111-4111-8111-111111111111/source/22222222-2222-4222-8222-222222222222."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"artifactId",
"projectId",
"details"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link that opens this item in its project. Share it with the user."
},
"details": {
"type": "object",
"required": [
"kind",
"id",
"title",
"status",
"type",
"folder",
"content",
"createdAt",
"updatedAt"
],
"properties": {
"id": {
"type": "string",
"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)$",
"description": "UUID string in 8-4-4-4-12 hexadecimal form. Example: 11111111-1111-4111-8111-111111111111."
},
"kind": {
"enum": [
"source",
"creation"
],
"type": "string"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"folder": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"enum": [
"pending",
"processing",
"ready",
"completed",
"failed"
],
"type": "string"
},
{
"enum": [
"creating",
"created",
"failed"
],
"type": "string"
}
]
},
"content": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"title",
"count",
"questions"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Use this ID to fetch the Quiz from the Rest API."
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"title": {
"type": "string"
},
"questions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string"
}
]
},
"body": {
"type": "string"
},
"text": {
"type": "string"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"answer",
"isCorrect"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string"
}
]
},
"answer": {
"type": "string"
},
"isCorrect": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string"
}
]
},
"text": {
"type": "string"
},
"correct": {
"type": "boolean"
},
"isCorrect": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"question": {
"type": "string"
},
"difficulty": {
"type": "string"
},
"explanation": {
"type": "string"
},
"correctAnswer": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string"
}
]
},
"explanationMd": {
"type": "string"
},
"correctAnswerIds": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string"
}
]
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"hasPdf",
"data"
],
"properties": {
"id": {
"type": "string",
"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)$",
"description": "Use this ID to fetch the Mock Exam from the API."
},
"data": {
"type": "object",
"required": [
"id",
"schemaVersion",
"title",
"content"
],
"properties": {
"id": {
"type": "string",
"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)$",
"description": "Use this ID to fetch the Mock Exam from the API."
},
"title": {
"type": "string"
},
"content": {
"type": "array",
"items": {
"anyOf": [
{
"allOf": [
{
"type": "object",
"required": [
"kind",
"id",
"questionType"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"section"
],
"type": "string"
},
"title": {
"type": "string"
},
"instructions": {
"type": "string"
},
"questionType": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "section"
}
},
"additionalProperties": false
}
]
},
{
"allOf": [
{
"type": "object",
"required": [
"kind",
"id",
"stimulusMarkdown"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"stimulus"
],
"type": "string"
},
"title": {
"type": "string"
},
"stimulusMarkdown": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "stimulus"
}
},
"additionalProperties": false
}
]
},
{
"allOf": [
{
"type": "object",
"required": [
"kind",
"id",
"sectionId",
"type",
"marks",
"questionMarkdown"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"question"
],
"type": "string"
},
"type": {
"type": "string"
},
"marks": {
"type": "number"
},
"blanks": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
}
},
"topics": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"grading": {
"type": "object",
"required": [
"modelAnswer"
],
"properties": {
"keyPoints": {
"type": "array",
"items": {
"type": "string"
}
},
"modelAnswer": {
"type": "string"
},
"correctAnswer": {
"type": "string"
},
"correctAnswerIds": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string"
}
]
},
"text": {
"type": "string"
}
},
"additionalProperties": false
}
},
"sectionId": {
"type": "string"
},
"stimulusIdRefs": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"questionMarkdown": {
"type": "string"
},
"templateMarkdown": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "question"
}
},
"additionalProperties": false
}
]
}
]
}
},
"frontMatter": {
"type": "object",
"properties": {
"instructionsMarkdown": {
"type": "string"
}
},
"additionalProperties": false
},
"schemaVersion": {
"type": "string"
}
},
"additionalProperties": false
},
"hasPdf": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"data"
],
"properties": {
"id": {
"type": "string",
"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)$",
"description": "Use this ID to fetch the flashcard set from the API."
},
"data": {
"type": "object",
"required": [
"title",
"description",
"flashcards"
],
"properties": {
"title": {
"type": "string",
"minLength": 1
},
"flashcards": {
"type": "array",
"items": {
"type": "object",
"required": [
"front",
"back"
],
"properties": {
"back": {
"type": "string",
"minLength": 1
},
"front": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
},
"description": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "string"
}
]
},
"category": {
"anyOf": [
{
"enum": [
"file/audio",
"file/image",
"file/pdf",
"file/markdown",
"studocu/document"
],
"type": "string"
},
{
"type": "null"
}
]
},
"createdAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"updatedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"projectId": {
"type": "string"
},
"artifactId": {
"type": "string"
},
"continuations": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"returned",
"total",
"hasMore"
],
"properties": {
"path": {
"enum": [
"details.content.questions"
],
"type": "string"
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"hasMore": {
"type": "boolean"
},
"returned": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"nextCursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read the text of a Studocu document by its search-documents id, without adding it to a project.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page to return as an image instead of the text. Only when the text misses something (a figure, plot, handwriting, math); text reads say how many pages exist. |
| document_id * | integer | Positive integer id from search-documents (documents[].id). Example: 17. |
{
"name": "read-detached-document",
"title": "Read Studocu Document",
"description": "Read the text of a Studocu document by its search-documents id, without adding it to a project.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"document_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page to return as an image instead of the text. Only when the text misses something (a figure, plot, handwriting, math); text reads say how many pages exist."
},
"document_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive integer id from search-documents (documents[].id). Example: 17.",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"content"
],
"properties": {
"content": {
"type": "string",
"description": "The raw full text content of the Studocu document."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Load the learner's profile, followed courses, and projects. Use get-project-state for what is inside a project. Per-topic practice scores are included only when one course is in scope; otherwise use get-course-mastery.
| Parameter | Type | Description |
|---|---|---|
| course_id | any | Return only this course and its projects. Numeric id or the same id as text. Example: 1581710 or "1581710". Omit to include every followed course. |
| project_id | string | Return only this project. Example: "11111111-1111-4111-8111-111111111111". From an earlier get-context or create-project result. Omit to include the learner's projects. |
| active_only | boolean | Optional true or false. It is echoed on the response and does not change which courses or projects are returned. Omit it. |
| recent_only | boolean | Optional true or false. It is echoed on the response and does not change which courses or projects are returned. Omit it. |
{
"name": "get-context",
"title": "Get Learner Context",
"description": "Load the learner's profile, followed courses, and projects. Use get-project-state for what is inside a project. Per-topic practice scores are included only when one course is in scope; otherwise use get-course-mastery.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"course_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Return only this course and its projects. Numeric id or the same id as text. Example: 1581710 or \"1581710\". Omit to include every followed course."
},
"project_id": {
"type": "string",
"minLength": 1,
"description": "Return only this project. Example: \"11111111-1111-4111-8111-111111111111\". From an earlier get-context or create-project result. Omit to include the learner's projects."
},
"active_only": {
"type": "boolean",
"description": "Optional true or false. It is echoed on the response and does not change which courses or projects are returned. Omit it."
},
"recent_only": {
"type": "boolean",
"description": "Optional true or false. It is echoed on the response and does not change which courses or projects are returned. Omit it."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"context_schema_version",
"generated_at",
"requested_filters",
"data"
],
"properties": {
"data": {
"type": "object",
"required": [
"profile",
"followed_courses",
"memory",
"projects"
],
"properties": {
"memory": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"type": "string"
},
"value": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"updated_at": {
"type": "string"
}
},
"additionalProperties": false
}
},
"profile": {
"type": "object",
"required": [
"first_name",
"last_name",
"locale",
"study_year",
"level",
"gender",
"stage",
"institution"
],
"properties": {
"level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stage": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"gender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"locale": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"first_name": {
"type": "string"
},
"study_year": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"institution": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"type",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"projects": {
"type": "array",
"items": {
"type": "object",
"required": [
"project_id",
"metadata",
"memory",
"has_course_mastery",
"started_course_mastery"
],
"properties": {
"memory": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"type": "string"
},
"value": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"updated_at": {
"type": "string"
}
},
"additionalProperties": false
}
},
"metadata": {
"type": "object",
"required": [
"title",
"is_mobile",
"emoji",
"course_id",
"institution_id"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link to the project. Share it with the user."
},
"emoji": {
"type": "string",
"minLength": 1
},
"title": {
"type": "string",
"minLength": 1
},
"course_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"is_mobile": {
"type": "boolean"
},
"thread_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"course_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"institution_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"pending_sources_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"pending_creations_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"project_id": {
"type": "string"
},
"topic_masteries": {
"type": "array",
"items": {
"type": "object",
"required": [
"topic_id",
"mastery",
"questions_answered"
],
"properties": {
"mastery": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"topic_id": {
"type": "string",
"minLength": 1
},
"topic_name": {
"type": "string",
"minLength": 1
},
"questions_answered": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
}
},
"has_course_mastery": {
"type": "boolean"
},
"started_course_mastery": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"followed_courses": {
"type": "array",
"items": {
"type": "object",
"required": [
"course_id",
"name"
],
"properties": {
"name": {
"type": "string"
},
"course_id": {
"type": "string"
},
"institution_id": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"aggregates": {
"type": "object",
"properties": {
"recent_activity": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"id",
"seen_at"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"seen_at": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"generated_at": {
"type": "string"
},
"prompt_views": {
"type": "object",
"properties": {
"by_project": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "object",
"required": [
"section",
"body"
],
"properties": {
"body": {
"type": "string"
},
"section": {
"type": "string"
}
},
"additionalProperties": false
}
},
"user_wide_summary": {
"type": "object",
"required": [
"section",
"body"
],
"properties": {
"body": {
"type": "string"
},
"section": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"requested_filters": {
"type": "object",
"required": [
"project_id",
"course_id"
],
"properties": {
"course_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"active_only": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"recent_only": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"context_schema_version": {
"type": "number",
"const": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the project sources and creations inside one or more projects. A creation may include external_id (a quiz id or mock-exam id) to match a request-creation result that is still being saved.
| Parameter | Type | Description |
|---|---|---|
| ids * | array | 1 to 20 project ids from get-context or create-project. Example: ["11111111-1111-4111-8111-111111111111"]. Projects you cannot access are left out. |
{
"name": "get-project-state",
"title": "Studocu Project State",
"description": "List the project sources and creations inside one or more projects. A creation may include external_id (a quiz id or mock-exam id) to match a request-creation result that is still being saved.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 20,
"minItems": 1,
"description": "1 to 20 project ids from get-context or create-project. Example: [\"11111111-1111-4111-8111-111111111111\"]. Projects you cannot access are left out."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"projects"
],
"properties": {
"projects": {
"type": "array",
"items": {
"type": "object",
"required": [
"project_id",
"sources",
"creations"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link to the project. Share it with the user."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"artifact_id",
"kind",
"type",
"title",
"capabilities"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link that opens this item in its project. Share it with the user."
},
"kind": {
"type": "string",
"const": "source"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
},
"created_at": {
"type": "string"
},
"lineage_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"updated_at": {
"type": "string"
},
"artifact_id": {
"type": "string"
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"agent_input_type": {
"type": "string"
}
},
"additionalProperties": false
}
},
"creations": {
"type": "array",
"items": {
"type": "object",
"required": [
"artifact_id",
"kind",
"type",
"title",
"capabilities"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link that opens this item in its project. Share it with the user."
},
"kind": {
"type": "string",
"const": "creation"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
},
"created_at": {
"type": "string"
},
"lineage_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"updated_at": {
"type": "string"
},
"artifact_id": {
"type": "string"
},
"external_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "Kind-specific downstream id (quizId or mockExamId) for matching a pending request-creation."
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"agent_input_type": {
"type": "string"
}
},
"additionalProperties": false
}
},
"project_id": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Return the learner's practice scores (0-100) for the topics they have practised in one course. An empty list means no practice yet.
| Parameter | Type | Description |
|---|---|---|
| course_id * | integer | Numeric course id from search-courses or get-context. Example: 1581710. A numeric string such as "1581710" is accepted. |
{
"name": "get-course-mastery",
"title": "Get Course Practice Scores",
"description": "Return the learner's practice scores (0-100) for the topics they have practised in one course. An empty list means no practice yet.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"course_id"
],
"properties": {
"course_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric course id from search-courses or get-context. Example: 1581710. A numeric string such as \"1581710\" is accepted.",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"course_id",
"topic_masteries"
],
"properties": {
"course_id": {
"type": "string",
"minLength": 1,
"description": "Course id whose mastery was loaded, matching followed_courses.course_id."
},
"topic_masteries": {
"type": "array",
"items": {
"type": "object",
"required": [
"topic_id",
"mastery",
"questions_answered"
],
"properties": {
"mastery": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"topic_id": {
"type": "string",
"minLength": 1
},
"topic_name": {
"type": "string",
"minLength": 1
},
"questions_answered": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"description": "Topics the learner has already practised. Empty means this course was loaded and they have not practised yet."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Save a quiz, mock exam, note, or flashcard set you have already written into a project. To have Studocu generate a quiz or mock exam instead, use request-creation.
| Parameter | Type | Description |
|---|---|---|
| artifact * | any | The creation to save. type is quiz, mockExam, note, or flashcard. Each type has its own content shape. kind must be creation. |
| project_id * | string | UUID of the project that will own the creation. Example: 11111111-1111-4111-8111-111111111111. From create-project or get-context. |
{
"name": "write-artifact",
"title": "Save Study Item to Project",
"description": "Save a quiz, mock exam, note, or flashcard set you have already written into a project. To have Studocu generate a quiz or mock exam instead, use request-creation.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"project_id",
"artifact"
],
"properties": {
"artifact": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"title",
"type",
"content"
],
"properties": {
"kind": {
"type": "string",
"const": "creation",
"description": "Must be the string creation. A project source cannot be written with this tool."
},
"type": {
"type": "string",
"const": "quiz"
},
"title": {
"type": "string",
"maxLength": 255,
"minLength": 20,
"description": "Quiz title shown to the learner. 20-255 characters."
},
"content": {
"type": "object",
"required": [
"questions"
],
"properties": {
"course_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"questions": {
"type": "array",
"items": {
"type": "object",
"required": [
"question",
"answers",
"explanation"
],
"properties": {
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"answer",
"is_correct"
],
"properties": {
"answer": {
"type": "string",
"minLength": 1,
"description": "Answer option text."
},
"is_correct": {
"type": "boolean",
"description": "True for the correct option or options."
}
},
"additionalProperties": false
},
"minItems": 2
},
"question": {
"type": "string",
"minLength": 1,
"description": "Question prompt shown to the learner."
},
"difficulty": {
"enum": [
"EASY",
"MEDIUM",
"HARD"
],
"type": "string"
},
"explanation": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Why the correct answer is right. Required. 1-255 characters."
}
},
"additionalProperties": false
},
"minItems": 1
}
},
"description": "Quiz content.",
"additionalProperties": false
},
"description": {
"type": "string",
"minLength": 1,
"description": "Optional short description of the creation (quiz, mock exam, or flashcard set). The note type does not have this field."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"title",
"type",
"content"
],
"properties": {
"kind": {
"type": "string",
"const": "creation",
"description": "Must be the string creation. A project source cannot be written with this tool."
},
"type": {
"type": "string",
"const": "mockExam"
},
"title": {
"type": "string",
"minLength": 1,
"description": "Title shown to the learner. At least 1 character."
},
"content": {
"type": "object",
"required": [
"exam_json"
],
"properties": {
"exam_json": {
"type": "object",
"required": [
"schema_version",
"title",
"content"
],
"properties": {
"title": {
"type": "string",
"minLength": 1
},
"content": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id",
"question_type"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"kind": {
"type": "string",
"const": "section"
},
"title": {
"type": "string",
"minLength": 1
},
"instructions": {
"type": "string",
"minLength": 1
},
"question_type": {
"enum": [
"mcq",
"multi_select",
"true_false",
"fill_in_blank",
"text_answer_short",
"text_answer_long"
],
"type": "string",
"description": "Question type: mcq, multi_select, true_false, fill_in_blank, text_answer_short, or text_answer_long. Use mcq, not multiple_choice."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id",
"stimulus_markdown"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"kind": {
"type": "string",
"const": "stimulus"
},
"title": {
"type": "string",
"minLength": 1
},
"stimulus_markdown": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
{
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id",
"section_id",
"type",
"marks",
"question_markdown",
"options"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"kind": {
"type": "string",
"const": "question"
},
"type": {
"enum": [
"mcq",
"multi_select",
"true_false"
],
"type": "string"
},
"marks": {
"type": "number",
"minimum": 0
},
"topics": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
{
"type": "null"
}
]
},
"grading": {
"type": "object",
"required": [
"model_answer"
],
"properties": {
"key_points": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"model_answer": {
"type": "string",
"minLength": 1
},
"correct_answer": {
"type": "string"
},
"correct_answer_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
},
"additionalProperties": false
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Stable option id."
},
"text": {
"type": "string",
"minLength": 1,
"description": "Option text."
}
},
"additionalProperties": false
},
"minItems": 2
},
"section_id": {
"type": "string",
"minLength": 1
},
"stimulus_id_refs": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
{
"type": "null"
}
]
},
"question_markdown": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id",
"section_id",
"type",
"marks",
"question_markdown"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"kind": {
"type": "string",
"const": "question"
},
"type": {
"type": "string",
"const": "fill_in_blank"
},
"marks": {
"type": "number",
"minimum": 0
},
"blanks": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string"
}
},
"additionalProperties": false
}
},
"topics": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
{
"type": "null"
}
]
},
"grading": {
"type": "object",
"required": [
"model_answer"
],
"properties": {
"key_points": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"model_answer": {
"type": "string",
"minLength": 1
},
"correct_answer": {
"type": "string"
},
"correct_answer_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
},
"additionalProperties": false
},
"section_id": {
"type": "string",
"minLength": 1
},
"stimulus_id_refs": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
{
"type": "null"
}
]
},
"question_markdown": {
"type": "string",
"minLength": 1
},
"template_markdown": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id",
"section_id",
"type",
"marks",
"question_markdown"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"kind": {
"type": "string",
"const": "question"
},
"type": {
"enum": [
"text_answer_short",
"text_answer_long"
],
"type": "string"
},
"marks": {
"type": "number",
"minimum": 0
},
"topics": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
{
"type": "null"
}
]
},
"grading": {
"type": "object",
"required": [
"model_answer"
],
"properties": {
"key_points": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"model_answer": {
"type": "string",
"minLength": 1
},
"correct_answer": {
"type": "string"
},
"correct_answer_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
},
"additionalProperties": false
},
"section_id": {
"type": "string",
"minLength": 1
},
"stimulus_id_refs": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
{
"type": "null"
}
]
},
"question_markdown": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
}
]
},
"minItems": 1
},
"front_matter": {
"type": "object",
"properties": {
"instructions_markdown": {
"type": "string"
}
},
"additionalProperties": false
},
"schema_version": {
"type": "string",
"const": "0.8"
}
},
"additionalProperties": false
}
},
"description": "Mock exam content.",
"additionalProperties": false
},
"description": {
"type": "string",
"minLength": 1,
"description": "Optional short description of the creation (quiz, mock exam, or flashcard set). The note type does not have this field."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"title",
"type",
"content"
],
"properties": {
"kind": {
"type": "string",
"const": "creation",
"description": "Must be the string creation. A project source cannot be written with this tool."
},
"type": {
"type": "string",
"const": "note"
},
"title": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Note title. 1-255 characters."
},
"content": {
"type": "object",
"required": [
"html"
],
"properties": {
"html": {
"type": "string",
"minLength": 1,
"description": "Complete HTML document for the note body (max 1 MiB UTF-8)."
}
},
"description": "Note content.",
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"title",
"type",
"content"
],
"properties": {
"kind": {
"type": "string",
"const": "creation",
"description": "Must be the string creation. A project source cannot be written with this tool."
},
"type": {
"type": "string",
"const": "flashcard"
},
"title": {
"type": "string",
"minLength": 1,
"description": "Title shown to the learner. At least 1 character."
},
"content": {
"type": "object",
"required": [
"flashcards_json"
],
"properties": {
"flashcards_json": {
"type": "object",
"required": [
"title",
"description",
"flashcards"
],
"properties": {
"title": {
"type": "string",
"minLength": 1
},
"flashcards": {
"type": "array",
"items": {
"type": "object",
"required": [
"front",
"back"
],
"properties": {
"back": {
"type": "string",
"minLength": 1
},
"front": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 200,
"minItems": 1
},
"description": {
"type": "string"
}
},
"additionalProperties": false
}
},
"description": "Flashcard set content.",
"additionalProperties": false
},
"description": {
"type": "string",
"minLength": 1,
"description": "Optional short description of the creation (quiz, mock exam, or flashcard set). The note type does not have this field."
}
},
"additionalProperties": false
}
],
"description": "The creation to save. type is quiz, mockExam, note, or flashcard. Each type has its own content shape. kind must be creation."
},
"project_id": {
"type": "string",
"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)$",
"description": "UUID of the project that will own the creation. Example: 11111111-1111-4111-8111-111111111111. From create-project or get-context."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"artifactId",
"kind",
"projectId",
"type",
"title",
"status"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link that opens this item in its project. Share it with the user."
},
"kind": {
"type": "string",
"const": "creation",
"description": "Artifact kind returned by the write operation."
},
"type": {
"enum": [
"quiz",
"mockExam",
"note",
"flashcard"
],
"type": "string",
"description": "Creation type that was written."
},
"title": {
"type": "string",
"description": "Human-readable title of the created artifact."
},
"status": {
"type": "string",
"const": "created",
"description": "Stable write status for successful creation writes."
},
"projectId": {
"type": "string",
"description": "UUID of the Studocu project that owns the created artifact."
},
"artifactId": {
"type": "string",
"description": "Canonical Studocu artifact URI for the created creation."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Attach up to 10 Studocu documents from search-documents to a project as project sources. Returns the added sources with their studocu:// ids; compare with document_ids if some are missing.
| Parameter | Type | Description |
|---|---|---|
| project_id * | string | UUID of the project that should receive the Studocu documents. Example: 11111111-1111-4111-8111-111111111111. From create-project or get-context. |
| document_ids * | array | 1 to 10 different positive integer Studocu document ids from search-documents (documents[].id). Example: [17, 42]. |
{
"name": "add-document-sources",
"title": "Add Studocu Document Sources",
"description": "Attach up to 10 Studocu documents from search-documents to a project as project sources. Returns the added sources with their studocu:// ids; compare with document_ids if some are missing.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"project_id",
"document_ids"
],
"properties": {
"project_id": {
"type": "string",
"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)$",
"description": "UUID of the project that should receive the Studocu documents. Example: 11111111-1111-4111-8111-111111111111. From create-project or get-context."
},
"document_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 10,
"minItems": 1,
"description": "1 to 10 different positive integer Studocu document ids from search-documents (documents[].id). Example: [17, 42]."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"project_id",
"sources"
],
"properties": {
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_id",
"document_id",
"title",
"status"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link that opens this source in its project. Share it with the user."
},
"title": {
"type": "string",
"minLength": 1
},
"status": {
"type": "string",
"const": "completed"
},
"source_id": {
"type": "string",
"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)$"
},
"document_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
},
"project_id": {
"type": "string",
"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)$"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a new project. Every field is optional. Returns project_id for add-document-sources, write-artifact, and request-creation.
| Parameter | Type | Description |
|---|---|---|
| emoji | string | Icon text, usually an emoji. Example: "📚". Omit to leave the icon unset. |
| title | string | Name, 1-255 characters, with at least one non-space character. Example: "Biology midterm". Omit to create the project without a name; the returned title is then "Untitled project". |
| course_id | integer | Positive integer course id from search-courses. Example: 1581710. The course is checked before the project is created; an unknown id creates nothing. Omit to leave the project unlinked. |
{
"name": "create-project",
"title": "Create Studocu Project",
"description": "Create a new project. Every field is optional. Returns project_id for add-document-sources, write-artifact, and request-creation.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"emoji": {
"type": "string",
"minLength": 1,
"description": "Icon text, usually an emoji. Example: \"📚\". Omit to leave the icon unset."
},
"title": {
"type": "string",
"pattern": "\\S",
"maxLength": 255,
"minLength": 1,
"description": "Name, 1-255 characters, with at least one non-space character. Example: \"Biology midterm\". Omit to create the project without a name; the returned title is then \"Untitled project\"."
},
"course_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Positive integer course id from search-courses. Example: 1581710. The course is checked before the project is created; an unknown id creates nothing. Omit to leave the project unlinked."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"project_id",
"title",
"is_mobile",
"emoji",
"course_id",
"institution_id"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link to the project, for the user to open. Returned to external MCP clients only."
},
"emoji": {
"type": "string",
"minLength": 1
},
"title": {
"type": "string",
"minLength": 1,
"description": "Agent-displayable project title. Null Alpha names become \"Untitled project\"."
},
"course_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
{
"type": "null"
}
]
},
"is_mobile": {
"type": "boolean"
},
"project_id": {
"type": "string",
"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)$",
"description": "UUID string in 8-4-4-4-12 hexadecimal form. Example: 11111111-1111-4111-8111-111111111111."
},
"institution_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Change the name, icon, or linked course of an existing project. Pass course_id null to unlink the course.
| Parameter | Type | Description |
|---|---|---|
| emoji | string | New icon text, usually an emoji. Example: "📚". Omit to leave it unchanged. |
| title | string | New name, 1-255 characters, with at least one non-space character. Example: "Biology midterm". Omit to leave the name unchanged. |
| course_id | any | Positive integer course id from search-courses, or null to unlink the course. Example: 1581710. Omit to leave the link unchanged. |
| project_id * | string | UUID of the project to change. Example: 11111111-1111-4111-8111-111111111111. From create-project or get-context. |
{
"name": "update-project",
"title": "Update Studocu Project",
"description": "Change the name, icon, or linked course of an existing project. Pass course_id null to unlink the course.",
"inputSchema": {
"type": "object",
"anyOf": [
{
"required": [
"title"
]
},
{
"required": [
"emoji"
]
},
{
"required": [
"course_id"
]
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"project_id"
],
"properties": {
"emoji": {
"type": "string",
"minLength": 1,
"description": "New icon text, usually an emoji. Example: \"📚\". Omit to leave it unchanged."
},
"title": {
"type": "string",
"pattern": "\\S",
"maxLength": 255,
"minLength": 1,
"description": "New name, 1-255 characters, with at least one non-space character. Example: \"Biology midterm\". Omit to leave the name unchanged."
},
"course_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
{
"type": "null"
}
],
"description": "Positive integer course id from search-courses, or null to unlink the course. Example: 1581710. Omit to leave the link unchanged."
},
"project_id": {
"type": "string",
"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)$",
"description": "UUID of the project to change. Example: 11111111-1111-4111-8111-111111111111. From create-project or get-context."
}
},
"minProperties": 2,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"project_id",
"title",
"is_mobile",
"emoji",
"course_id",
"institution_id"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link to the project, for the user to open. Returned to external MCP clients only."
},
"emoji": {
"type": "string",
"minLength": 1
},
"title": {
"type": "string",
"minLength": 1,
"description": "Agent-displayable project title. Null Alpha names become \"Untitled project\"."
},
"course_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
{
"type": "null"
}
]
},
"is_mobile": {
"type": "boolean"
},
"project_id": {
"type": "string",
"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)$",
"description": "UUID string in 8-4-4-4-12 hexadecimal form. Example: 11111111-1111-4111-8111-111111111111."
},
"institution_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Ask Studocu to generate a quiz or mock exam from 1 to 10 project sources. Can take about 3 minutes. If status is creating or outcome_unknown, check get-project-state before calling again.
| Parameter | Type | Description |
|---|---|---|
| type * | string | What to generate: quiz or mockExam. |
| project_id * | string | UUID of the project that owns the project sources. Example: 11111111-1111-4111-8111-111111111111. From create-project or get-context. |
| instruction | string | Optional hint, 1-6000 characters. Example: "focus on chapter 3". Omit for a general quiz or mock exam. |
| artifact_ids * | array | 1 to 10 different project source ids to generate from. Each id looks like studocu://project/{project_id}/source/{uuid} and must belong to project_id. Get them from add-document-sources or get-project-state. Do not pass creation ids. |
| idempotency_key | string | Optional retry key, 1-256 characters. Send the same key when you retry the same request. A different request body with a used key is rejected. Omit to let Studocu derive a key from the request; identical retries still count as the same request. |
{
"name": "request-creation",
"title": "Generate Quiz or Mock Exam",
"description": "Ask Studocu to generate a quiz or mock exam from 1 to 10 project sources. Can take about 3 minutes. If status is creating or outcome_unknown, check get-project-state before calling again.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"project_id",
"type",
"artifact_ids"
],
"properties": {
"type": {
"enum": [
"quiz",
"mockExam"
],
"type": "string",
"description": "What to generate: quiz or mockExam."
},
"project_id": {
"type": "string",
"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)$",
"description": "UUID of the project that owns the project sources. Example: 11111111-1111-4111-8111-111111111111. From create-project or get-context."
},
"instruction": {
"type": "string",
"maxLength": 6000,
"minLength": 1,
"description": "Optional hint, 1-6000 characters. Example: \"focus on chapter 3\". Omit for a general quiz or mock exam."
},
"artifact_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 10,
"minItems": 1,
"description": "1 to 10 different project source ids to generate from. Each id looks like studocu://project/{project_id}/source/{uuid} and must belong to project_id. Get them from add-document-sources or get-project-state. Do not pass creation ids."
},
"idempotency_key": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"description": "Optional retry key, 1-256 characters. Send the same key when you retry the same request. A different request body with a used key is rejected. Omit to let Studocu derive a key from the request; identical retries still count as the same request."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"type",
"status"
],
"properties": {
"url": {
"type": "string",
"description": "Studocu web link for the user: the creation when status is created, otherwise its project. Share it with the user."
},
"type": {
"enum": [
"quiz",
"mockExam"
],
"type": "string"
},
"status": {
"enum": [
"created",
"creating",
"outcome_unknown"
],
"type": "string",
"description": "created: saved, with artifact_id and external_id. creating: generation finished but the new creation is not linked yet; match external_id on get-project-state. outcome_unknown: the call timed out or a duplicate is still running; check get-project-state and do not send a new retry key. Failures come back as errors, not as a status."
},
"artifact_id": {
"type": "string",
"minLength": 1,
"description": "Agent OS artifact ID of the new creation. Present when status is created."
},
"external_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "Quiz id or mock-exam id. Present when status is created or creating. Match it on get-project-state. Omitted when the call times out."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Read memories saved for this signed-in learner: one per scope and kind.
| Parameter | Type | Description |
|---|---|---|
| kind | string | Return only this kind. Example: "study_preference". Omit to return every saved memory in the chosen scope. |
| scope | string | Which memories to read: global (learner-wide), project (one project), or both. If omitted, the scope is both when project_id is a UUID, otherwise global. |
| project_id | any | UUID of the project, or null. Example: 11111111-1111-4111-8111-111111111111. Required when scope is project or both. Omit or null for learner-wide memories. Ignored when scope is global. |
{
"name": "read-memory",
"title": "Read Studocu Agent Memory",
"description": "Read memories saved for this signed-in learner: one per scope and kind.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"kind": {
"type": "string",
"minLength": 1,
"description": "Return only this kind. Example: \"study_preference\". Omit to return every saved memory in the chosen scope."
},
"scope": {
"enum": [
"global",
"project",
"both"
],
"type": "string",
"description": "Which memories to read: global (learner-wide), project (one project), or both. If omitted, the scope is both when project_id is a UUID, otherwise global."
},
"project_id": {
"anyOf": [
{
"type": "string",
"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": "null"
}
],
"description": "UUID of the project, or null. Example: 11111111-1111-4111-8111-111111111111. Required when scope is project or both. Omit or null for learner-wide memories. Ignored when scope is global."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"memories"
],
"properties": {
"memories": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"projectId",
"value",
"updatedAt"
],
"properties": {
"kind": {
"type": "string",
"description": "Memory kind for this document."
},
"value": {
"type": "object",
"description": "Freeform memory document.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"projectId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Owning project UUID, or null for global memory."
},
"updatedAt": {
"type": "string",
"description": "Last time this memory document changed."
}
},
"additionalProperties": false
},
"description": "Durable memory documents for the authenticated user."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Save one memory (a preference or project fact) for this learner. Writing the same kind again replaces it.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | Kind for this memory. At least 1 character. Example: "study_preference" or "project_learning_context". Writing the same kind again replaces the previous memory. |
| value * | object | JSON object to store. Usual shape: { "content": "the memory text" }. Other keys are allowed. |
| project_id | any | UUID of the project this memory belongs to, or null. Example: 11111111-1111-4111-8111-111111111111. Omit or null to store a learner-wide memory. |
{
"name": "write-memory",
"title": "Write Studocu Agent Memory",
"description": "Save one memory (a preference or project fact) for this learner. Writing the same kind again replaces it.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"type": "string",
"minLength": 1,
"description": "Kind for this memory. At least 1 character. Example: \"study_preference\" or \"project_learning_context\". Writing the same kind again replaces the previous memory."
},
"value": {
"type": "object",
"description": "JSON object to store. Usual shape: { \"content\": \"the memory text\" }. Other keys are allowed.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"project_id": {
"anyOf": [
{
"type": "string",
"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": "null"
}
],
"description": "UUID of the project this memory belongs to, or null. Example: 11111111-1111-4111-8111-111111111111. Omit or null to store a learner-wide memory."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"userId",
"projectId",
"kind",
"value",
"createdAt",
"updatedAt"
],
"properties": {
"kind": {
"type": "string",
"description": "Memory kind that was written."
},
"value": {
"type": "object",
"description": "Stored memory document.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"userId": {
"type": "string",
"description": "Owner of the memory document."
},
"createdAt": {
"type": "string",
"description": "Creation timestamp of the row."
},
"projectId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Owning project UUID, or null for global memory."
},
"updatedAt": {
"type": "string",
"description": "Last write timestamp of the row."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Delete one saved memory for this learner, chosen by project_id and kind.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | Kind of the memory to delete. Example: "study_preference" or "project_learning_context". |
| project_id | any | UUID of the project memory to delete, or null. Example: 11111111-1111-4111-8111-111111111111. Omit or null to delete a learner-wide memory. |
{
"name": "delete-memory",
"title": "Delete Studocu Agent Memory",
"description": "Delete one saved memory for this learner, chosen by project_id and kind.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"minLength": 1,
"description": "Kind of the memory to delete. Example: \"study_preference\" or \"project_learning_context\"."
},
"project_id": {
"anyOf": [
{
"type": "string",
"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": "null"
}
],
"description": "UUID of the project memory to delete, or null. Example: 11111111-1111-4111-8111-111111111111. Omit or null to delete a learner-wide memory."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"userId",
"projectId",
"kind",
"deleted"
],
"properties": {
"kind": {
"type": "string",
"description": "Memory kind that was deleted."
},
"userId": {
"type": "string",
"description": "Owner of the deleted memory document."
},
"deleted": {
"type": "boolean",
"const": true,
"description": "Always true when the delete succeeds."
},
"projectId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Owning project UUID, or null for global memory."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Search Studocu and, after the learner signs in, work with their projects. search-documents, search-institutions, search-courses, list-degrees, get-course-syllabus, and list-course-recordings need no login, and neither does previewing Studocu documents; every other tool needs a signed-in Studocu account. Leave the Authorization header off when the learner is not signed in: a bad or expired token is rejected, even for the no-login tools. Do not call search-institutions or search-courses before every search-documents.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| institution_id |
| integer |
| Numeric school id from search-institutions (the id field). Example: 42. Omit to search every school. Prefer setting it when you already know the school. |
{
"name": "search-courses",
"title": "Search Courses",
"description": "Find a course on Studocu by name or code, to get its course_id for search-documents, get-course-syllabus, or get-course-mastery. Pass institution_id from search-institutions when you know the school. For a high school, pass degree_id and grade_id from list-degrees. Those ids are national, so a school is optional. With a school, the level filter is added to that school search. Ids only, not names. Pass include_levels: true to include degree and grade on every course. A course whose institution_id is null cannot be used to create or update a project. Prefer a course with an institution_id, or ask the user to pick their school. Show the user the name, code, school, degree, and grade, not the ids. If several results are plausible, ask the user to pick.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 3,
"maximum": 10,
"minimum": 1,
"description": "How many courses to return. Integer from 1 to 10. Default 3."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Course name or code, 1-200 characters after trimming. Example: \"ECON101\" or \"Introduction to Psychology\"."
},
"grade_id": {
"type": "integer",
"maximum": 2147483647,
"description": "Numeric national high-school grade id, taken from list-degrees (grades[].id) or from grade.id on a search-courses result. Never guess it and never pass the grade name. A school is optional. Omit if unknown.",
"exclusiveMinimum": 0
},
"degree_id": {
"type": "integer",
"maximum": 2147483647,
"description": "Numeric national high-school degree id, taken from list-degrees (the id field) or from degree.id on a search-courses result. Never guess it and never pass the degree name. A school is optional. Matches courses of that degree and courses of its grades. Omit if unknown.",
"exclusiveMinimum": 0
},
"include_levels": {
"type": "boolean",
"description": "Set true to include degree and grade on every course. Omit for the legacy payload."
},
"institution_id": {
"type": "integer",
"maximum": 2147483647,
"description": "Numeric school id from search-institutions (the id field). Example: 42. Omit to search every school. Prefer setting it when you already know the school.",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"courses"
],
"properties": {
"courses": {
"type": "array",
"items": {
"type": "object",
"required": [
"course_id",
"name",
"code",
"institution_id"
],
"properties": {
"code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"grade": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"degree_id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"name": {
"type": "string"
},
"degree_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"degree": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"course_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"institution_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"institution_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}