learn.ninja MCP server
Commit Nov 14, 2026Converts articles, documents, or code into short, interactive, shareable lessons for AI agents to teach users.
Also known as learn-ninja/learn.ninja, learn-ninja
- Stars
- 6
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 14, 2026
- License
- Apache-2.0
What is learn.ninja MCP?
learn.ninja converts articles, documents, or code into short, interactive, shareable lessons for AI agents to teach users.
Summary generated from the project's README
About learn.ninja MCP server
Transforming articles, code, or documentation into interactive lessons is what learn.ninja enables for developers using AI agents. By providing an agent with a transcript, notes, or a technical document, users can generate short, shareable lessons that function like Duolingo or Brilliant. These lessons consist of concept katas for teaching and various question katas, such as choice, match, or sort, to test comprehension with instant feedback.
Developers can integrate this functionality into tools like Claude Code, Cursor, or Gemini CLI by adding the skill via npx. For chat-based interfaces like ChatGPT, the server connects via a specific MCP endpoint. The system is designed to be lightweight, requiring no accounts or API keys to use. Lessons are published to a web link that works on any browser and is optimized for mobile devices, supporting multiple languages and right-to-left text.
What you can do with it
- 1Convert documentation into trainingAsk your AI agent to create a lesson from a technical article or deployment guide to teach your team.
- 2Study specific chapters or topicsRequest a quiz based on a specific section of text to test your knowledge.
- 3Generate shareable learning linksHave an agent write and publish a lesson to a URL that can be shared with others.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablelearn-ninja/learn.ninja is public and reachablegithub.com/learn-ninja/learn.ninja ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-14github.com/learn-ninja/learn.ninja ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHublearn.ninja
Vibe learn anything with your agent.
Give your AI agent an article, notes, docs, a transcript, or code. It writes one short, interactive lesson and gives you a link to share. Free, no account.
Website · Docs · Try a lesson · Contributing
Make a lesson
Install the skill in your agent (Claude Code, Codex, Cursor, Gemini CLI, and more):
npx skills add https://learn.ninja -g
Then ask it for a lesson from anything: "Make me a lesson from this article", "Teach my team how our deploy works", "Quiz me on chapter 3". The agent writes the lesson, checks it, and publishes it to a link that plays in any browser.
Chat apps (Claude, ChatGPT) connect to the MCP server at https://learn.ninja/mcp instead. The docs cover both.
What a lesson is
A lesson is made of katas, one per screen, Duolingo- or Brilliant-style: concept katas teach, and question katas (choice, compare, hotspot, sort, order, match, blank, scenario) check what stuck, with instant feedback and hints from the ninja. Lessons are written in any language, right-to-left included, and play on phones.
Try the example lessons (their files are in examples/):
- How compound interest works (beginner)
- JavaScript map vs forEach (beginner)
- Basic Spanish greetings (beginner)
- Correlation isn't causation (intermediate)
- Why the Bronze Age collapsed (advanced)
This repository is the whole thing: the website, the lesson player, the lesson format, the learn command, and the skill agents install.
Run it locally
You need Node 24 (see .nvmrc) and npm. Nothing else: no database, no accounts, no keys.
npm install
npm run dev
The web app runs at http://localhost:3000: the home page, the docs at /docs, and the test lessons at /lessons/{slug}. Lessons you publish locally are kept in PGlite (Postgres in WebAssembly) under apps/web/.data/pglite, rate limits are counted in memory, and sign-in codes and feedback are printed to the server console. .env.example lists the variables a hosted deployment uses; none of them are needed here.
To publish to your local server from an agent, set LEARN_API_URL=http://localhost:3000 before running the skill.
Commands
| Command | What it does |
|---|---|
npm run dev |
Start the web app (webpack) |
npm run check |
Lint, type-check, and tests across every package. Run it after every change; CI runs it too, plus a production build |
npm run build |
Production build |
npm run storybook |
Storybook at http://localhost:6006, with every kata type in every state |
npm run skill:build -w @workspace/cli |
Rebuild skills/learn (bundled CLI, schema, examples) after changing the spec, the CLI, or the examples |
npm run schema -w @workspace/spec |
Re-export packages/spec/schema/lesson.schema.json after changing the spec |
npm run map -w @workspace/player |
Rebuild the map visual's country shapes from Natural Earth |
npm run bento -w web |
Redraw the home page's lesson visuals after changing apps/web/lib/bento-visuals.ts |
npm run favicon -w web |
Rebuild the favicon from apps/web/app/icon.svg |
npm run share -w web |
Re-render the share images in brand/ |
A test fails when a generated file is stale, so npm run check tells you which of these to run.
Structure
| Path | What it is |
|---|---|
apps/web |
Next.js app: home page, docs, lesson player pages, publish API, MCP server |
apps/storybook |
Storybook for the player and UI components |
docs/ |
The docs pages, as Markdown and MDX |
packages/spec |
The lesson format: Zod schema, JSON Schema, and the checker's rules |
packages/player |
The lesson screens and every kata |
packages/ui |
shadcn/ui components on React Aria, shared styles |
packages/db |
The Postgres schema (Drizzle) and its migrations |
packages/cli |
The learn command: sync, validate, and publish lessons |
skills/learn |
The installable lesson skill and its teaching guide |
examples/ |
Test lessons, used as fixtures |
Contributing
learn.ninja is built by a few people, so help goes a long way. These are the places we'd most like it:
- Languages: translate the player's interface into your language, or fix right-to-left issues.
- Visuals: new map regions, charts, diagrams, chess boards, molecules.
- Sounds and motion: better sound effects, transitions, and celebration moments.
- The teaching guide: help agents write better lessons, and add example lessons.
- Docs, bugs, and accessibility: always welcome as a pull request, no proposal needed.
New to the code? Pick one of the good first issues. Changes to the lesson format, new kata types, agent round trips, and the ninja's voice start as an Idea issue. CONTRIBUTING.md has the details, the conventions, and how review works; agent-written pull requests are welcome too.
Found a security issue? See SECURITY.md. Everyone taking part follows the Code of Conduct.
License
The code is Apache-2.0. The example lessons in examples/ and the docs in docs/ are CC-BY-4.0. The learn.ninja name, the logo, the files in brand/, and the ninja character are trademarks of Uxcel Inc; see TRADEMARK.md for what forks may and may not do with them.
learn.ninja MCP questions
Do I need an account to use it?
No, the service is free and does not require an account.
Can I run the server locally?
Yes, you can run it locally using Node 24 and npm without needing a database or API keys.