Servers Playground How we check Add a server Log in

Studocu

Working · 1.7 s

com.studocu/studocuv1.0.0 Domain verified

Find Studocu study documents, courses and institutions, and manage study projects and quizzes.

Education

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://agent-os-mcp.alpha.studocu.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add-document-sources

Attach up to 10 Studocu documents from search-documents to a project. Returns the sources that were successfully added; compare with document_ids if some were omitted.

project_idstring, required

UUID of the Studocu project that will receive the document sources.

document_idsarray, required

One to ten unique Studocu document IDs returned by search-documents.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Studocu MCP server | mcptry

Tools (18)

add-document-sources

Attach up to 10 Studocu documents from search-documents to a project. Returns the sources that were successfully added; compare with document_ids if some were omitted.

Argument	Type	Description
project_id*	string	UUID of the Studocu project that will receive the document sources.
document_ids*	array	One to ten unique Studocu document IDs returned by search-documents.

Input schema (JSON)

{
  "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 Studocu project that will receive the document sources."
    },
    "document_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "One to ten unique Studocu document IDs returned by search-documents."
    }
  }
}

agent-os-session

Use this proof tool to verify that the Agent OS MCP server received a valid delegated Studocu session.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

create-project

Create a Studocu project and optionally configure its emoji and course. A numeric course_id is validated before project creation.

Argument	Type	Description
emoji	string
title	string
course_id	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "emoji": {
      "type": "string",
      "minLength": 1
    },
    "title": {
      "type": "string",
      "pattern": "\\S",
      "maxLength": 255,
      "minLength": 1
    },
    "course_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

delete-memory

Delete one durable memory document identified by (scope, kind) for the authenticated user. Provide project_id for project-local memory, or null/omit for global. Identity comes from Core via the session bearer, not from input.

destructive

Argument	Type	Description
kind*	string	Memory kind to delete, e.g. study_preference or project_learning_context.
project_id	any	Project UUID for project-local memory; null or omitted deletes global (user-level) memory.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "kind"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "minLength": 1,
      "description": "Memory kind to delete, e.g. 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": "Project UUID for project-local memory; null or omitted deletes global (user-level) memory."
    }
  }
}

get-context

Return the unified Agent OS context manifest for the authenticated user: profile, followed courses, project metadata, and recent activity. Every project includes has_course_mastery and started_course_mastery (course supports Infinite Practice / learner has started it). Course mastery is visible only on projects, not followed_courses. Practised-topic detail (topic_masteries) is included only when a course is in scope (project_id, a sole remaining project, or remaining projects that share one course_id); the field is omitted when detail was not loaded. Empty topic_masteries means that course was loaded and the learner has no practised topics. Use get-course-mastery(course_id) for the practised-topic list when context omitted detail. Agent OS is read-only: chatting or calling this tool does not change mastery. Source of truth is Infinite Practice attempts (identity + course + topic); web IP writes, ACE/mobile/Agent OS only read.

read-only

Argument	Type	Description
course_id	any	Narrow context to a single followed course and its projects.
project_id	string	Narrow context to a single project by id.
active_only	boolean	Limit the manifest to active context.
recent_only	boolean	Limit the manifest to recently active context.

Input schema (JSON)

{
  "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": "Narrow context to a single followed course and its projects."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "Narrow context to a single project by id."
    },
    "active_only": {
      "type": "boolean",
      "description": "Limit the manifest to active context."
    },
    "recent_only": {
      "type": "boolean",
      "description": "Limit the manifest to recently active context."
    }
  }
}

get-course-mastery

Return practised-topic Infinite Practice mastery for a course (topic_id, topic_name when available, display 0–100, questions_answered). Use after get-context flags (has_course_mastery / started_course_mastery) or whenever context omitted topic_masteries. Agent OS is read-only: chatting, creating artifacts, or calling this tool does not change mastery. Source of truth is Infinite Practice attempts (user_topic_mastery: identity + course + topic); display matches the web IP UI. Progress is learner- and course-scoped, not chat- or client-scoped — web IP writes it; ACE/mobile/Agent OS only read the same rows. Empty topic_masteries means no IP attempts yet, not a separate client score. Requires course_id.

