@damper/mcp 0.3.19 → 0.3.21

package/dist/index.js

@@ -111,16 +111,20 @@ server.registerTool('list_tasks', {
     title: 'List Tasks',
     description: 'Get roadmap tasks. Returns planned/in-progress by default. ' +
         'Filter by type, quarter, etc.\n\n' +
+        'Returns up to 20 tasks by default. Response includes `total` count. ' +
+        'If total > returned tasks, paginate with offset (e.g. offset=20 for page 2).\n\n' +
         '**Recommended:** Call `get_project_context` before starting work to understand codebase patterns.',
     inputSchema: z.object({
         status: z.enum(['planned', 'in_progress', 'done', 'all']).optional(),
         type: z.enum(['bug', 'feature', 'improvement', 'task']).optional().describe('Filter by task type'),
         quarter: z.string().optional().describe('Filter by quarter (e.g., "Q1 2025") or "none" for unscheduled'),
         sort: z.enum(['importance', 'newest', 'votes']).optional().describe('Sort order: importance (priority+votes, default), newest, or votes'),
-        limit: z.number().optional(),
+        limit: z.number().optional().describe('Max tasks to return (default: 20)'),
+        offset: z.number().optional().describe('Skip first N tasks for pagination (default: 0)'),
     }),
     outputSchema: z.object({
         project: z.string(),
+        total: z.number(),
         tasks: z.array(TaskSummarySchema),
     }),
     annotations: {
@@ -129,7 +133,7 @@ server.registerTool('list_tasks', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ status, type, quarter, sort, limit }) => {
+}, async ({ status, type, quarter, sort, limit, offset }) => {
     const params = new URLSearchParams();
     if (status)
         params.set('status', status);
@@ -141,13 +145,15 @@ server.registerTool('list_tasks', {
         params.set('sort', sort);
     if (limit)
         params.set('limit', String(limit));
+    if (offset)
+        params.set('offset', String(offset));
     const query = params.toString();
     const data = await api('GET', `/api/agent/tasks${query ? `?${query}` : ''}`);
     if (!data.tasks.length) {
         const filters = [type && `type: ${type}`, quarter && `quarter: ${quarter}`].filter(Boolean).join(', ');
         return {
             content: [{ type: 'text', text: `No tasks in "${data.project.name}"${filters ? ` (${filters})` : ''}` }],
-            structuredContent: { project: data.project.name, tasks: [] },
+            structuredContent: { project: data.project.name, total: 0, tasks: [] },
         };
     }
     const lines = data.tasks.map((t) => {
@@ -157,15 +163,20 @@ server.registerTool('list_tasks', {
         const quarterInfo = t.quarter ? ` 📅${t.quarter}` : '';
         return `• ${t.id}: ${typeIcon} ${t.title} [${t.status}] ${p}${quarterInfo}${t.hasImplementationPlan ? ' 📋' : ''}${subtaskInfo}`;
     });
+    const currentOffset = offset || 0;
+    const paginationInfo = data.total > currentOffset + data.tasks.length
+        ? `\n📄 Showing ${currentOffset + 1}–${currentOffset + data.tasks.length} of ${data.total}. Use offset=${currentOffset + data.tasks.length} to see more.`
+        : '';
     const output = [
-        `Tasks in "${data.project.name}":`,
+        `Tasks in "${data.project.name}" (${data.total} total):`,
         lines.join('\n'),
+        paginationInfo,
         '',
         '💡 **Tip:** Run `get_project_context` first to understand codebase patterns before starting work.',
     ].join('\n');
     return {
         content: [{ type: 'text', text: output }],
-        structuredContent: { project: data.project.name, tasks: data.tasks },
+        structuredContent: { project: data.project.name, total: data.total, tasks: data.tasks },
     };
 });
 // Tool: Get task
@@ -326,7 +337,8 @@ server.registerTool('create_task', {
     title: 'Create Task',
     description: 'Create a new roadmap task. Use for importing from TODO files or creating work items.',
     inputSchema: z.object({
-        title: z.string(),
+        title: z.string().describe('Task title. Use verb prefix matching the type: ' +
+            'bug → "Fix …", feature → "Add …", improvement → "Improve …", task → "Set up …" / "Update …"'),
         description: z.string().optional(),
         type: z.enum(['bug', 'feature', 'improvement', 'task']).optional().describe('Task type (default: feature)'),
         status: z.enum(['planned', 'in_progress', 'done']).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damper/mcp",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "MCP server for Damper task management",
   "author": "Damper <hello@usedamper.com>",
   "repository": {