Advertise
MCP.so
Sign In

Lemonade Stand MCP Server

@jimmcq

Repository

Basic information

Category

Other

Last updated

License

MIT

Transports

stdio

Author

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.

Lemonade Stand MCP Server 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"
      ]
    }
  }
}

Lemonade Stand MCP Server 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

Frequently asked questions

1

What are the prerequisites?

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

2

How do I know the server is connected?

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

3

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

4

What tools does the server expose to Claude?

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

5

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

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Arsen MCP

Arsen Security

Run advanced phishing, voice phishing, deepfake fraud simulations, and cybersecurity awareness training from your AI assistant.

Advertise