Vibe learning for the Agentic Era
Free and fully open source, written by Quinton Wall. learnmcp is vibe learning — learning that happens beside the work you’re already doing, not instead of it. It lives inside your Claude Code session, watches what you build, suggests the next best practice to try, and rewards you with badges when you do it. No courses, no fixed path — your real work is the curriculum.
Two things make that possible: it’s passive — nothing to open, nothing to schedule, it just notices what you did — and it’s vendor-neutral, because everything it knows about a tool lives in a cartridge, not a platform.
You: Can you generate an OpenAPI spec in Postman for this codebase? learnmcp — 🏅 Spec Author (+10) · ✅ Generate an OpenAPI spec from your codebase · Initiate · 10 pts (90 to Apprentice) · Next: Sync your spec to a Postman collection
Install
Two commands. No account, no API key, nothing to configure.
$ claude plugin marketplace add quintonwall/learnmcp $ claude plugin install learnmcp@quintonwall
Restart Claude Code and you’re done. The plugin talks to the hosted server at learnmcp.ai and creates an anonymous learner the first time it records anything — your badges start saving immediately, with no sign-up.
Using it
Just work
Use a tool learnmcp knows — Postman, Playwright, Supabase, GitHub — and the matching track activates on its own. You’ll see the next suggestion at session start.
Do the thing it suggests
Run the command, call the tool, or just write the file. The badge fires by itself — you never tell learnmcp you did something.
Climb
Bronze 10 points, silver 25, gold 100, accumulating across every tool into one rank: Novice → Initiate → Apprentice → Journeyman → Adept → Expert → Master → Grandmaster → Legend.
Ask in plain language — “what should I learn next?”, “where am I on the leaderboard?” — or use the commands:
/learn the next thing worth doing /badges what you’ve earned /progress your points, rank, and standing /cartridge what it can teach; refresh the registry
LEARNMCP_LOCAL=1 and it opts out of tracking entirely — no leaderboard, no cartridge popularity, nothing sent anywhere.https://learnmcp.ai/mcp directly. You lose passive detection (no hooks means the model has to call record_activity itself) and, unless your client can hold a static auth header, persistent identity too. Full details in the README.Your profile
There is no sign-up. The first time learnmcp records anything it mints an anonymous learner and stores a token at ~/.learnmcp/token — that token is your identity, so back it up if you care about your streak. You show on the leaderboard straight away as something like learner-7f3c.
Add a tool it doesn’t know yet
Cartridges are plain JSON with no executable code, and the registry is a directory in the repo — so teaching learnmcp a new tool is a pull request. Validate yours in the browser first, then open the PR.
16 cartridges available
A cartridge is what teaches one tool — plain JSON, no code. They live in the repo, so adding support for a new service is a pull request. Once it merges, every learnmcp picks it up on its next refresh — nothing is redeployed.