claude-quest-mcp
v0.2.0
Published
An AI apprenticeship — learn Claude by using Claude. Hands-on quests graded through Socratic dialogue. Teach-back challenges. Prompt battles. A rival named Alex. Spaced repetition. Real artifacts you keep.
Maintainers
Readme
⚔️ Claude Quest — MCP App
An AI apprenticeship that teaches Claude by using Claude.
Not a quiz app. Not a course with game mechanics bolted on. Claude Quest is an MCP server that creates a personalized learning journey adapted to what you want to build.
What Makes It Different
- Socratic Grading — Submit work and defend your choices through follow-up questions. The quest isn't done when you get it right. It's done when you can explain why.
- Journey System — Tell Claude Quest what you want to build. It generates a custom quest chain that teaches exactly the skills you need, using your project as context.
- Teach-Back Challenges — Explain concepts to Claude-playing-dumb. If your explanation doesn't hold up, you haven't learned it.
- Prompt Dojo — A/B test two prompt approaches. Claude analyzes which is better and why.
- Breakpoint Quests 💥 — Intentionally broken prompts. Find the flaw before it finds you.
- Rival System — Compare your solutions against "Alex," a simulated rival. Sometimes you win. Sometimes Alex does. The comparison drives insight.
- Spaced Repetition — Reviews scheduled 3 days after completion. Quick challenges that cement long-term retention.
- Toolbox — Every quest produces a reusable artifact: prompt templates, CLAUDE.md files, tool schemas, agent designs. Saved to
~/.claude-quest/toolbox/.
Install
npx claude-quest-mcpOr add to your Claude Code config:
{
"mcpServers": {
"claude-quest": {
"command": "npx",
"args": ["-y", "claude-quest-mcp"]
}
}
}Tools
| Tool | Description |
|------|-------------|
| quest_status | Show progress, available quests, pending reviews |
| begin_journey | Describe your goal → get a custom quest chain |
| start_quest | Begin a quest with full briefing |
| submit_quest | Submit work for Socratic evaluation |
| record_result | Record grading result (called by Claude) |
| quest_hint | Get progressive hints (up to 3) |
| teach_back | Explain a concept to Claude-as-beginner |
| prompt_dojo | A/B test two prompts |
| rival_compare | See Alex's solution, compare approaches |
| review_challenge | Spaced repetition micro-test |
| export_toolbox | Export all saved artifacts |
| export_portfolio | Full achievement + work history |
Quest Types
- 📖 Learn — Foundational concepts with hands-on tasks
- 🧪 Lab — Build something real and iterate on it
- ⚔️ Challenge — Strict grading, one shot
- 💥 Breakpoint — Find the flaw in an intentionally broken prompt
- 🏆 Boss — Design a complete system from scratch
Skill Tree
💬 Claude Basics
├── ✍️ Prompt Engineering
│ ├── Structure & Tags
│ ├── Chain of Thought
│ ├── Few-Shot Master ⚔️
│ └── The Broken Prompt 💥
├── 📁 Projects & Memory
├── 🧬 Context Engineering
│ ├── The 50% Rule
│ └── Context Under Pressure 💥
├── 💻 Claude Code
│ ├── Terminal Power
│ └── Test-Refactor Loop ⚔️
├── 🔌 Tool Use & MCP
│ ├── Tool Schema Design
│ └── Build an MCP Server
└── 🤖 Agent Design
├── Agent Patterns
└── Design Your Agent 🏆Content Attribution
Knowledge foundation: Learn Claude by Sara Kukovec. Her curated resource links are embedded in every quest as "Go Deeper" references.
Built by Bob • getmcpapps.com
License
MIT