read-only

Argument	Type	Description
course_id*	integer	Course id to load practised-topic Infinite Practice mastery for.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "course_id"
  ],
  "properties": {
    "course_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Course id to load practised-topic Infinite Practice mastery for.",
      "exclusiveMinimum": 0
    }
  }
}

get-course-syllabus

Return a generated course outline as markdown when this tool has one. This is the best grounding for high-quality study guidance. If it is missing, a syllabus may be generating, so try again in a few minutes. Requires course_id.

read-only

Argument	Type	Description
course_id*	integer	Studocu course id whose published syllabus should be loaded.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "course_id"
  ],
  "properties": {
    "course_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Studocu course id whose published syllabus should be loaded.",
      "exclusiveMinimum": 0
    }
  }
}

get-project-state

Return sources and creations (project state) for one or more projects by id. Creation rows may include external_id (quizId or mockExamId) so a request-creation creating response can be matched once Alpha identity appears. Use after get-context (which lists projects without their sources/creations) to load those projects' artifacts. Only projects you can access are returned.

read-only

Argument	Type	Description
ids*	array	The project ids to load sources and creations (project state) for. Only projects you can access are returned.

Input schema (JSON)

{
  "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": "The project ids to load sources and creations (project state) for. Only projects you can access are returned."
    }
  }
}

read-artifact

Read a Studocu project source or creation by its studocu://project/{project_id}/{kind}/{uuid} URI. Returns normalized metadata with explicitly mapped inline content.

read-only

Argument	Type	Description
cursor	string	Opaque continuation cursor returned by a previous read.
artifact_id*	string	Artifact URI in the form studocu://project/{project_id}/{kind}/{uuid}.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "artifact_id"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 1,
      "description": "Opaque continuation cursor returned by a previous read."
    },
    "artifact_id": {
      "type": "string",
      "minLength": 1,
      "description": "Artifact URI in the form studocu://project/{project_id}/{kind}/{uuid}."
    }
  }
}

read-detached-document

Read a Studocu document directly, without requiring or creating a project source. Use read-artifact for documents attached to a project.

read-only

Argument	Type	Description
document_id*	integer	Studocu document ID to read without creating a project source.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "document_id"
  ],
  "properties": {
    "document_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Studocu document ID to read without creating a project source.",
      "exclusiveMinimum": 0
    }
  }
}

read-memory

Read durable agent memory for the authenticated user. Returns one document per (scope, kind); use project_id for project-scoped memory. Identity comes from Core via the session bearer, not from input.

read-only

Argument	Type	Description
kind	string	Narrow the result to a single memory kind.
scope	string	Memory scope to read: global, project, or both. Defaults to global unless project_id is set.
project_id	any	Project UUID for project-scoped memory; null or omitted reads global (user-level) memory. Required when scope is project or both.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "kind": {
      "type": "string",
      "minLength": 1,
      "description": "Narrow the result to a single memory kind."
    },
    "scope": {
      "enum": [
        "global",
        "project",
        "both"
      ],
      "type": "string",
      "description": "Memory scope to read: global, project, or both. Defaults to global unless project_id is set."
    },
    "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": "Project UUID for project-scoped memory; null or omitted reads global (user-level) memory. Required when scope is project or both."
    }
  }
}

request-creation

Generate a Studocu quiz or mockExam from 1-10 project source artifacts. Waits up to ~3 minutes; returns artifact_id and external_id when created, status creating with external_id when persist is not yet visible, or outcome_unknown on client timeout or in-flight duplicate (check get-project-state before retrying). Optional idempotency_key is forwarded as Idempotency-Key; identical retries without a key still dedupe.

