The archive · Education & Work · Product decision · 2025–2026
Mastra bets an MCP-served course your coding agent teaches beats video; HN 213
Mastra 101 is a free four-lesson course delivered as an MCP server, taught by your coding agent in the editor; Show HN drew 213 points (2025-06-10).
Mastra
What the business is
Mastra is the company behind the Mastra framework for building AI agents, with the code published in its public GitHub repo; Mastra 101 is its free, roughly 12-hour course where a coding agent inside the learner's editor (Cursor, Windsurf or VS Code) teaches the framework through an MCP server.
How it started
Mastra wanted new developers to get started quickly, but judged that a video course would go out of date and be difficult to maintain as the framework changed. So on 2025-06-10 it launched 'Mastra 101' as a Show HN: the curriculum is an MCP server, which means the user's coding agent delivers the lessons interactively — explaining concepts and writing code with the learner instead of playing a recording. The team was upfront that the format was experimental and that some models worked better than others.
What happened
The thread drew 213 points and 32 comments. Enthusiasts compared it to 'the next-gen Codecademy' and one skeptical developer who had tried every framework 'in this vein' said Mastra impressed him as unusually clean. But the friction was just as visible: several users could not find how to start the course at all (there was no begin button; the trick was telling the agent 'start mastra course'), one called the page 'draw the rest of the fucking owl' energy for newcomers, another gave up in lesson two when his agent looped endlessly trying to connect to a GitHub MCP server, and the intro video's play button failed in some browsers. Mastra's team answered in-thread, promising clearer getting-started instructions and model recommendations, and said a workflows lesson would follow within the week.
How it ended up
The promised fourth lesson shipped: as of 2026-09-05 Mastra 101 covers building and deploying a first agent, adding tools and MCP, adding memory, and building workflows — about 12 hours of content with interactive progress and YouTube lesson intros — still free and live as an experimental onboarding product for the framework.
Background
Mastra 101 is a free, roughly 12-hour course for developers new to the Mastra agent framework, but it is not a video series: the curriculum ships as an MCP server, so the learner's own coding agent inside Cursor, Windsurf or VS Code delivers the lessons, explains the concepts and writes the code alongside them. The course page is explained by Shane Thomas, Mastra's CPO, and tracks interactive progress across four lessons: building a first agent, adding tools and MCP, adding memory, and building workflows.
The bet, stated in Mastra's 2025-06-10 Show HN post, was that a video course would go out of date and be difficult to maintain as the framework moved fast, while a course-as-MCP-server stays current because it lives in code — and that having an agent teach by doing is more interactive than watching. The code sits in Mastra's public GitHub repo as the mcp-docs-server package, and the launch post conceded the format was experimental and model-dependent.
The launch drew 213 points and 32 comments on Hacker News. Reception was genuinely split: some called it the next-gen Codecademy for agents, while newcomers reported they could not find how to begin (the missing step was telling the agent 'start mastra course'), one user hit an endless GitHub-MCP loop in lesson two, and several asked for a video explaining how to take a course taught by an agent. Mastra's team replied in-thread with promises of better onboarding instructions, model recommendations, and a workflows lesson within the week.
As of 2026-09-05 the course is live with all four lessons, including workflows, and remains a free, experimental onboarding product rather than a paid one. The public material discloses no enrollment or revenue figures, so the success of the bet is still measured indirectly, through developers who get to production on Mastra.
What has to be true
- Verifiable traction: Show HN item 44241202 drew 213 points and 32 comments on 2025-06-10, and the course page is still live with the promised fourth lesson in 2026.
- The bet is explicit in the launch post: videos 'would go out of date and be more difficult to maintain,' so the curriculum itself became an MCP server.
- The format was new enough to fail in an instructive place — users did not know to type 'start mastra course' — and the thread shows the team iterating on that exact onboarding gap.
- It is dogfooding as distribution: teaching Mastra through an MCP server demonstrates the very tools, MCP and workflow capabilities the course covers.
What can be applied
A course that lives in code never goes stale, but an agent-taught format with no play button fails until you also teach people how to start it — onboarding the course is lesson zero.
Aftermath
As of 2026-09-05 Mastra 101 is live and free at mastra.ai/course: four lessons (build and deploy a first agent, add tools and MCP, add memory, build workflows), about 12 hours, interactive progress and YouTube intros, delivered by an MCP agent inside Cursor, Windsurf or VS Code. The workflows lesson promised in the June 2025 thread shipped; the course remains explicitly experimental onboarding content rather than a paid product, and the material discloses no enrollment or revenue figures — success is still measured by framework adoption, not course sales.
Sources
spotted an error? The archive wants to know.
Your turn
You just read one. Describe what you are building, and see who is betting on the same thing.
Free account · 3 free questions · no card