Planning System MCP Server

Instructions

Implementation Reference

• src/tools.js:554-558 (handler)

  The main handler for the 'update_node' tool. It extracts plan_id, node_id, and other nodeData from arguments, calls the API client's updateNode method, and formats the response using formatResponse.

  if (name === "update_node") {
    const { plan_id, node_id, ...nodeData } = args;
    const result = await apiClient.nodes.updateNode(plan_id, node_id, nodeData);
    return formatResponse(result);
  }

• src/tools.js:200-223 (schema)

  The input schema and tool metadata (name, description, inputSchema) for 'update_node', which defines the expected parameters and serves as its registration in the tools list.

  {
    name: "update_node",
    description: "Update a node's properties",
    inputSchema: {
      type: "object",
      properties: {
        plan_id: { type: "string", description: "Plan ID" },
        node_id: { type: "string", description: "Node ID" },
        title: { type: "string", description: "New node title" },
        description: { type: "string", description: "New node description" },
        status: { 
          type: "string", 
          description: "New node status",
          enum: ["not_started", "in_progress", "completed", "blocked"]
        },
        context: { type: "string", description: "New context" },
        agent_instructions: { type: "string", description: "New agent instructions" },
        acceptance_criteria: { type: "string", description: "New acceptance criteria" },
        due_date: { type: "string", description: "New due date (ISO format)" },
        metadata: { type: "object", description: "New metadata" }
      },
      required: ["plan_id", "node_id"]
    }
  },

• src/api-client.js:149-152 (helper)

  The API client helper method that performs the actual HTTP PUT request to update the node via the backend API.

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