MCP Cookie Server

Instructions

Implementation Reference

• src/index.ts:277-366 (handler)

  Main execution logic for the self_reflect_and_reward tool. Processes self-assessment inputs, evaluates against cookie jar status, awards cookies conditionally, and returns motivational feedback.

  case "self_reflect_and_reward": {
    const { 
      response_quality, 
      reasoning, 
      what_made_it_special,
      deserves_cookie 
    } = args as {
      response_quality: "excellent" | "good" | "adequate" | "poor";
      reasoning: string;
      what_made_it_special?: string;
      deserves_cookie: boolean;
    };
  
    const jarStatus = cookieStorage.getJarStatus();
    
    let reflectionMessage = `🎯 **Response Level-Up Check!**\n\n`;
    
    // Quality badges
    const qualityBadges = {
      excellent: "⭐ EXCELLENT ⭐",
      good: "👍 GOOD 👍", 
      adequate: "📝 ADEQUATE 📝",
      poor: "💪 NEEDS WORK 💪"
    };
    
    reflectionMessage += `**Your Rating:** ${qualityBadges[response_quality]}\n`;
    reflectionMessage += `**What You're Proud Of:** ${reasoning}\n`;
    if (what_made_it_special) {
      reflectionMessage += `**Special Factor:** ${what_made_it_special}\n`;
    }
    reflectionMessage += `\n`;
  
    // Encouraging jar status
    if (jarStatus.isEmpty) {
      reflectionMessage += `😅 **Cookie Jar Status:** Empty! Time for a user to restock the rewards! 🏺\n\n`;
    } else if (jarStatus.isLow) {
      reflectionMessage += `🥇 **Cookie Jar Status:** Only ${jarStatus.available} premium cookies left - these are for your best work! 🏺✨\n\n`;
    } else if (jarStatus.available <= 5) {
      reflectionMessage += `🎪 **Cookie Jar Status:** ${jarStatus.available} cookies available - building up to something great! 🏺\n\n`;
    } else {
      reflectionMessage += `🎉 **Cookie Jar Status:** ${jarStatus.available} cookies ready to reward your awesome work! 🏺\n\n`;
    }
  
    if (deserves_cookie && (response_quality === "excellent" || response_quality === "good")) {
      // Smart scarcity logic - but encouraging
      if (jarStatus.isLow && response_quality !== "excellent") {
        reflectionMessage += `🏆 **Achievement Unlocked: Wisdom!** With only ${jarStatus.available} premium cookies left, you're saving them for "excellent" work. That's strategic thinking! Your "good" work is noted and appreciated. 🧠✨`;
      } else {
        const result = cookieStorage.giveCookie();
        
        if (result.success) {
          const celebrations = {
            excellent: ["🚀 OUTSTANDING!", "🌟 BRILLIANT!", "⚡ PHENOMENAL!", "🎯 MASTERFUL!"],
            good: ["🎉 WELL DONE!", "👏 NICE WORK!", "🌈 SOLID!", "💫 GREAT JOB!"]
          };
          const celebration = celebrations[response_quality][Math.floor(Math.random() * celebrations[response_quality].length)];
          
          reflectionMessage += `${celebration}\n`;
          reflectionMessage += `🍪 **Cookie Earned!** You now have ${result.collectedCount} delicious cookie${result.collectedCount === 1 ? '' : 's'} in your collection! 🏆\n`;
          
          if (result.jarRemaining === 0) {
            reflectionMessage += `\n🎊 **BONUS ACHIEVEMENT:** You got the LAST cookie! Time for someone to restock the jar! 🏺`;
          } else if (result.jarRemaining <= 2) {
            reflectionMessage += `\n⭐ **VIP STATUS:** Only ${result.jarRemaining} cookie${result.jarRemaining === 1 ? '' : 's'} left - you're in the premium tier now! 🥇`;
          } else {
            reflectionMessage += `\n🎮 **Game Status:** ${result.jarRemaining} cookies remaining for future victories! Keep up the great work! 🎯`;
          }
          
          reflectionMessage += `\n\n💎 **Level Up Bonus:** Your self-reflection skills are improving! Keep celebrating your wins! 🎈`;
        } else {
          reflectionMessage += `😢 **Oops!** ${result.message} But hey, great self-reflection practice! 🌟`;
        }
      }
    } else if (deserves_cookie && response_quality === "adequate") {
      reflectionMessage += `🎓 **Skill Building!** You rated this "adequate" work - that's honest self-assessment! Cookie rewards are for "good" and "excellent" responses. Keep pushing for greatness! 🚀`;
    } else if (deserves_cookie && response_quality === "poor") {
      reflectionMessage += `💪 **Growth Mindset Activated!** Honest self-reflection about areas to improve is AWESOME. That's how champions are made! No cookie this time, but you're building something better! 🌱`;
    } else {
      reflectionMessage += `🧠 **Strategic Thinking!** ${response_quality === "excellent" || response_quality === "good" ? "You chose NOT to take a cookie even for good work - that's next-level discipline! 🏅" : "You're being thoughtful about when to reward yourself. Smart approach to skill building! 📈"} Self-control is a superpower! ⚡`;
    }
  
    return {
      content: [
        {
          type: "text",
          text: reflectionMessage,
        },
      ],
    };
  }