Argument	Type	Description
type*	string	The kind of creation to generate: quiz or mockExam.
project_id*	string	UUID of the Studocu project that will own the new creation.
instruction	string	Optional free-text hint for the generating agent (e.g. "focus on chapter 3").
artifact_ids*	array	One to ten unique source artifact IDs (studocu://project/{project_id}/source/{uuid}) to generate from.
idempotency_key	string	Optional retry key. Agent OS always sends Idempotency-Key to Alpha (this value, or a fingerprint of project/type/sources/instruction). Reuse with a different body is rejected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "type",
    "artifact_ids"
  ],
  "properties": {
    "type": {
      "enum": [
        "quiz",
        "mockExam"
      ],
      "type": "string",
      "description": "The kind of creation 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 Studocu project that will own the new creation."
    },
    "instruction": {
      "type": "string",
      "maxLength": 6000,
      "minLength": 1,
      "description": "Optional free-text hint for the generating agent (e.g. \"focus on chapter 3\")."
    },
    "artifact_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "One to ten unique source artifact IDs (studocu://project/{project_id}/source/{uuid}) to generate from."
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "Optional retry key. Agent OS always sends Idempotency-Key to Alpha (this value, or a fingerprint of project/type/sources/instruction). Reuse with a different body is rejected."
    }
  }
}

search-courses

Search Studocu courses when establishing or correcting course context. Prefer institution_id from search-institutions to scope results. Omit institution_id only when the institution is unknown: results then include catalog institution_id, and institution_name when Algolia has it. Do not require this before every document search. Structured results include course_id, name, code (nullable), institution_id, and optional institution_name. When talking to the user, present name, course code, and institution name only — do not show internal IDs. Auto-pick a clear top match; if the shortlist is ambiguous, ask the user to choose by name/code. Resolved IDs are conversation-scoped until a persistence capability owns them.

read-only

Argument	Type	Description
limit	integer
query*	string
institution_id	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 3,
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "institution_id": {
      "type": "integer",
      "maximum": 2147483647,
      "exclusiveMinimum": 0
    }
  }
}

search-documents

Use this when the user wants to find, search, or browse study documents, lecture notes, summaries, or course materials on Studocu. Pass topic/keywords as `query` only — never put course name, course id, or institution name in `query`. `institution` is a display name only (this tool has no institution_id). Prefer numeric `course_id` from search-courses when you have it: it pins the course and overrules `course`. If both `course_id` and `institution` are sent, `course_id` wins; result institution is that course's university, not the name you passed. Otherwise pass `course` as name or code, never as a numeric id. `course` is optional extra if you already have `course_id`. Omit unknown filters. Returns matching documents with titles, course and institution info, ratings, and a link to view each on Studocu. Results with `match_type: semantic` are closest matches, not exact keyword hits, and may be only loosely related; check them against the request.

read-only

Argument	Type	Description
limit	integer	Number of results to return (1-50, default: 10).
query*	string	Topic/keywords only (e.g. "supply and demand", "microeconomics midterm 2025"). Never put course name, course id, or institution name here — use `institution`, `course`, and `course_id` instead.
course	string	Course name or code only, e.g. "Economics" or "ECON101". Use when you do not have `course_id`. Never put a numeric id here. Optional extra if you also have `course_id`. Omit entirely if unknown.
course_id	integer	Numeric Studocu course ID from search-courses `course_id`. Prefer this: it pins the course and overrules `course` name/code. Omit if you only have a name/code.

search-institutions

Search Studocu institutions by name when establishing or correcting education context (onboarding / context setup). Do not require this before every document search. Structured results include id, name, type, region_code, and country for follow-up tools. When talking to the user, present name/type/country/region only — do not show internal IDs. Auto-pick a clear top match; if the shortlist is ambiguous, ask the user to choose by name. Resolved IDs are conversation-scoped until a persistence capability owns them.

read-only

Argument	Type	Description
type	string
limit	integer
query*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "type": {
      "enum": [
        "UNIVERSITY",
        "HIGH_SCHOOL"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 3,
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    }
  }
}

