Planning System MCP Server

Instructions

Implementation Reference

• src/tools.js:634-648 (handler)

  Executes the get_logs tool: parses input arguments, retrieves logs using apiClient, applies optional log_type filter and limit, formats and returns the response.

  if (name === "get_logs") {
    const { plan_id, node_id, log_type, limit = 50 } = args;
    
    let logs = await apiClient.logs.getLogs(plan_id, node_id);
    
    // Apply filters
    if (log_type) {
      logs = logs.filter(log => log.log_type === log_type);
    }
    
    // Apply limit
    logs = logs.slice(0, limit);
    
    return formatResponse(logs);
  }

• src/tools.js:303-320 (schema)

  Input schema defining parameters for the get_logs tool: plan_id and node_id (required), optional log_type filter and limit.

  inputSchema: {
    type: "object",
    properties: {
      plan_id: { type: "string", description: "Plan ID" },
      node_id: { type: "string", description: "Node ID" },
      log_type: { 
        type: "string", 
        description: "Filter by log type",
        enum: ["progress", "reasoning", "challenge", "decision", "comment"]
      },
      limit: {
        type: "integer",
        description: "Maximum number of logs to return",
        default: 50
      }
    },
    required: ["plan_id", "node_id"]
  }

• src/tools.js:300-321 (registration)

  Tool registration in the ListTools response array, including name, description, and schema.

  {
    name: "get_logs",
    description: "Get log entries for a node",
    inputSchema: {
      type: "object",
      properties: {
        plan_id: { type: "string", description: "Plan ID" },
        node_id: { type: "string", description: "Node ID" },
        log_type: { 
          type: "string", 
          description: "Filter by log type",
          enum: ["progress", "reasoning", "challenge", "decision", "comment"]
        },
        limit: {
          type: "integer",
          description: "Maximum number of logs to return",
          default: 50
        }
      },
      required: ["plan_id", "node_id"]
    }
  },

• src/api-client.js:215-218 (helper)

  Helper function in apiClient.logs that performs the HTTP GET request to retrieve logs from the backend API.

  getLogs: async (planId, nodeId) => {
    const response = await apiClient.get(`/plans/${planId}/nodes/${nodeId}/logs`);
    return response.data;
  },