agent-planner-mcp 0.6.0 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-planner-mcp",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "MCP server for AgentPlanner — AI agent orchestration with planning, dependencies, knowledge graphs, and human oversight",
   "main": "src/index.js",
   "bin": {

package/src/api-client.js

@@ -552,45 +552,47 @@ const goals = {
     return response.data;
   },
   
-  updateMetrics: async (goalId, metrics) => {
-    const response = await apiClient.put(`/goals/${goalId}/metrics`, { metrics });
-    return response.data;
-  },
-  
   delete: async (goalId) => {
     const response = await apiClient.delete(`/goals/${goalId}`);
     return response.data;
   },
-  
+
   linkPlan: async (goalId, planId) => {
-    const response = await apiClient.post(`/goals/${goalId}/plans/${planId}`);
+    const response = await apiClient.post(`/goals/${goalId}/links`, {
+      linkedType: 'plan', linkedId: planId
+    });
     return response.data;
   },
-  
+
   unlinkPlan: async (goalId, planId) => {
-    const response = await apiClient.delete(`/goals/${goalId}/plans/${planId}`);
+    const goal = await apiClient.get(`/goals/${goalId}`);
+    const link = (goal.data.links || []).find(
+      l => l.linkedType === 'plan' && l.linkedId === planId
+    );
+    if (!link) return { success: false, message: 'Link not found' };
+    const response = await apiClient.delete(`/goals/${goalId}/links/${link.id}`);
     return response.data;
   },
 
   // v2 goal-dependency endpoints
   getPath: async (goalId, maxDepth) => {
     const params = maxDepth ? `?max_depth=${maxDepth}` : '';
-    const response = await apiClient.get(`/goals/v2/${goalId}/path${params}`);
+    const response = await apiClient.get(`/goals/${goalId}/path${params}`);
     return response.data;
   },
 
   getProgress: async (goalId) => {
-    const response = await apiClient.get(`/goals/v2/${goalId}/progress`);
+    const response = await apiClient.get(`/goals/${goalId}/progress`);
     return response.data;
   },
 
   listAchievers: async (goalId) => {
-    const response = await apiClient.get(`/goals/v2/${goalId}/achievers`);
+    const response = await apiClient.get(`/goals/${goalId}/achievers`);
     return response.data;
   },
 
   addAchiever: async (goalId, sourceNodeId, weight) => {
-    const response = await apiClient.post(`/goals/v2/${goalId}/achievers`, {
+    const response = await apiClient.post(`/goals/${goalId}/achievers`, {
       source_node_id: sourceNodeId,
       weight: weight ?? 1,
     });
@@ -598,17 +600,17 @@ const goals = {
   },
 
   removeAchiever: async (goalId, depId) => {
-    const response = await apiClient.delete(`/goals/v2/${goalId}/achievers/${depId}`);
+    const response = await apiClient.delete(`/goals/${goalId}/achievers/${depId}`);
     return response.data;
   },
 
   getKnowledgeGaps: async (goalId) => {
-    const response = await apiClient.get(`/goals/v2/${goalId}/knowledge-gaps`);
+    const response = await apiClient.get(`/goals/${goalId}/knowledge-gaps`);
     return response.data;
   },
 
   getDashboard: async () => {
-    const response = await apiClient.get('/goals/v2/dashboard');
+    const response = await apiClient.get('/goals/dashboard');
     return response.data;
   },
 };
@@ -866,17 +868,21 @@ function createApiClient(token) {
       get: async (goalId) => (await client.get(`/goals/${goalId}`)).data,
       create: async (data) => (await client.post('/goals', data)).data,
       update: async (goalId, data) => (await client.put(`/goals/${goalId}`, data)).data,
-      updateMetrics: async (goalId, metrics) => (await client.put(`/goals/${goalId}/metrics`, { metrics })).data,
       delete: async (goalId) => (await client.delete(`/goals/${goalId}`)).data,
-      linkPlan: async (goalId, planId) => (await client.post(`/goals/${goalId}/plans/${planId}`)).data,
-      unlinkPlan: async (goalId, planId) => (await client.delete(`/goals/${goalId}/plans/${planId}`)).data,
-      getPath: async (goalId, maxDepth) => { const p = maxDepth ? `?max_depth=${maxDepth}` : ''; return (await client.get(`/goals/v2/${goalId}/path${p}`)).data; },
-      getProgress: async (goalId) => (await client.get(`/goals/v2/${goalId}/progress`)).data,
-      listAchievers: async (goalId) => (await client.get(`/goals/v2/${goalId}/achievers`)).data,
-      addAchiever: async (goalId, sourceNodeId, weight) => (await client.post(`/goals/v2/${goalId}/achievers`, { source_node_id: sourceNodeId, weight: weight ?? 1 })).data,
-      removeAchiever: async (goalId, depId) => (await client.delete(`/goals/v2/${goalId}/achievers/${depId}`)).data,
-      getKnowledgeGaps: async (goalId) => (await client.get(`/goals/v2/${goalId}/knowledge-gaps`)).data,
-      getDashboard: async () => (await client.get('/goals/v2/dashboard')).data,
+      linkPlan: async (goalId, planId) => (await client.post(`/goals/${goalId}/links`, { linkedType: 'plan', linkedId: planId })).data,
+      unlinkPlan: async (goalId, planId) => {
+        const goal = await client.get(`/goals/${goalId}`);
+        const link = (goal.data.links || []).find(l => l.linkedType === 'plan' && l.linkedId === planId);
+        if (!link) return { success: false, message: 'Link not found' };
+        return (await client.delete(`/goals/${goalId}/links/${link.id}`)).data;
+      },
+      getPath: async (goalId, maxDepth) => { const p = maxDepth ? `?max_depth=${maxDepth}` : ''; return (await client.get(`/goals/${goalId}/path${p}`)).data; },
+      getProgress: async (goalId) => (await client.get(`/goals/${goalId}/progress`)).data,
+      listAchievers: async (goalId) => (await client.get(`/goals/${goalId}/achievers`)).data,
+      addAchiever: async (goalId, sourceNodeId, weight) => (await client.post(`/goals/${goalId}/achievers`, { source_node_id: sourceNodeId, weight: weight ?? 1 })).data,
+      removeAchiever: async (goalId, depId) => (await client.delete(`/goals/${goalId}/achievers/${depId}`)).data,
+      getKnowledgeGaps: async (goalId) => (await client.get(`/goals/${goalId}/knowledge-gaps`)).data,
+      getDashboard: async () => (await client.get('/goals/dashboard')).data,
     },
     context: {
       getNodeContext: async (nodeId, options = {}) => {

package/src/index.js

@@ -42,12 +42,9 @@ async function main() {
     console.error(`MCP Server Name: ${process.env.MCP_SERVER_NAME || 'planning-system-mcp'}`);
     console.error(`MCP Server Version: ${process.env.MCP_SERVER_VERSION || version}`);
 
-    // Validate required environment variables
-    if (!userApiToken) {
-      throw new Error('USER_API_TOKEN environment variable is required. Please generate one from the Agent Planner UI and set it in .env file.');
-    }
-
     if (transport === 'http') {
+      // HTTP mode: tokens come from the Authorization header on each request
+      // No USER_API_TOKEN needed — per-session clients are created in server-http.js
       // HTTP/SSE transport mode
       const httpServer = new MCPHTTPServer({
         port: process.env.PORT || 3100,
@@ -69,7 +66,11 @@ async function main() {
         process.exit(0);
       });
     } else {
-      // Stdio transport mode (default)
+      // Stdio transport mode (default) — requires USER_API_TOKEN since there's no HTTP request
+      if (!userApiToken) {
+        throw new Error('USER_API_TOKEN environment variable is required for stdio mode. Please generate one from the Agent Planner UI and set it in .env file.');
+      }
+
       const server = new Server({
         name: process.env.MCP_SERVER_NAME || "planning-system-mcp",
         version: process.env.MCP_SERVER_VERSION || version

package/src/tools.js

@@ -285,14 +285,19 @@ function setupTools(server, apiClientOverride) {
         // ===== PLAN MANAGEMENT TOOLS =====
         {
           name: "list_plans",
-          description: "List all plans or filter by status",
+          description: "List plans. By default excludes completed/archived plans — set include_completed to true to see all.",
           inputSchema: {
             type: "object",
             properties: {
-              status: { 
-                type: "string", 
+              status: {
+                type: "string",
                 description: "Optional filter by plan status",
                 enum: ["draft", "active", "completed", "archived"]
+              },
+              include_completed: {
+                type: "boolean",
+                description: "If true, include completed and archived plans (default: false)",
+                default: false
               }
             }
           }
@@ -815,15 +820,20 @@ function setupTools(server, apiClientOverride) {
         // ===== GOAL TOOLS =====
         {
           name: "list_goals",
-          description: "List goals, optionally filtered by organization or status",
+          description: "List goals. By default returns only active goals — set include_inactive to true to see all.",
           inputSchema: {
             type: "object",
             properties: {
               organization_id: { type: "string", description: "Filter by organization ID" },
-              status: { 
-                type: "string", 
+              status: {
+                type: "string",
                 description: "Filter by status",
                 enum: ["active", "achieved", "at_risk", "abandoned"]
+              },
+              include_inactive: {
+                type: "boolean",
+                description: "If true, include achieved/paused/abandoned goals (default: false)",
+                default: false
               }
             }
           }
@@ -848,21 +858,10 @@ function setupTools(server, apiClientOverride) {
               organization_id: { type: "string", description: "Organization ID" },
               title: { type: "string", description: "Goal title" },
               description: { type: "string", description: "Goal description" },
-              success_metrics: { 
-                type: "array", 
-                description: "Success metrics array [{metric, target, current, unit}]",
-                items: {
-                  type: "object",
-                  properties: {
-                    metric: { type: "string" },
-                    target: { type: "number" },
-                    current: { type: "number" },
-                    unit: { type: "string" }
-                  }
-                }
-              },
-              time_horizon: { type: "string", description: "Target date (ISO format)" },
-              github_repo_url: { type: "string", description: "Related GitHub repo URL" }
+              type: { type: "string", enum: ["outcome", "constraint", "metric", "principle"], description: "Goal type (default: outcome)" },
+              success_criteria: { type: "object", description: "Success criteria as JSON" },
+              priority: { type: "number", description: "Priority (higher = more important, default: 0)" },
+              parent_goal_id: { type: "string", description: "Parent goal ID for hierarchy" }
             },
             required: ["organization_id", "title"]
           }
@@ -876,13 +875,15 @@ function setupTools(server, apiClientOverride) {
               goal_id: { type: "string", description: "Goal ID" },
               title: { type: "string", description: "New title" },
               description: { type: "string", description: "New description" },
-              status: { 
-                type: "string", 
+              type: { type: "string", enum: ["outcome", "constraint", "metric", "principle"], description: "Goal type" },
+              status: {
+                type: "string",
                 description: "New status",
-                enum: ["active", "achieved", "at_risk", "abandoned"]
+                enum: ["active", "achieved", "paused", "abandoned"]
               },
-              success_metrics: { type: "array", description: "Updated metrics" },
-              time_horizon: { type: "string", description: "New target date" }
+              success_criteria: { type: "object", description: "Success criteria as JSON" },
+              priority: { type: "number", description: "Priority (higher = more important)" },
+              parent_goal_id: { type: "string", description: "Parent goal ID for hierarchy" }
             },
             required: ["goal_id"]
           }
@@ -1655,9 +1656,16 @@ function setupTools(server, apiClientOverride) {
       
       // ===== PLAN MANAGEMENT =====
       if (name === "list_plans") {
-        const { status } = args;
+        const { status, include_completed } = args;
         const plans = await apiClient.plans.getPlans();
-        const filteredPlans = status ? plans.filter(p => p.status === status) : plans;
+        let filteredPlans;
+        if (status) {
+          filteredPlans = plans.filter(p => p.status === status);
+        } else if (!include_completed) {
+          filteredPlans = plans.filter(p => p.status !== 'completed' && p.status !== 'archived');
+        } else {
+          filteredPlans = plans;
+        }
         return formatResponse(filteredPlans);
       }
       
@@ -2006,8 +2014,9 @@ function setupTools(server, apiClientOverride) {
       
       // ===== GOAL TOOLS =====
       if (name === "list_goals") {
-        const { organization_id, status } = args;
-        const result = await apiClient.goals.list({ organization_id, status });
+        const { organization_id, status, include_inactive } = args;
+        const effectiveStatus = status || (!include_inactive ? 'active' : undefined);
+        const result = await apiClient.goals.list({ organization_id, status: effectiveStatus });
         return formatResponse(result);
       }
       
@@ -2018,20 +2027,24 @@ function setupTools(server, apiClientOverride) {
       }
       
       if (name === "create_goal") {
-        const { organization_id, title, description, success_metrics, time_horizon, github_repo_url } = args;
+        const { organization_id, title, description, type, success_criteria, priority, parent_goal_id } = args;
         const result = await apiClient.goals.create({
           organization_id,
           title,
           description,
-          success_metrics,
-          time_horizon,
-          github_repo_url
+          type: type || 'outcome',
+          successCriteria: success_criteria || null,
+          priority: priority || 0,
+          parentGoalId: parent_goal_id || null,
         });
         return formatResponse(result);
       }
       
       if (name === "update_goal") {
-        const { goal_id, ...updateData } = args;
+        const { goal_id, parent_goal_id, success_criteria, ...rest } = args;
+        const updateData = { ...rest };
+        if (parent_goal_id !== undefined) updateData.parentGoalId = parent_goal_id;
+        if (success_criteria !== undefined) updateData.successCriteria = success_criteria;
         const result = await apiClient.goals.update(goal_id, updateData);
         return formatResponse(result);
       }