LearnForge MCP Server v1.1.0

A Model Context Protocol server that lets Claude Desktop (and other MCP-compatible AI assistants) generate and retrieve LearnForge lessons without leaving their interface.

Built by MetalMind Tech — Powered by Ark Intelligence

Quick Start

npx learnforge-mcp init

The interactive wizard will:

1. Ask for your API key, JWT token, and user ID
2. Auto-detect your Claude Desktop config path (macOS/Windows/Linux)
3. Inject the mcpServers.learnforge entry
4. Done in under 2 minutes

Available Tools (6)

| Tool | What it does | |------|--------------| | generate_lesson | Start 5-agent AI lesson generation | | get_lesson_status | Poll progress, get lesson when ready | | list_lessons | Browse lesson library with filters | | get_lesson | Read full lesson — scenes, quiz, code, score | | get_user_progress | Streak, scores, weak areas, AI recommendations | | ask_tutor | Socratic AI tutoring conversation |

Example Claude Conversation

You: Generate a lesson about quantum entanglement at the graduate level

Claude: I'll generate that lesson for you. [calls generate_lesson] Started! Task ID: abc-123... [calls get_lesson_status] Completed! 5 scenes, score: 85/100 [calls get_lesson] Here's the full lesson...

You: I don't understand the Bell inequality. Can you help?

Claude: [calls ask_tutor] Let me think about this with you...

Manual Setup

Add to claude_desktop_config.json:

| OS | Path | |----|------| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json | | Linux | ~/.config/Claude/claude_desktop_config.json |

{
  "mcpServers": {
    "learnforge": {
      "command": "node",
      "args": ["/path/to/mcp/server.js"],
      "env": {
        "LEARNFORGE_API_URL": "https://learnforge-core-production.up.railway.app",
        "LEARNFORGE_API_KEY": "lf_sk_your_key",
        "LEARNFORGE_JWT": "your_jwt_token",
        "LEARNFORGE_USER_ID": "your_supabase_uuid"
      }
    }
  }
}

Where to Get Credentials

| Credential | Where | |---|---| | API Key | learnforge-core.vercel.app/en/settings > API Keys > Create Key | | JWT Token | Browser DevTools > Application > Local Storage > supabase auth token > access_token | | User ID | LearnForge app > Profile > UUID |

Difficulty Levels

kindergarten · elementary · middle · high_school · college · graduate · phd · vocational

Architecture

mcp/
├── server.js           ← MCP stdio server (6 tools)
├── cli.js              ← npx learnforge-mcp init
├── package.json
├── .gitignore
├── .learnforge-config.json  (generated by wizard)
└── README.md

Commands

npx learnforge-mcp init     # Setup wizard
npx learnforge-mcp start    # Start server directly
npx learnforge-mcp help     # Show help

Error Handling

• 401 — Invalid API key or JWT token
• 429 — Rate limit exceeded (upgrade plan)
• 403 — Free tier sandbox limit (3 lifetime API calls)
• 5xx — Logged with full error context