🍋 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.

Local serverstdio

What is the 🍋 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. That is what the 🍋 lemonade stand mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

Model Context Protocol (MCP) is an open standard that enables AI models like Claude to interact with external data sources and tools. This server demonstrates how MCP works by implementing the classic Lemonade Stand game as a set of tools that Claude can use.

  • 🌤️ 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

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

The tools it exposes

The server publishes 6 tools. What each one is for:

  • start_game — Begin a new game session
  • get_game_state — Check current status, money, inventory, and weather
  • buy_supplies — Purchase cups, lemons, sugar, and ice
  • set_price — Set the price per cup of lemonade
  • sell_lemonade — Open for business and see daily results
  • next_day — Advance to the next day

What it needs from you

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. 🍋 Lemonade Stand's toolset — start_game, get_game_state, buy_supplies and 3 more — is a fair guide to whether it matches your workflow. It is maintained by jimmcq; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
start_gameBegin a new game session
get_game_stateCheck current status, money, inventory, and weather
buy_suppliesPurchase cups, lemons, sugar, and ice
set_priceSet the price per cup of lemonade
sell_lemonadeOpen for business and see daily results
next_dayAdvance to the next day

How to install the 🍋 Lemonade Stand MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

Example prompts to try

  • Use 🍋 Lemonade Stand to start game.
  • Use 🍋 Lemonade Stand to get game state.
  • Use 🍋 Lemonade Stand to buy supplies.

Frequently asked questions

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