update-project

Update a Studocu project title, emoji, or course. Use course_id null to clear the course and institution.

Argument	Type	Description
emoji	string
title	string
course_id	any
project_id*	string	NOTE: These shared primitives are copied from the AI API spec and owned locally by Agent OS to keep this contract decoupled.

Input schema (JSON)

{
  "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
    },
    "title": {
      "type": "string",
      "pattern": "\\S",
      "maxLength": 255,
      "minLength": 1
    },
    "course_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ]
    },
    "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": "NOTE: These shared primitives are copied from the AI API spec and owned\nlocally by Agent OS to keep this contract decoupled."
    }
  },
  "minProperties": 2,
  "additionalProperties": false
}

write-artifact

Create a Studocu artifact from typed content. Provide project_id and an artifact envelope; the artifact type defines the required content shape.

Argument	Type	Description
artifact*	any	The artifact to create. Pick type; each type defines its own content shape.
project_id*	string	UUID of the Studocu project that will own the artifact.

Input schema (JSON)

{
  "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": "Artifact kind. Only creation is writable in this MVP."
            },
            "type": {
              "type": "string",
              "const": "quiz"
            },
            "title": {
              "type": "string",
              "maxLength": 255,
              "minLength": 20,
              "description": "Human-readable quiz title (Core Labs API requires 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": "Required explanation for the correct answer (Core quiz API requires it, max 255 characters)."
                      }
                    },
                    "additionalProperties": false
                  },
                  "minItems": 1
                }
              },
              "description": "Quiz content.",
              "additionalProperties": false
            },
            "description": {
              "type": "string",
              "minLength": 1,
              "description": "Optional description stored on the creation record."
            }
          },
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "kind",
            "title",
            "type",
            "content"
          ],
          "properties": {
            "kind": {
              "type": "string",
              "const": "creation",
              "description": "Artifact kind. Only creation is writable in this MVP."
            },
            "type": {
              "type": "string",
              "const": "mockExam"
            },
            "title": {
              "type": "string",
              "minLength": 1,
              "description": "Human-readable title for the created artifact."
            },
            "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": "Frontend-supported KnowledgeTest question type. 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 description stored on the creation record."
            }
          },
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "kind",
            "title",
            "type",
            "content"
          ],
          "properties": {
            "kind": {
              "type": "string",
              "const": "creation",
              "description": "Artifact kind. Only creation is writable in this MVP."
            },
            "type": {
              "type": "string",
              "const": "note"
            },
            "title": {
              "type": "string",
              "maxLength": 255,
              "minLength": 1,
              "description": "Human-readable note title (Alpha creation store max 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": "Artifact kind. Only creation is writable in this MVP."
            },
            "type": {
              "type": "string",
              "const": "flashcard"
            },
            "title": {
              "type": "string",
              "minLength": 1,
              "description": "Human-readable title for the created artifact."
            },
            "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 description stored on the creation record."
            }
          },
          "additionalProperties": false
        }
      ],
      "description": "The artifact to create. Pick type; each type defines its own content shape."
    },
    "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 Studocu project that will own the artifact."
    }
  }
}

write-memory

Upsert one durable memory document per (scope, kind) for the authenticated user. Provide project_id for project-local memory, or null/omit for global. Identity comes from Core via the session bearer, not from input.

destructive

Argument	Type	Description
kind*	string	Memory kind, e.g. study_preference or project_learning_context.
value*	object	Freeform memory document. MVP convention is { content: string }.
project_id	any	Project UUID for project-local memory; null or omitted stores global (user-level) memory.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "kind",
    "value"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "minLength": 1,
      "description": "Memory kind, e.g. study_preference or project_learning_context."
    },
    "value": {
      "type": "object",
      "description": "Freeform memory document. MVP convention is { content: string }.",
      "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": "Project UUID for project-local memory; null or omitted stores global (user-level) memory."
    }
  }
}