Academy

MCP server for StudioMeyer Academy — connect Claude Code, Cursor, or Claude Desktop to your learning progress and the AI-Operator Recipe Stack.

• See where you are in the 6-level Memory-First AI Operator curriculum (free)
• Walk 74 step-by-step Recipes covering CLAUDE.md, Skills, MCP-server building, OAuth, Multi-Tenant SaaS — with per-step Validators that check whether what you just did actually worked
• Browse the Knowledge Graph (32 Concepts + 27 Relations covering CLAUDE.md, agents.md, OAuth-PKCE, MCPize, Multi-Tenant, Operator Skills, ...)
• Get the next lesson or recipe recommended based on your real progress
• Take inline quizzes, submit checkpoints, earn certificates
• Run daily spaced-repetition review directly in your chat
• Talk to the Academy AI-Tutor about the current lesson (Pro only)

Academy lives at https://studiomeyer.academy (and https://academy.studiomeyer.io).

v0.2.0 update (2026-04-25): Added 10 Recipe + Knowledge-Graph tools. Recipes Phase 1-5 free, Phase 6-10 require Pro subscription, Phase 11-15 coming-soon. Lessons stay free forever.

Install

npm install -g mcp-academy

Or run without installing:

npx -y mcp-academy

Setup

1. Log in at https://academy.studiomeyer.io/dashboard/keys
2. Create a new API key (e.g. "Claude Code Desktop")
3. Copy the token — it starts with academy_...
4. Wire it into your MCP-capable client.

Claude Code

claude mcp add academy \
  -s user \
  --env ACADEMY_API_KEY=academy_your_token_here \
  -- npx -y mcp-academy

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your OS:

{
  "mcpServers": {
    "academy": {
      "command": "npx",
      "args": ["-y", "mcp-academy"],
      "env": {
        "ACADEMY_API_KEY": "academy_your_token_here"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "academy": {
      "command": "npx",
      "args": ["-y", "mcp-academy"],
      "env": { "ACADEMY_API_KEY": "academy_your_token_here" }
    }
  }
}

Tools

23 tools total — 13 Lessons + 10 Recipes / Knowledge-Graph.

Lessons (13)

Tool	Description
academy_stats	Your XP, rank, streak, badges, certificates, weekly league standing.
academy_levels	All 6 levels with access info (free / paid / earned).
academy_lessons	List lessons in a level with completed status.
academy_lesson	Get full content of a specific lesson.
academy_next_lesson	Recommend the next incomplete lesson based on progress.
academy_progress_complete	Mark a lesson as completed — grants XP, updates streak, schedules review.
academy_quiz	Fetch a lesson quiz or level-checkpoint quiz.
academy_quiz_submit	Submit answers. Returns score + per-question feedback. Checkpoint pass → certificate.
academy_review	Items due for spaced-repetition today.
academy_review_grade	Grade a review item (again / good / easy) — SM-2 schedules next review.
academy_certificates	Your earned certificates with public verification URLs.
academy_tutor	Ask the AI-Tutor. Context-aware if you pass level + lessonSlug. Pro only.
academy_tutor_quota	Check tutor usage / daily limits.

Recipes + Knowledge-Graph (10, new in v0.2.0)

Tool	Description
academy_list_recipes	List recipes filtered by phase / tier / locked-flag. Returns 74 recipes with status (completed / in_progress / not_started / locked / coming_soon).
academy_get_recipe	Get a recipe with full step bodies + per-step clientCheck (Bash command + expected output). Locked recipes return a teaser + upgradeUrl.
academy_start_recipe	Begin a recipe. Idempotent — completed recipes return already_completed unless restart: true.
academy_next_step	Get the active recipe's current step including the clientCheck snippet.
academy_validate_step	First call returns client_check_required + the Bash snippet. The LLM runs the snippet locally. Second call with manual: true advances the step. Last step → recipeCompleted: true.
academy_my_recipes	Per-phase progress stats + active recipe + recommended next.
academy_save_recipe_note	Save a per-step note for a recipe.
academy_concept_search	Trigram + ILIKE fuzzy search across the 32-concept knowledge graph.
academy_concept_open	Get a concept with body + outgoing/incoming relations + recent observations. Pro-tier bodies gated to active subscribers.
academy_concept_graph	N-hop BFS traversal from a root concept (depth 1-3).

Env Variables

Var	Required	Default
ACADEMY_API_KEY	yes	—
ACADEMY_BASE_URL	no	https://academy.studiomeyer.io

Setting ACADEMY_BASE_URL is useful if you want to run the MCP server against a local Academy instance (http://localhost:3220).

Privacy

The server never stores anything locally. Every call is a straight HTTPS request to your Academy account, authenticated by the Bearer token you configured. Revoke any key at https://academy.studiomeyer.io/dashboard/keys.

License

MIT © StudioMeyer.