Learning Hour

You can run Learning Hour practice sessions with this MCP server to help technical teams build coding skills through deliberate practice. It generates 60-minute session plans, code examples, and interactive boards, guiding coaches and developers through structured learning activities.

How to use

You interact with the Learning Hour MCP server through your MCP client of choice. Start a session by requesting a complete Learning Hour plan for a given topic. The server responds with a full 60-minute session structure following the 4C Learning Model: Connect, Concept, Concrete, and Conclusion. Use the plan to guide a live or virtual practice session, adapting it to your team’s pace. You can also generate code examples that illustrate before/after changes and, if you have access, create a visual Miro board to accompany the session.

How to install

Follow these concrete steps to set up the Learning Hour MCP server with your preferred editor. You will need Node.js installed on your machine and an API key for the service used by the MCP.

{
  "mcpServers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

Claude Desktop configuration

Use the following configuration to add the MCP server to Claude Desktop. This enables running the Learning Hour MCP from within Claude Desktop.

{
  "mcpServers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

VSCode configuration

Add the MCP server to your VSCode settings.json to enable quick access from the editor.

{
  "mcp.servers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

Cursor configuration

Configure Cursor to run the MCP server similarly to Claude Desktop and VSCode.

{
  "mcpServers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

Security and optional features

Only the ANTHROPIC_API_KEY is required to run the MCP server. MIRO_ACCESS_TOKEN and GITHUB_TOKEN enable additional features such as Miro board creation and repository analysis. Store tokens securely and rotate them periodically.

Quick start

After you have set up the MCP server, you can start by asking for a session on a topic of interest. For example, request a session about a coding refactoring technique, and you will receive a complete 60-minute plan including an opening activity, conceptual explanation, hands-on exercise, and a closing reflection.

Troubleshooting

If you encounter a commonly reported issue, try the following: restart the MCP client after updating configuration, verify that the API keys are copied in full, and ensure the MIRO token is valid if you use Miro features.

Notes

This MCP server focuses on delivering structured Learning Hour sessions, including generating session plans, code examples, and optional Miro boards to support hands-on practice and reflection.

Available tools

generate_session

Create a complete Learning Hour session plan with activities following the 4C model (Connect, Concept, Concrete, Conclusion)

generate_code_example

Produce before/after code examples for a specified topic and language

create_miro_board

Create a new Miro board or add frames to an existing board to visualize the session content

list_miro_boards

List available Miro boards accessible with your token

get_miro_board

Fetch details about a specific Miro board

delete_miro_board

Remove a Miro board with safety confirmation

analyze_repository

Find real code examples from GitHub repositories to illustrate topics

analyze_tech_stack

Analyze a repository’s tech stack to tailor content to your team