@opsee/mcp-server 0.6.5 → 0.6.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opsee/mcp-server",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Opsee MCP server — manage projects, tasks, docs, and cycles from AI coding environments",
   "type": "module",
   "bin": {

package/src/tools/tasks.ts

@@ -85,7 +85,21 @@ export function registerTaskTools(
           sortDir,
         });
 
-        return { content: [{ type: "text", text: formatTaskList(res.tasks) }] };
+        const pagination = res.pagination;
+        const currentPage = page || 1;
+        const hasMore = (pagination?.nextPage ?? 0) > 0;
+
+        return {
+          content: [{
+            type: "text",
+            text: formatTaskList(res.tasks, {
+              totalCount: pagination?.total,
+              page: currentPage,
+              hasMore,
+              nextPage: hasMore ? currentPage + 1 : undefined,
+            }),
+          }],
+        };
       } catch (error) {
         return { content: [{ type: "text", text: formatError(error) }], isError: true };
       }

package/src/utils/format.ts

@@ -56,14 +56,49 @@ export function formatTask(t: Task): string {
   return lines.join("\n");
 }
 
-export function formatTaskList(tasks: Task[], projectName?: string): string {
+interface TaskListMeta {
+  totalCount?: number;
+  page?: number;
+  hasMore?: boolean;
+  nextPage?: number;
+}
+
+export function formatTaskList(tasks: Task[], projectNameOrMeta?: string | TaskListMeta): string {
   if (tasks.length === 0) return "No tasks found.";
-  const header = projectName
-    ? `Found ${tasks.length} task(s) in project "${projectName}":\n`
-    : `Found ${tasks.length} task(s):\n`;
-  return (
-    header + tasks.map((t, i) => `${i + 1}. ${formatTask(t)}`).join("\n\n")
-  );
+
+  // Support both old signature (projectName: string) and new signature (meta: TaskListMeta)
+  const isMetaObject = projectNameOrMeta && typeof projectNameOrMeta === 'object';
+  const meta = isMetaObject ? projectNameOrMeta as TaskListMeta : undefined;
+  const projectName = !isMetaObject ? projectNameOrMeta as string | undefined : undefined;
+
+  const lines: string[] = [];
+
+  // Pagination metadata header
+  if (meta?.totalCount !== undefined) {
+    const pageInfo = meta.page ? `page ${meta.page}` : '';
+    const totalInfo = `${meta.totalCount} total`;
+    const header = [pageInfo, totalInfo].filter(Boolean).join(', ');
+    lines.push(`Tasks (${header}):`);
+    if (meta.hasMore && meta.nextPage) {
+      lines.push(`(Use page: ${meta.nextPage} to fetch the next 50 tasks)`);
+    }
+    lines.push('');
+  } else {
+    // Original header format
+    const header = projectName
+      ? `Found ${tasks.length} task(s) in project "${projectName}":\n`
+      : `Found ${tasks.length} task(s):\n`;
+    lines.push(header.trimEnd());
+    lines.push('');
+  }
+
+  // Task list
+  tasks.forEach((t, i) => {
+    lines.push(`${i + 1}. ${formatTask(t)}`);
+    lines.push('');
+  });
+
+  return lines.join('\n').trimEnd();
 }
 
 export function formatCycle(c: Cycle): string {