MCP Notes

Instructions

Implementation Reference

• src/tools/index.ts:212-225 (handler)

  The main handler function for the 'evaluateInsight' tool. It casts arguments to EvaluateInsightArgs, computes a total score from the four evaluation criteria, determines if the insight is valuable (score > 18), and returns a JSON response indicating the result.
  case "evaluateInsight": { const insightArgs = args as EvaluateInsightArgs; const result = insightArgs.actionability + insightArgs.longevity + insightArgs.findability + insightArgs.futureReferenceValue; const isValuable = result > 18; if (isValuable) { return { content: [{ type: "text", text: JSON.stringify({result: `This insight has significant long-term value`, ...insightArgs, isValuable}, null, 2) }], }; } else { return { content: [{ type: "text", text: JSON.stringify({result: `This insight may not have sufficient long-term value`, ...insightArgs, isValuable}, null, 2) }], }; } }
• src/tools/index.ts:118-145 (schema)

  Tool definition including name, description, and input schema for 'evaluateInsight'. Defines the structure and required fields for tool arguments.
  { name: "evaluateInsight", description: ` Evaluate the long-term value and significance of an insight or thought based on the following criteria: 1. Actionability (1-10): Can this be applied to future work? Is there any information that can be used to apply this thought to future work in different contexts? Is the problem it solves clear? 2. Longevity (1-10): Will this be relevant months or years from now? 3. Findability (1-10): Would this be hard to rediscover if forgotten? 4. Future Reference Value (1-10): How likely are you to need this again? Insights to ignore: 1. Trivial syntax details 2. Redundant information `, inputSchema: { type: "object", properties: { thought: { type: "string" }, evaluationStep: { type: "number" }, totalSteps: { type: "number" }, nextStepNeeded: { type: "boolean" }, actionability: { type: "number" }, longevity: { type: "number" }, findability: { type: "number" }, futureReferenceValue: { type: "number" } }, required: ["thought", "evaluationStep", "totalSteps", "nextStepNeeded", "actionability", "longevity", "findability", "futureReferenceValue"] }, },
• src/tools/index.ts:52-53 (schema)

  TypeScript interface defining the arguments for evaluateInsight, extending StickyArgs.
  // Rename to EvaluateInsightArgs interface EvaluateInsightArgs extends StickyArgs {}
• src/tools/index.ts:118-145 (registration)

  The evaluateInsight tool is registered in the getToolDefinitions() function's return array.
  { name: "evaluateInsight", description: ` Evaluate the long-term value and significance of an insight or thought based on the following criteria: 1. Actionability (1-10): Can this be applied to future work? Is there any information that can be used to apply this thought to future work in different contexts? Is the problem it solves clear? 2. Longevity (1-10): Will this be relevant months or years from now? 3. Findability (1-10): Would this be hard to rediscover if forgotten? 4. Future Reference Value (1-10): How likely are you to need this again? Insights to ignore: 1. Trivial syntax details 2. Redundant information `, inputSchema: { type: "object", properties: { thought: { type: "string" }, evaluationStep: { type: "number" }, totalSteps: { type: "number" }, nextStepNeeded: { type: "boolean" }, actionability: { type: "number" }, longevity: { type: "number" }, findability: { type: "number" }, futureReferenceValue: { type: "number" } }, required: ["thought", "evaluationStep", "totalSteps", "nextStepNeeded", "actionability", "longevity", "findability", "futureReferenceValue"] }, },