🍋 Lemonade Stand MCP Server

Name: 🍋 Lemonade Stand MCP Server
Author: jimmcq

@jimmcq

About 🍋 Lemonade Stand MCP Server

A simple, working example of a Model Context Protocol (MCP) server that lets you play the classic Lemonade Stand game through Claude Desktop.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "lemonade-stand": {
      "command": "node",
      "args": [
        "/absolute/path/to/Lemonade-Stand-MCP-Server/server.js"
      ]
    }
  }
}

Tools

Begin a new game session

Check current status, money, inventory, and weather

Purchase cups, lemons, sugar, and ice

Set the price per cup of lemonade

Open for business and see daily results

Advance to the next day

Overview

What is 🍋 Lemonade Stand MCP Server?

A simple, working example of a Model Context Protocol (MCP) server that lets you play the classic Lemonade Stand game through Claude Desktop. It demonstrates how MCP enables AI models to interact with external tools and maintain game state.

How to use 🍋 Lemonade Stand MCP Server?

Clone the repository, install dependencies with npm install, and configure Claude Desktop by adding a JSON entry in claude_desktop_config.json pointing to server.js. After restarting Claude, start a new chat and ask it to "Play a complete game of Lemonade Stand using the MCP tools available."

Key features of 🍋 Lemonade Stand MCP Server

Dynamic weather system affecting sales
Business simulation with supply and demand
Strategic pricing and inventory management
14‑day game cycle with profit tracking
Fully playable through Claude Desktop

Use cases of 🍋 Lemonade Stand MCP Server

Learn how MCP works through a hands‑on example
Play the classic Lemonade Stand game via Claude Desktop
Demonstrate AI‑driven strategic decision‑making
Experiment with stateful MCP tool interactions

FAQ from 🍋 Lemonade Stand MCP Server

What are the prerequisites?

Node.js v20.11.1 or higher, Claude Desktop, and npm (comes with Node.js).

How do I know the server is connected?

A hammer icon appears in Claude Desktop when the MCP server is connected.

How do I troubleshoot a missing hammer icon?

Ensure Claude Desktop is up to date, verify the configuration file path is correct, check that Node.js is accessible, and review Claude Desktop logs (Windows: %APPDATA%\Claude\logs\, macOS: ~/Library/Logs/Claude/).