Lumen is a self-hostable AI-first LMS that combines a course-scoped RAG tutor, AI-assisted course authoring, spaced-repetition reviews, and learning-path planning. It also exposes an MCP server with tools for courses, tutoring, drafts, reviews, progress, and lesson search.
From the registry: Self-hostable agentic-AI LMS: catalog, RAG tutor, FSRS reviews, AI authoring, ingest.

$ make mcp-tokenPlease install the `lumen` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Run a Lumen instance** — You need a running Lumen backend that the MCP server can access, because the README instructs generating an auth token against your running Lumen instance.
- **Generate MCP auth token** — Generate a LUMEN_MCP_AUTH_TOKEN using `make mcp-token` against your running Lumen instance. The README says this prints a fresh OAuth client_id and client_secret pair; use the secret as the env value. Run: `make mcp-token`
- **Provide database connection** — Set DATABASE_URL to the Postgres URL for the Lumen instance the MCP server should use.
Optional prerequisites:
- Install uv — Install the uv Python package manager/runner so you can launch the MCP server with uvx. (https://docs.astral.sh/uv/)
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["--from","lumen-backend","python","-m","app.mcp","--transport","stdio"]
- required environment variables:
- `LUMEN_MCP_AUTH_TOKEN`: OAuth client secret / auth token generated with `make mcp-token` against your running Lumen instance. (example: `<your-token>`)
- `DATABASE_URL`: Postgres connection URL for the Lumen instance. (example: `<postgres-url>`)
Note: The README also mentions the server exposes tools over stdio + HTTP, but only provides a usable stdio launch command/config snippet. Claude Code shows a shorter local command (`python -m app.mcp --transport stdio`), but the README’s explicit portable config snippet uses `uvx --from lumen-backend ...`, which is preferred.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.
Persistent codebase knowledge graph. Survives session restarts and context compaction.
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.