@ourroadmaps/mcp 0.7.4 → 0.8.0

package/dist/index.js

@@ -102,6 +102,7 @@ var featureSchema = z4.object({
   organizationId: z4.string(),
   type: featureTypeSchema,
   name: z4.string(),
+  description: z4.string().nullable(),
   parentId: z4.string().uuid().nullable(),
   order: z4.number().int(),
   isExpanded: z4.boolean(),
@@ -460,9 +461,15 @@ class ApiClient {
     }
     return await response.json();
   }
-  async listRoadmaps() {
-    const response = await this.request("/v1/roadmaps");
-    return response.data;
+  async listRoadmaps(params) {
+    const searchParams = new URLSearchParams;
+    if (params?.limit)
+      searchParams.set("limit", String(params.limit));
+    if (params?.offset)
+      searchParams.set("offset", String(params.offset));
+    const query = searchParams.toString();
+    const path = query ? `/v1/roadmaps?${query}` : "/v1/roadmaps";
+    return await this.request(path);
   }
   async getRoadmap(id) {
     const response = await this.request(`/v1/roadmaps/${id}`);
@@ -528,11 +535,17 @@ class ApiClient {
       method: "DELETE"
     });
   }
-  async addFeatureOutcome(featureId, content) {
-    await this.request(`/v1/features/${featureId}/outcomes`, {
+  async saveFeatureOutcomes(featureId, outcomes) {
+    const response = await this.request(`/v1/features/${featureId}/outcomes`, {
       method: "POST",
-      body: JSON.stringify({ content })
+      body: JSON.stringify({
+        outcomes: outcomes.map((description, index) => ({
+          description,
+          order: index
+        }))
+      })
     });
+    return response.data;
   }
   async linkFeatureToRoadmap(featureId, roadmapId) {
     await this.request(`/v1/features/${featureId}/roadmap-items`, {
@@ -749,15 +762,20 @@ function registerSearchRoadmaps(server) {
     inputSchema: {
       query: z10.string().optional().describe("Search query to match against title or description"),
       status: roadmapStatusSchema.optional().describe("Filter by status"),
-      horizon: horizonSchema.optional().describe("Filter by planning horizon")
+      horizon: horizonSchema.optional().describe("Filter by planning horizon"),
+      limit: z10.number().int().min(1).max(100).optional().describe("Max items to return (default 10)"),
+      offset: z10.number().int().min(0).optional().describe("Number of items to skip (default 0)")
     }
   }, async ({
     query,
     status,
-    horizon
+    horizon,
+    limit,
+    offset
   }) => {
     const client2 = getApiClient();
-    let roadmaps = await client2.listRoadmaps();
+    const response = await client2.listRoadmaps({ limit, offset });
+    let roadmaps = response.items;
     if (query) {
       const q = query.toLowerCase();
       roadmaps = roadmaps.filter((r) => r.title.toLowerCase().includes(q));
@@ -772,15 +790,18 @@ function registerSearchRoadmaps(server) {
       content: [
         {
           type: "text",
-          text: JSON.stringify(roadmaps.map((r) => ({
-            id: r.id,
-            title: r.title,
-            status: r.status,
-            horizon: r.horizon,
-            value: r.value,
-            effort: r.effort,
-            order: r.order
-          })), null, 2)
+          text: JSON.stringify({
+            items: roadmaps.map((r) => ({
+              id: r.id,
+              title: r.title,
+              status: r.status,
+              horizon: r.horizon,
+              value: r.value,
+              effort: r.effort,
+              order: r.order
+            })),
+            pagination: response.pagination
+          }, null, 2)
         }
       ]
     };
@@ -947,28 +968,20 @@ function registerGetContext(server) {
 - Audiences: Who the product serves (stakeholders and user personas) with their preferences
 - Scenarios: User workflows and how they accomplish goals
 - Features: Capabilities and functionality areas organized hierarchically
-- Roadmap Summary: Count of items by status and horizon for planning overview
+- Roadmap Summary: Total count of roadmap items
 
 Use this as your FIRST call when starting work on a roadmap to understand the full context.`,
     inputSchema: {}
   }, async () => {
     const client2 = getApiClient();
-    const [strategy, products, audiences, scenarios, features, roadmaps] = await Promise.all([
+    const [strategy, products, audiences, scenarios, features, roadmapsResponse] = await Promise.all([
       client2.getStrategy(),
       client2.listProducts(),
       client2.listAudiences(),
       client2.listScenarios(),
       client2.listFeatures(),
-      client2.listRoadmaps()
+      client2.listRoadmaps({ limit: 1 })
     ]);
-    const statusCounts = {};
-    const horizonCounts = {};
-    for (const r of roadmaps) {
-      const status = r.status ?? "unknown";
-      const horizon = r.horizon ?? "unknown";
-      statusCounts[status] = (statusCounts[status] || 0) + 1;
-      horizonCounts[horizon] = (horizonCounts[horizon] || 0) + 1;
-    }
     return {
       content: [
         {
@@ -1006,9 +1019,7 @@ Use this as your FIRST call when starting work on a roadmap to understand the fu
               parentId: f.parentId
             })),
             roadmapSummary: {
-              total: roadmaps.length,
-              byStatus: statusCounts,
-              byHorizon: horizonCounts
+              total: roadmapsResponse.pagination.total
             }
           }, null, 2)
         }
@@ -1177,9 +1188,7 @@ function registerAddFeature(server) {
       parentId: parentId ?? null
     });
     if (outcomes && outcomes.length > 0) {
-      for (const outcome of outcomes) {
-        await client2.addFeatureOutcome(feature2.id, outcome);
-      }
+      await client2.saveFeatureOutcomes(feature2.id, outcomes);
     }
     if (linkToRoadmapId) {
       await client2.linkFeatureToRoadmap(feature2.id, linkToRoadmapId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ourroadmaps/mcp",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "description": "MCP server for OurRoadmaps - manage roadmaps, features, and ideas from Claude Code",
   "type": "module",
   "bin": {