MCP overview

LearnOS exposes your workspace to MCP-capable agents — Claude Code, Claude Desktop, Cursor, or anything that speaks the Model Context Protocol — through a hosted endpoint at https://learnosapp.com/mcp. Authenticate with a personal access token; the server attributes every call to your user and enforces the same row-level security the web app uses.

Surface

• Tools — list_courses, search_lessons, list_lessons, get_lesson, get_chunk, create_course, add_lesson, add_lessons_from_markdown, create_flashcard, append_note, and more (20 in total).
• Resources — learnos://course/{id}, learnos://lesson/{id}.
• Prompts — learnos-ask.

Key properties

• Read your library + write to it. Search and read run under your row-level security; writes (create course, add lesson, create flashcard, append note) also run as you and inherit the same constraints.
• Lesson writes are searchable immediately. create_course / add_lesson / add_lessons_from_markdown / add_course_from_directory build sections and embed them in one call; keyword + semantic search are both live the moment the write returns. create_flashcard persists only. append_note persists immediately; note text enters semantic search asynchronously.
• PAT-authenticated, audit-logged. The server validates your Authorization: Bearer los_... header on every request and records the call (tool name, success, latency, source) in your usage log.
• The model lives in the client. The MCP server never generates the user-facing answer; your client's model does, using LearnOS tools to retrieve grounded context and citations.

See Install for the one-config snippet to wire up your client.