Planning System MCP Server

Instructions

Implementation Reference

• src/tools.js:621-632 (handler)

  Handler logic for the 'add_log' MCP tool. Destructures input arguments, prepares logData, calls apiClient.logs.addLogEntry, and formats the response.

  if (name === "add_log") {
    const { plan_id, node_id, content, log_type = "comment", tags } = args;
    
    const logData = {
      content,
      log_type,
      tags
    };
    
    const result = await apiClient.logs.addLogEntry(plan_id, node_id, logData);
    return formatResponse(result);
  }

• src/tools.js:277-299 (schema)

  Input schema definition for the 'add_log' tool, defining parameters like plan_id, node_id, content, log_type, and tags.

    name: "add_log",
    description: "Add a log entry to a node (replaces comments)",
    inputSchema: {
      type: "object",
      properties: {
        plan_id: { type: "string", description: "Plan ID" },
        node_id: { type: "string", description: "Node ID" },
        content: { type: "string", description: "Log content" },
        log_type: { 
          type: "string", 
          description: "Type of log entry",
          enum: ["progress", "reasoning", "challenge", "decision", "comment"],
          default: "comment"
        },
        tags: { 
          type: "array", 
          description: "Tags for categorizing the log entry",
          items: { type: "string" }
        }
      },
      required: ["plan_id", "node_id", "content"]
    }
  },

• src/tools.js:276-299 (registration)

  Registration of the 'add_log' tool in the ListToolsRequestSchema handler's tools array.

  {
    name: "add_log",
    description: "Add a log entry to a node (replaces comments)",
    inputSchema: {
      type: "object",
      properties: {
        plan_id: { type: "string", description: "Plan ID" },
        node_id: { type: "string", description: "Node ID" },
        content: { type: "string", description: "Log content" },
        log_type: { 
          type: "string", 
          description: "Type of log entry",
          enum: ["progress", "reasoning", "challenge", "decision", "comment"],
          default: "comment"
        },
        tags: { 
          type: "array", 
          description: "Tags for categorizing the log entry",
          items: { type: "string" }
        }
      },
      required: ["plan_id", "node_id", "content"]
    }
  },

• src/api-client.js:227-230 (helper)

  Helper function in api-client.js that executes the actual HTTP POST request to add a log entry to the backend API.

  addLogEntry: async (planId, nodeId, logData) => {
    const response = await apiClient.post(`/plans/${planId}/nodes/${nodeId}/log`, logData);
    return response.data;
  }