MCP.so
Sign In

🍋 Lemonade Stand MCP Server

@jimmcq

Repository

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.

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.

Frequently asked questions

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

Basic information

Category

Other

License

MIT

Transports

stdio

Author

jimmcq

More Other MCP servers

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K