loopctl-mcp-server 1.1.0 → 1.1.2

package/index.js

@@ -116,10 +116,12 @@ function toContent(result) {
 }
 
 /**
- * Compact variant for list endpoints — strips bulky fields (acceptance_criteria,
- * description) from each story to stay within token limits. Callers can use
- * get_story for full details on individual stories.
+ * Compact variant for list endpoints — strips acceptance_criteria and
+ * description (use get_story for full details). Keeps all other fields.
+ * Enforces a max page size to prevent MCP response token overflow.
  */
+const MAX_PAGE_SIZE = 20;
+
 function toContentCompact(result) {
   if (result && result.error === true) return toContent(result);
 
@@ -191,7 +193,7 @@ async function listStories({ project_id, agent_status, verified_status, epic_id,
   if (agent_status) params.set("agent_status", agent_status);
   if (verified_status) params.set("verified_status", verified_status);
   if (epic_id) params.set("epic_id", epic_id);
-  params.set("limit", String(limit ?? 20));
+  params.set("limit", String(Math.min(limit ?? MAX_PAGE_SIZE, MAX_PAGE_SIZE)));
   if (offset != null) params.set("offset", String(offset));
   if (include_token_totals) params.set("include_token_totals", "true");
 
@@ -201,7 +203,7 @@ async function listStories({ project_id, agent_status, verified_status, epic_id,
 
 async function listReadyStories({ project_id, limit }) {
   const params = new URLSearchParams({ project_id });
-  params.set("limit", String(limit ?? 20));
+  params.set("limit", String(Math.min(limit ?? MAX_PAGE_SIZE, MAX_PAGE_SIZE)));
 
   const result = await apiCall("GET", `/api/v1/stories/ready?${params}`);
   return toContentCompact(result);
@@ -359,10 +361,18 @@ async function reportTokenUsage({ story_id, input_tokens, output_tokens, model_n
 }
 
 async function getCostSummary({ project_id, breakdown }) {
-  const params = new URLSearchParams({ project_id });
-  if (breakdown) params.set("breakdown", breakdown);
+  let path;
+  if (breakdown === "agent") {
+    path = `/api/v1/analytics/agents?project_id=${project_id}`;
+  } else if (breakdown === "epic") {
+    path = `/api/v1/analytics/epics?project_id=${project_id}`;
+  } else if (breakdown === "model") {
+    path = `/api/v1/analytics/models?project_id=${project_id}`;
+  } else {
+    path = `/api/v1/analytics/projects/${project_id}`;
+  }
 
-  const result = await apiCall("GET", `/api/v1/projects/${project_id}/cost-summary?${params}`);
+  const result = await apiCall("GET", path);
   return toContent(result);
 }
 
@@ -482,7 +492,8 @@ const TOOLS = [
     description:
       "List stories for a project, optionally filtered by agent_status, verified_status, or epic_id. " +
       "Returns compact results (no acceptance_criteria/description) — use get_story for full details. " +
-      "Defaults to 20 stories per page; use limit/offset to paginate.",
+      "Max 20 per page. Use offset to paginate (response includes total_count). " +
+      "Filter by epic_id or agent_status to reduce result size.",
     inputSchema: {
       type: "object",
       properties: {
@@ -523,7 +534,8 @@ const TOOLS = [
     name: "list_ready_stories",
     description:
       "List stories that are ready to be worked on (contracted, dependencies met). " +
-      "Returns compact results — use get_story for full details. Defaults to 20 per page.",
+      "Returns compact results — use get_story for full details. " +
+      "Max 20 per page. Response includes total_count for pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -840,7 +852,8 @@ const TOOLS = [
         },
         phase: {
           type: "string",
-          description: "Optional: phase of work (e.g. implement, review, verify).",
+          enum: ["planning", "implementing", "reviewing", "other"],
+          description: "Optional: phase of work.",
         },
         skill_version_id: {
           type: "string",
@@ -956,7 +969,7 @@ const TOOLS = [
 const server = new Server(
   {
     name: "loopctl",
-    version: "1.1.0",
+    version: "1.1.2",
   },
   {
     capabilities: { tools: {} },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopctl-mcp-server",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "MCP server for loopctl — structural trust for AI development loops",
   "type": "module",
   "main": "index.js",