loopctl-mcp-server 2.22.0 → 2.24.0

package/index.js

@@ -178,8 +178,12 @@ async function getTenant() {
   return toContent(result);
 }
 
-async function listProjects() {
-  const result = await apiCall("GET", "/api/v1/projects");
+async function listProjects({ page, page_size } = {}) {
+  const params = new URLSearchParams();
+  if (page != null) params.set("page", String(page));
+  if (page_size != null) params.set("page_size", String(page_size));
+  const query = params.toString() ? `?${params}` : "";
+  const result = await apiCall("GET", `/api/v1/projects${query}`);
   return toContent(result);
 }
 
@@ -381,12 +385,13 @@ async function listStories({ project_id, agent_status, verified_status, epic_id,
   return toContentCompact(result);
 }
 
-async function listReadyStories({ project_id, limit }) {
+async function listReadyStories({ project_id, page, page_size }) {
+  // /stories/ready paginates by page/page_size — the old `limit` param was
+  // silently ignored by the server, capping callers at the first page.
   const params = new URLSearchParams({ project_id });
-  params.set(
-    "limit",
-    String(Math.min(limit ?? DEFAULT_STORY_PAGE_SIZE, SERVER_MAX_STORY_PAGE_SIZE)),
-  );
+  if (page != null) params.set("page", String(page));
+  if (page_size != null)
+    params.set("page_size", String(Math.min(page_size, SERVER_MAX_STORY_PAGE_SIZE)));
 
   const result = await apiCall("GET", `/api/v1/stories/ready?${params}`);
   return toContentCompact(result);
@@ -559,14 +564,20 @@ async function getCostSummary({ project_id, breakdown }) {
   return toContent(result);
 }
 
-async function getStoryTokenUsage({ story_id }) {
-  const result = await apiCall("GET", `/api/v1/stories/${story_id}/token-usage`);
+async function getStoryTokenUsage({ story_id, page, page_size }) {
+  const params = new URLSearchParams();
+  if (page != null) params.set("page", String(page));
+  if (page_size != null) params.set("page_size", String(page_size));
+  const query = params.toString() ? `?${params}` : "";
+  const result = await apiCall("GET", `/api/v1/stories/${story_id}/token-usage${query}`);
   return toContent(result);
 }
 
-async function getCostAnomalies({ project_id }) {
+async function getCostAnomalies({ project_id, page, page_size }) {
   const params = new URLSearchParams();
   if (project_id) params.set("project_id", project_id);
+  if (page != null) params.set("page", String(page));
+  if (page_size != null) params.set("page_size", String(page_size));
 
   const query = params.toString() ? `?${params}` : "";
   const result = await apiCall("GET", `/api/v1/cost-anomalies${query}`);
@@ -1069,16 +1080,27 @@ async function knowledgeIngestBatch({ items, project_id, publish }) {
   return toContent(result);
 }
 
-async function knowledgeIngestionJobs() {
-  const result = await apiCall("GET", "/api/v1/knowledge/ingestion-jobs", null, process.env.LOOPCTL_ORCH_KEY);
+async function knowledgeIngestionJobs({ limit, offset, since_days } = {}) {
+  const params = new URLSearchParams();
+  if (limit != null) params.set("limit", String(limit));
+  if (offset != null) params.set("offset", String(offset));
+  if (since_days != null) params.set("since_days", String(since_days));
+  const query = params.toString() ? `?${params}` : "";
+  const result = await apiCall(
+    "GET",
+    `/api/v1/knowledge/ingestion-jobs${query}`,
+    null,
+    process.env.LOOPCTL_ORCH_KEY,
+  );
   return toContent(result);
 }
 
 // --- Knowledge Analytics Tools (orch key) ---
 
-async function knowledgeAnalyticsTop({ limit, since_days, access_type } = {}) {
+async function knowledgeAnalyticsTop({ limit, offset, since_days, access_type } = {}) {
   const params = new URLSearchParams();
   if (limit != null) params.set("limit", String(limit));
+  if (offset != null) params.set("offset", String(offset));
   if (since_days != null) params.set("since_days", String(since_days));
   if (access_type) params.set("access_type", access_type);
   const qs = params.toString();
@@ -1166,10 +1188,11 @@ async function knowledgeAgentUsage({ api_key_id, agent_id, limit, since_days } =
   return toContent(result);
 }
 
-async function knowledgeUnusedArticles({ days_unused, limit } = {}) {
+async function knowledgeUnusedArticles({ days_unused, limit, offset } = {}) {
   const params = new URLSearchParams();
   if (days_unused != null) params.set("days_unused", String(days_unused));
   if (limit != null) params.set("limit", String(limit));
+  if (offset != null) params.set("offset", String(offset));
   const qs = params.toString();
   const path = qs
     ? `/api/v1/knowledge/analytics/unused-articles?${qs}`
@@ -1401,10 +1424,15 @@ const TOOLS = [
   },
   {
     name: "list_projects",
-    description: "List all projects in the current tenant.",
+    description:
+      "List projects in the current tenant. Paginated (page/page_size); advance " +
+      "`page` to enumerate all projects. Response includes pagination meta.",
     inputSchema: {
       type: "object",
-      properties: {},
+      properties: {
+        page: { type: "integer", description: "Page number (default 1)." },
+        page_size: { type: "integer", description: "Items per page (default 20)." },
+      },
       required: [],
     },
   },
@@ -1608,7 +1636,8 @@ const TOOLS = [
     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; pass `limit` up to 500 to page larger. Response includes total_count.",
+      "Paginated (page/page_size); advance `page` to enumerate all ready stories. " +
+      "Response includes total_count.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1616,9 +1645,10 @@ const TOOLS = [
           type: "string",
           description: "The UUID of the project.",
         },
-        limit: {
+        page: { type: "integer", description: "Page number (default 1)." },
+        page_size: {
           type: "integer",
-          description: "Maximum number of stories to return (default 20, max 500).",
+          description: "Stories per page (default 100, max 500).",
         },
       },
       required: ["project_id"],
@@ -1963,7 +1993,9 @@ const TOOLS = [
   },
   {
     name: "get_story_token_usage",
-    description: "Get token usage records for a single story.",
+    description:
+      "Get token usage records for a single story. Paginated (page/page_size); " +
+      "advance `page` to enumerate all records.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1971,6 +2003,8 @@ const TOOLS = [
           type: "string",
           description: "The UUID of the story.",
         },
+        page: { type: "integer", description: "Page number (default 1)." },
+        page_size: { type: "integer", description: "Records per page (default 20)." },
       },
       required: ["story_id"],
     },
@@ -1979,7 +2013,8 @@ const TOOLS = [
     name: "get_cost_anomalies",
     description:
       "Get cost anomaly alerts — stories or agents that exceed expected token budgets. " +
-      "Optionally filter by project.",
+      "Optionally filter by project. Paginated (page/page_size); advance `page` to " +
+      "enumerate all anomalies.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1987,6 +2022,8 @@ const TOOLS = [
           type: "string",
           description: "Optional: filter anomalies to a specific project UUID.",
         },
+        page: { type: "integer", description: "Page number (default 1)." },
+        page_size: { type: "integer", description: "Anomalies per page (default 20)." },
       },
       required: [],
     },
@@ -3038,11 +3075,20 @@ const TOOLS = [
   {
     name: "knowledge_ingestion_jobs",
     description:
-      "List recent content ingestion jobs for the current tenant. " +
-      "Returns jobs from the last 7 days, max 50 results. Requires orchestrator role.",
+      "List content ingestion jobs for the current tenant, newest first. " +
+      "Paginated (limit/offset over the full history; advance `offset` by `meta.limit` " +
+      "to enumerate to completeness). Optional `since_days` narrows to a recent window. " +
+      "Requires orchestrator role.",
     inputSchema: {
       type: "object",
-      properties: {},
+      properties: {
+        limit: { type: "integer", description: "Jobs per page (default 20)." },
+        offset: { type: "integer", description: "Rows to skip (default 0)." },
+        since_days: {
+          type: "integer",
+          description: "Optional: only jobs from the last N days (default: all history).",
+        },
+      },
       required: [],
     },
   },
@@ -3058,10 +3104,15 @@ const TOOLS = [
       properties: {
         limit: {
           type: "integer",
-          description: "Max rows to return. Default 20, max 100.",
+          description: "Max rows per page. Default 20, max 100.",
           minimum: 1,
           maximum: 100,
         },
+        offset: {
+          type: "integer",
+          description: "Rows to skip — page the ranking past the first page. Default 0.",
+          minimum: 0,
+        },
         since_days: {
           type: "integer",
           description: "Look back this many days. Default 7.",
@@ -3144,10 +3195,15 @@ const TOOLS = [
         },
         limit: {
           type: "integer",
-          description: "Max rows to return. Default 50, max 200.",
+          description: "Max rows per page. Default 50, max 200.",
           minimum: 1,
           maximum: 200,
         },
+        offset: {
+          type: "integer",
+          description: "Rows to skip — page the full unused set to completeness. Default 0.",
+          minimum: 0,
+        },
       },
       required: [],
     },

package/package.json

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