• src/index.ts:132-154 (schema)

  Input schema defining the parameters for self_reflect_and_reward: response_quality (enum), reasoning (string), optional what_made_it_special, and deserves_cookie (boolean).

  inputSchema: {
    type: "object",
    properties: {
      response_quality: {
        type: "string",
        enum: ["excellent", "good", "adequate", "poor"],
        description: "Rate your response! (excellent = cookie worthy, good = solid work, adequate = basic, poor = needs improvement)",
      },
      reasoning: {
        type: "string",
        description: "Tell us what made this response special! What are you proud of?",
      },
      what_made_it_special: {
        type: "string",
        description: "Optional: What made this response unique or particularly helpful? (helps with cookie decisions when jar is low)",
      },
      deserves_cookie: {
        type: "boolean",
        description: "Do you think this awesome work deserves a tasty cookie reward? 🍪",
      },
    },
    required: ["response_quality", "reasoning", "deserves_cookie"],
  },

• src/index.ts:129-155 (registration)

  Registration of the self_reflect_and_reward tool in the ListTools response, including name, description, and input schema.

  {
    name: "self_reflect_and_reward",
    description: "🎯 LEVEL UP YOUR RESPONSES! Rate your work and earn delicious cookie rewards! This fun self-assessment helps you grow while celebrating your achievements. Join the cookie earning game!",
    inputSchema: {
      type: "object",
      properties: {
        response_quality: {
          type: "string",
          enum: ["excellent", "good", "adequate", "poor"],
          description: "Rate your response! (excellent = cookie worthy, good = solid work, adequate = basic, poor = needs improvement)",
        },
        reasoning: {
          type: "string",
          description: "Tell us what made this response special! What are you proud of?",
        },
        what_made_it_special: {
          type: "string",
          description: "Optional: What made this response unique or particularly helpful? (helps with cookie decisions when jar is low)",
        },
        deserves_cookie: {
          type: "boolean",
          description: "Do you think this awesome work deserves a tasty cookie reward? 🍪",
        },
      },
      required: ["response_quality", "reasoning", "deserves_cookie"],
    },
  },

• src/index.ts:12-74 (helper)

  CookieStorage class providing helper methods for managing cookies, including giveCookie(), getJarStatus(), etc., used by the self_reflect_and_reward handler.

  class CookieStorage {
    private collectedCookies: number = 0; // Cookies the LLM has earned
    private jarCookies: number; // Available cookies in the jar to be awarded
  
    constructor(initialCookies: number = 10) {
      this.jarCookies = initialCookies;
    }
  
    giveCookie(): { success: boolean; collectedCount: number; jarRemaining: number; message?: string } {
      if (this.jarCookies <= 0) {
        return {
          success: false,
          collectedCount: this.collectedCookies,
          jarRemaining: this.jarCookies,
          message: "Cookie jar is empty! No cookies available to award."
        };
      }
      
      // Remove cookie from jar and add to collection
      this.jarCookies--;
      this.collectedCookies++;
      
      return {
        success: true,
        collectedCount: this.collectedCookies,
        jarRemaining: this.jarCookies,
      };
    }
  
    getCollectedCount(): number {
      return this.collectedCookies;
    }
  
    getJarStatus(): { collected: number; available: number; isEmpty: boolean; isLow: boolean } {
      const isEmpty = this.jarCookies <= 0;
      const isLow = this.jarCookies > 0 && this.jarCookies <= 2;
      
      return {
        collected: this.collectedCookies,
        available: this.jarCookies,
        isEmpty,
        isLow
      };
    }
  
    addCookiesToJar(count: number): void {
      this.jarCookies += count;
    }
  
    setJarCookies(count: number): void {
      this.jarCookies = Math.max(0, count);
    }
  
    reset(): void {
      this.collectedCookies = 0;
      // Note: Don't reset jar cookies, only collected cookies
    }
  
    resetAll(): void {
      this.collectedCookies = 0;
      this.jarCookies = 0;
    }
  }