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 OAuth (browser consent): your session token reaches the database, so every call runs under the same row-level security the web app uses. A personal access token is a fallback for CI only — see Install.

Surface

• Tools — list_courses, search_lessons, list_lessons, get_lesson, get_chunk, create_flashcard, append_note, get_course_progress, and more.
• Prompts — learnos-ask.

Key properties

• Study your library. With OAuth, search and read run under your row-level security; study writes (create flashcard, append note, presentations) also run as you and inherit the same constraints. append_note persists immediately; note text enters semantic search asynchronously.
• Authenticated, audit-logged. The server validates your OAuth token or 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.