@damper/mcp 0.6.2 → 0.8.0

package/dist/index.js

@@ -41,7 +41,7 @@ async function api(method, path, body) {
 // Server
 const server = new McpServer({
     name: 'damper',
-    version: '0.5.1',
+    version: '0.6.0',
 });
 // Output schemas
 const SubtaskProgressSchema = z.object({
@@ -60,6 +60,7 @@ const TaskSummarySchema = z.object({
     dueDate: z.string().nullable().optional(),
     feedbackCount: z.number(),
     hasImplementationPlan: z.boolean(),
+    publicUrl: z.string().nullable().optional(),
     subtaskProgress: SubtaskProgressSchema.optional(),
 });
 const SubtaskSchema = z.object({
@@ -87,6 +88,7 @@ const TaskDetailSchema = z.object({
     subtasks: z.array(SubtaskSchema).optional(),
     agentNotes: z.string().nullable().optional(),
     commits: z.array(CommitSchema).optional(),
+    publicUrl: z.string().nullable().optional(),
     feedback: z.array(z.object({
         id: z.string(),
         title: z.string(),
@@ -242,6 +244,12 @@ server.registerTool('get_task', {
         parts.push(`\n## Feedback (${t.feedback.length})`);
         t.feedback.forEach((f) => parts.push(`- ${f.title} (${f.voterCount} votes)`));
     }
+    if (t.publicUrl) {
+        parts.push(`\n🔗 Public URL: ${t.publicUrl}`);
+    }
+    else if (t.publicUrlNote) {
+        parts.push(`\n🔗 ${t.publicUrlNote}`);
+    }
     // Add workflow reminder for tasks not yet started
     if (t.status === 'planned') {
         parts.push('\n---');
@@ -1974,6 +1982,61 @@ server.registerTool('update_project_settings', {
         structuredContent: result,
     };
 });
+// ==================== Public Pages ====================
+server.registerTool('open_public_page', {
+    title: 'Open Public Page',
+    description: 'Get the public URL for a project page (roadmap, feedback, changelog, or a specific roadmap item). ' +
+        'Use this to share links with users or open pages in a browser.\n\n' +
+        '**IMPORTANT:** NEVER guess or construct public page URLs yourself. Always call this tool to get the correct URL.\n\n' +
+        '**Pages:** roadmap, feedback, changelog, roadmap_item\n' +
+        '**roadmap_item** requires `itemId` parameter.',
+    inputSchema: z.object({
+        page: z.enum(['roadmap', 'feedback', 'changelog', 'roadmap_item'])
+            .describe('Which public page to get the URL for'),
+        itemId: z.string().optional()
+            .describe('Roadmap item ID (required when page is "roadmap_item")'),
+    }),
+    outputSchema: z.object({
+        url: z.string(),
+        enabled: z.boolean(),
+        note: z.string().optional(),
+    }),
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async ({ page, itemId }) => {
+    if (page === 'roadmap_item' && !itemId) {
+        return {
+            content: [{ type: 'text', text: 'Error: itemId is required when page is "roadmap_item"' }],
+            isError: true,
+        };
+    }
+    const data = await api('GET', '/api/agent/project/public-urls');
+    let url;
+    let enabled;
+    if (page === 'roadmap_item') {
+        url = data.roadmapItemUrlTemplate.replace('{itemId}', itemId);
+        enabled = data.pages.roadmap.enabled;
+    }
+    else {
+        const pageData = data.pages[page];
+        url = pageData.url;
+        enabled = pageData.enabled;
+    }
+    const note = !enabled
+        ? `Note: This page is not currently enabled. The URL will work once the project owner enables it in settings.`
+        : undefined;
+    const parts = [url];
+    if (note)
+        parts.push(note);
+    return {
+        content: [{ type: 'text', text: parts.join('\n\n') }],
+        structuredContent: { url, enabled, ...(note ? { note } : {}) },
+    };
+});
 // Start
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

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