MCP.so
Sign In

🍋 Lemonade Stand MCP Server

@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

Category

Other

License

MIT

Runtime

node

Transports

stdio

Publisher

jimmcq

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

6

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/).

What tools does the server expose to Claude?

start_game, get_game_state, buy_supplies, set_price, sell_lemonade, and next_day.

Can I play the game on WSL?

Yes. Use a WSL‑specific configuration with the full path to the Node.js binary inside the WSL environment.

Comments

More Other MCP servers