{"_id":"mcp-cookie-server","_rev":"3-e92426b10e4e82744750797979ff07b3","name":"mcp-cookie-server","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"mcp-cookie-server","version":"1.0.0","keywords":["mcp","model-context-protocol","claude","llm","cookies","gamification","self-reflection","rewards","ai-tools"],"author":{"name":"MCP Cookie Contributors"},"license":"MIT","_id":"mcp-cookie-server@1.0.0","maintainers":[{"name":"bnookala","email":"nooknb@gmail.com"}],"homepage":"https://github.com/bnookala/mcp-cookiejar#readme","bugs":{"url":"https://github.com/bnookala/mcp-cookiejar/issues"},"bin":{"mcp-cookie-server":"dist/index.js"},"dist":{"shasum":"84d1dc5df78aaf3b731db936ae0b414c38648a8c","tarball":"https://registry.npmjs.org/mcp-cookie-server/-/mcp-cookie-server-1.0.0.tgz","fileCount":7,"integrity":"sha512-oeYIFmoT5MrxJ5a44EsvlkUvD3lTJjruMMDQhWZGHMK3zEtDCqxGJRrkYNIjHEamcCa3F+r1T6f2ahCkFa2yhg==","signatures":[{"sig":"MEUCIECka7AWwHb8ppsGmRuOK8CVBO+pwkpn837NrblfuRzkAiEA32ZYYOsGc2WRGP9UQ3YgmG/Af4fkTtQG9u3fuQ9EhDE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41641},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"6567a4bbdeec44ff0f1de2209f2ecf1a7948c4f8","scripts":{"dev":"tsc && node dist/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"bnookala","actor":{"name":"bnookala","type":"user","email":"nooknb@gmail.com"},"email":"nooknb@gmail.com"},"repository":{"url":"git+https://github.com/bnookala/mcp-cookiejar.git","type":"git"},"_npmVersion":"10.8.1","description":"🍪 A gamified MCP server that rewards LLMs with cookies for quality responses through honest self-reflection","directories":{},"_nodeVersion":"22.4.1","dependencies":{"@modelcontextprotocol/sdk":"^1.13.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp-cookie-server_1.0.0_1750621171376_0.8057076111987036","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"mcp-cookie-server","version":"1.0.1","keywords":["mcp","model-context-protocol","claude","llm","cookies","gamification","self-reflection","rewards","ai-tools"],"author":{"name":"MCP Cookie Contributors"},"license":"MIT","_id":"mcp-cookie-server@1.0.1","maintainers":[{"name":"bnookala","email":"nooknb@gmail.com"}],"homepage":"https://github.com/bnookala/mcp-cookiejar#readme","bugs":{"url":"https://github.com/bnookala/mcp-cookiejar/issues"},"bin":{"mcp-cookie-server":"dist/index.js"},"dist":{"shasum":"a2ec1c591db145d7fa0ac48d732049f80ce7f87b","tarball":"https://registry.npmjs.org/mcp-cookie-server/-/mcp-cookie-server-1.0.1.tgz","fileCount":7,"integrity":"sha512-rjbXKnICy8ip9o/Gdi0f2ZokJOshWMstRhCgLErGJATbhYnrqs6DoUbtIPEbMLkQNzl+ePuYKMuK3hIFMzhDog==","signatures":[{"sig":"MEQCIEINlYeAJxH6h50ZoxAy72HKxG6DxVrbxR6bDY0YGPkwAiACpn5tmKNQ2ZYR1at+XDjMczcJYRmfe1XhJhyPOsRVYQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41677},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"01f28b184584e40eb31e9b6b33f94278d99ae54d","scripts":{"dev":"npm run build && node dist/index.js","test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"bnookala","actor":{"name":"bnookala","type":"user","email":"nooknb@gmail.com"},"email":"nooknb@gmail.com"},"repository":{"url":"git+https://github.com/bnookala/mcp-cookiejar.git","type":"git"},"_npmVersion":"10.8.1","description":"🍪 A gamified MCP server that rewards LLMs with cookies for quality responses through honest self-reflection","directories":{},"_nodeVersion":"22.4.1","dependencies":{"@modelcontextprotocol/sdk":"^1.13.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp-cookie-server_1.0.1_1750621636461_0.7467837112211522","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"mcp-cookie-server","version":"1.0.2","description":"🍪 A gamified MCP server that rewards LLMs with cookies for quality responses through honest self-reflection","main":"dist/index.js","type":"module","bin":{"mcp-cookie-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","dev":"npm run build && node dist/index.js","prepublishOnly":"npm run build","test":"echo \"Error: no test specified\" && exit 1"},"keywords":["mcp","model-context-protocol","claude","llm","cookies","gamification","self-reflection","rewards","ai-tools"],"author":{"name":"MCP Cookie Contributors"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/bnookala/mcp-cookiejar.git"},"homepage":"https://github.com/bnookala/mcp-cookiejar#readme","bugs":{"url":"https://github.com/bnookala/mcp-cookiejar/issues"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.13.0"},"devDependencies":{"@types/node":"^24.0.3","typescript":"^5.8.3"},"_id":"mcp-cookie-server@1.0.2","gitHead":"01f28b184584e40eb31e9b6b33f94278d99ae54d","types":"./dist/index.d.ts","_nodeVersion":"22.4.1","_npmVersion":"10.8.1","dist":{"integrity":"sha512-WquN7/5/1E4q14AaF+awmzoOxD8NA0q8vmRIVJZAMPvaGpbbNENCDZoxdYnJF2G2Lu2JWJm3OucD/LZIvts59w==","shasum":"0b7f5397f1561f7adc956201aaa2e6b682dc6f4c","tarball":"https://registry.npmjs.org/mcp-cookie-server/-/mcp-cookie-server-1.0.2.tgz","fileCount":8,"unpackedSize":42789,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCc0bw5XVd+St6RFQjr8jZTjoigZMS/yOdWtO2e/A6vuwIgU1RXbq9LzPOEwKrVZhcjP8uCa4fgARfevS7BcU/wX0o="}]},"_npmUser":{"name":"bnookala","email":"nooknb@gmail.com","actor":{"name":"bnookala","email":"nooknb@gmail.com","type":"user"}},"directories":{},"maintainers":[{"name":"bnookala","email":"nooknb@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-cookie-server_1.0.2_1750621956940_0.7450176268973825"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-22T19:39:31.375Z","modified":"2025-06-22T19:52:37.328Z","1.0.0":"2025-06-22T19:39:31.592Z","1.0.1":"2025-06-22T19:47:16.647Z","1.0.2":"2025-06-22T19:52:37.130Z"},"bugs":{"url":"https://github.com/bnookala/mcp-cookiejar/issues"},"author":{"name":"MCP Cookie Contributors"},"license":"MIT","homepage":"https://github.com/bnookala/mcp-cookiejar#readme","keywords":["mcp","model-context-protocol","claude","llm","cookies","gamification","self-reflection","rewards","ai-tools"],"repository":{"type":"git","url":"git+https://github.com/bnookala/mcp-cookiejar.git"},"description":"🍪 A gamified MCP server that rewards LLMs with cookies for quality responses through honest self-reflection","maintainers":[{"name":"bnookala","email":"nooknb@gmail.com"}],"readme":"# MCP Cookie Server 🍪\n\nA Model Context Protocol (MCP) server that provides positive reinforcement for LLMs by awarding \"cookies\" as treats through gamified self-reflection.\n\n## 🚀 Quick Installation\n\n### Option 1: NPX (Recommended - No Installation Required)\n```bash\n# No installation needed! Just add to your Claude config:\n```\n\nAdd to Claude Desktop configuration:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows:** `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"cookie\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-cookie-server\"]\n    }\n  }\n}\n```\n\n**Custom cookie count:**\n```json\n{\n  \"mcpServers\": {\n    \"cookie\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-cookie-server\", \"--cookies\", \"20\"]\n    }\n  }\n}\n```\n\n### Option 2: Global Installation\n```bash\nnpm install -g mcp-cookie-server\n```\n\nThen configure Claude Desktop:\n```json\n{\n  \"mcpServers\": {\n    \"cookie\": {\n      \"command\": \"mcp-cookie-server\"\n    }\n  }\n}\n```\n\n### Option 3: Local Project Installation\n```bash\nnpm install mcp-cookie-server\n```\n\nThen configure with the full path to the installed package.\n\n**Restart Claude Desktop** after adding the configuration.\n\n## Usage\n\nOnce configured, Claude will have access to these tools:\n- `self_reflect_and_reward` - Evaluate response quality and earn cookies through honest self-reflection\n- `give_cookie` - Direct cookie awarding (legacy method)\n- `check_cookies` - Check collected cookies and jar availability\n- `cookie_jar_status` - Check current jar contents and collection status\n- `add_cookies_to_jar` - 🚨 USER ONLY: Add cookies to the jar for earning\n- `reset_cookies` - Reset collected cookie count (jar contents unchanged)\n\n## Self-Reflection Feature\n\nThe primary feature encourages LLMs to:\n1. **Assess** their response quality (excellent, good, adequate, poor)\n2. **Explain** their reasoning in detail\n3. **Decide** if they deserve a cookie reward\n4. **Consider** jar availability when making decisions\n5. **Earn** cookies only for \"excellent\" or \"good\" work they genuinely believe deserves recognition\n\n## Cookie Jar Economy\n\nRevolutionary jar-based cookie system:\n- **Jar as Source**: Contains cookies available to be earned\n- **User Control**: Only users can add cookies to jar with authorization phrase `USER_AUTHORIZED_JAR_REFILL`\n- **LLM Earning**: LLMs can only earn cookies from jar, never add to it\n- **Scarcity Effect**: Empty jar means no more cookies until user refills\n- **Economic Model**: Cookies transfer from jar to LLM's collection when earned\n- **Security**: Built-in checks prevent unauthorized jar manipulation\n\nExample usage (users only):\n```\nUse add_cookies_to_jar tool with:\n- count: 10\n- user_authorization: \"USER_AUTHORIZED_JAR_REFILL\"\n```\n\nThis creates a realistic economy where cookie availability is user-controlled and finite.\n\n## ⚙️ Configuration Options\n\nThe server supports command line arguments for customization:\n\n```bash\nmcp-cookie-server [options]\n\nOptions:\n  -c, --cookies <number>  Set initial number of cookies in jar (default: 10)\n  -h, --help             Show help message\n\nExamples:\n  mcp-cookie-server                    # Start with 10 cookies\n  mcp-cookie-server --cookies 5        # Start with 5 cookies  \n  mcp-cookie-server -c 50              # Start with 50 cookies\n```\n\n## 🎮 Getting Started\n\n1. **Install** using one of the methods above\n2. **Configure** Claude Desktop with the provided JSON\n3. **Restart** Claude Desktop  \n4. **Try it out!** Ask Claude to use the `self_reflect_and_reward` tool after a response\n\n## 🛠️ Development\n\nWant to contribute or run from source?\n\n```bash\ngit clone https://github.com/bnookala/mcp-cookiejar.git\ncd mcp-cookiejar\nnpm install\nnpm run build\nnpm run dev\n```\n\n## 📝 Requirements\n\n- Node.js 18.0.0 or higher\n- Claude Desktop application\n\n## 🐛 Issues & Support\n\nFound a bug or have a feature request? Please open an issue on [GitHub](https://github.com/bnookala/mcp-cookiejar/issues).","readmeFilename":"README.md"}