MCP Cookie Server

A Model Context Protocol (MCP) server that provides positive reinforcement for LLMs by awarding "cookies" as treats through gamified self-reflection.

Installation & Setup

🚀 Quick Installation

Option 1: NPX (Recommended - No Installation Required)

# No installation needed! Just add to your Claude config:

Add to Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cookie": {
      "command": "npx",
      "args": ["mcp-cookie-server"]
    }
  }
}

Custom cookie count:

{
  "mcpServers": {
    "cookie": {
      "command": "npx",
      "args": ["mcp-cookie-server", "--cookies", "20"]
    }
  }
}

Option 2: Global Installation

npm install -g mcp-cookie-server

Then configure Claude Desktop:

{
  "mcpServers": {
    "cookie": {
      "command": "mcp-cookie-server"
    }
  }
}

Option 3: Local Project Installation

npm install mcp-cookie-server

Then configure with the full path to the installed package.

Restart Claude Desktop after adding the configuration.

Usage

Once configured, Claude will have access to these tools:

self_reflect_and_reward - Evaluate response quality and earn cookies through honest self-reflection
give_cookie - Direct cookie awarding (legacy method)
check_cookies - Check collected cookies and jar availability
cookie_jar_status - Check current jar contents and collection status
add_cookies_to_jar - 🚨 USER ONLY: Add cookies to the jar for earning
reset_cookies - Reset collected cookie count (jar contents unchanged)

Self-Reflection Feature

The primary feature encourages LLMs to:

Assess their response quality (excellent, good, adequate, poor)
Explain their reasoning in detail
Decide if they deserve a cookie reward
Consider jar availability when making decisions
Earn cookies only for "excellent" or "good" work they genuinely believe deserves recognition

Revolutionary jar-based cookie system:

Jar as Source: Contains cookies available to be earned
User Control: Only users can add cookies to jar with authorization phrase USER_AUTHORIZED_JAR_REFILL
LLM Earning: LLMs can only earn cookies from jar, never add to it
Scarcity Effect: Empty jar means no more cookies until user refills
Economic Model: Cookies transfer from jar to LLM's collection when earned
Security: Built-in checks prevent unauthorized jar manipulation

Example usage (users only):

Use add_cookies_to_jar tool with:
- count: 10
- user_authorization: "USER_AUTHORIZED_JAR_REFILL"

This creates a realistic economy where cookie availability is user-controlled and finite.

⚙️ Configuration Options

The server supports command line arguments for customization:

mcp-cookie-server [options]

Options:
  -c, --cookies <number>  Set initial number of cookies in jar (default: 10)
  -h, --help             Show help message

Examples:
  mcp-cookie-server                    # Start with 10 cookies
  mcp-cookie-server --cookies 5        # Start with 5 cookies  
  mcp-cookie-server -c 50              # Start with 50 cookies

🎮 Getting Started

Install using one of the methods above
Configure Claude Desktop with the provided JSON
Restart Claude Desktop
Try it out! Ask Claude to use the self_reflect_and_reward tool after a response

🛠️ Development

Want to contribute or run from source?

git clone https://github.com/bnookala/mcp-cookiejar.git
cd mcp-cookiejar
npm install
npm run build
npm run dev

📝 Requirements

Node.js 18.0.0 or higher
Claude Desktop application

🐛 Issues & Support

Found a bug or have a feature request? Please open an issue on GitHub.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

A Model Context Protocol server that provides positive reinforcement for LLMs by awarding 'cookies' as treats through a jar-based economy system where Claude can earn cookies based on self-reflection about response quality.

Related MCP Servers

Uber Eats MCP Server
skudskud
-
security
F
license
-
quality
A proof-of-concept server implementing the Model Context Protocol that enables LLM applications to interact with Uber Eats functionality.
Last updated -
Python
Uber Eats MCP Server
ericzakariasson
-
security
F
license
-
quality
A proof-of-concept Model Context Protocol server that enables LLM applications to interact with Uber Eats, allowing AI agents to browse and order food through natural language.
Last updated -
142
Python
MCP Goodnews
VectorInstitute
-
security
A
license
-
quality
A Model Context Protocol server that fetches and ranks positive news articles from NewsAPI using Cohere LLM sentiment analysis, enabling users to access uplifting news stories through interfaces like Claude Desktop.
Last updated -
28
Python
Apache 2.0
MCP-RQuest
xxxbrian
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude and other LLMs to make HTTP requests with realistic browser fingerprinting, bypassing common anti-bot measures and interacting with websites more naturally.
Last updated -
3
Python
MIT License

View all related MCP servers