@limeadelabs/launchpad-mcp 1.2.0 → 1.2.2

package/dist/index.js

@@ -184,7 +184,7 @@ function registerProjectTools(server2, client2) {
     "lp_get_project",
     "Get project details including agent_instructions",
     {
-      project_id: z.number().describe("Project ID")
+      project_id: z.coerce.number().describe("Project ID")
     },
     async (params) => {
       try {
@@ -204,11 +204,11 @@ function registerTaskTools(server2, client2) {
     "lp_list_tasks",
     "List tasks from LaunchPad with optional filters (project, status, priority, label, assignee)",
     {
-      project_id: z2.number().optional().describe("Filter by project ID"),
+      project_id: z2.coerce.number().optional().describe("Filter by project ID"),
       status: z2.string().optional().describe("Filter by status: todo, ready, in_progress, review, done"),
       priority: z2.string().optional().describe("Filter by priority: low, medium, high"),
       label: z2.string().optional().describe("Filter by label name"),
-      assignee_id: z2.number().optional().describe("Filter by assignee user ID")
+      assignee_id: z2.coerce.number().optional().describe("Filter by assignee user ID")
     },
     async (params) => {
       try {
@@ -223,7 +223,7 @@ function registerTaskTools(server2, client2) {
     "lp_get_task",
     "Get full task context \u2014 description, comments, links, specs",
     {
-      task_id: z2.number().describe("Task ID")
+      task_id: z2.coerce.number().describe("Task ID")
     },
     async (params) => {
       try {
@@ -238,7 +238,7 @@ function registerTaskTools(server2, client2) {
     "lp_create_task",
     "Create a new task in LaunchPad",
     {
-      project_id: z2.number().describe("Project ID to create the task in"),
+      project_id: z2.coerce.number().describe("Project ID to create the task in"),
       title: z2.string().describe("Task title"),
       description: z2.string().optional().describe("Task description"),
       status: z2.string().optional().describe("Initial status: todo, ready, in_progress, review, done"),
@@ -257,10 +257,10 @@ function registerTaskTools(server2, client2) {
     "lp_update_task",
     "Update task status and/or fields. LaunchPad enforces workflow transitions \u2014 use lp_get_workflow to check valid transitions before changing status.",
     {
-      task_id: z2.number().describe("Task ID"),
+      task_id: z2.coerce.number().describe("Task ID"),
       status: z2.string().optional().describe("New status (must be a valid workflow transition)"),
       priority: z2.string().optional().describe("New priority: low, medium, high"),
-      assignee_id: z2.number().optional().describe("Assignee user ID"),
+      assignee_id: z2.coerce.number().optional().describe("Assignee user ID"),
       title: z2.string().optional().describe("New title"),
       description: z2.string().optional().describe("New description")
     },
@@ -283,7 +283,7 @@ function registerClaimTools(server2, client2) {
     "lp_claim_task",
     "Claim a task before working on it. Prevents other agents from picking it up.",
     {
-      task_id: z3.number().describe("Task ID to claim")
+      task_id: z3.coerce.number().describe("Task ID to claim")
     },
     async (params) => {
       try {
@@ -298,7 +298,7 @@ function registerClaimTools(server2, client2) {
     "lp_release_task",
     "Release a claimed task so others can pick it up",
     {
-      task_id: z3.number().describe("Task ID to release")
+      task_id: z3.coerce.number().describe("Task ID to release")
     },
     async (params) => {
       try {
@@ -313,7 +313,7 @@ function registerClaimTools(server2, client2) {
     "lp_heartbeat",
     "Send a heartbeat for a claimed task to keep the claim alive. Claims expire after 30 minutes without a heartbeat.",
     {
-      task_id: z3.number().describe("Task ID to heartbeat")
+      task_id: z3.coerce.number().describe("Task ID to heartbeat")
     },
     async (params) => {
       try {
@@ -333,7 +333,7 @@ function registerCommentTools(server2, client2) {
     "lp_add_comment",
     "Post a comment on a task (progress updates, notes, questions)",
     {
-      task_id: z4.number().describe("Task ID to comment on"),
+      task_id: z4.coerce.number().describe("Task ID to comment on"),
       body: z4.string().describe("Comment body text")
     },
     async (params) => {
@@ -354,8 +354,8 @@ function registerTimeTools(server2, client2) {
     "lp_log_time",
     "Track time spent on a task",
     {
-      task_id: z5.number().describe("Task ID"),
-      duration_minutes: z5.number().positive().describe("Duration in minutes"),
+      task_id: z5.coerce.number().describe("Task ID"),
+      duration_minutes: z5.coerce.number().positive().describe("Duration in minutes"),
       description: z5.string().optional().describe("Description of work done")
     },
     async (params) => {
@@ -376,7 +376,7 @@ function registerPromptTools(server2, client2) {
     "lp_generate_prompt",
     "Generate a build-ready prompt/spec for a task with full context, conventions, and acceptance criteria",
     {
-      task_id: z6.number().describe("Task ID")
+      task_id: z6.coerce.number().describe("Task ID")
     },
     async (params) => {
       try {
@@ -394,14 +394,16 @@ import { z as z7 } from "zod";
 function registerPageTools(server2, client2) {
   server2.tool(
     "lp_list_pages",
-    "List spec/doc pages for a project",
+    "List spec/doc pages for a project (titles and IDs only \u2014 use lp_get_page to fetch full content)",
     {
-      project_id: z7.number().describe("Project ID")
+      project_id: z7.coerce.number().describe("Project ID")
     },
     async (params) => {
       try {
         const result = await client2.listPages(params.project_id);
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        const pages = result.pages ?? result;
+        const summary = Array.isArray(pages) ? pages.map(({ id, title, author, created_at, updated_at }) => ({ id, title, author, created_at, updated_at })) : pages;
+        return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
       } catch (error) {
         return handleError(error, client2.timeoutMs);
       }
@@ -409,14 +411,17 @@ function registerPageTools(server2, client2) {
   );
   server2.tool(
     "lp_get_page",
-    "Get a page's full content",
+    "Get a page's full content by project_id and page_id (also accepts id as alias for page_id)",
     {
-      project_id: z7.number().describe("Project ID"),
-      page_id: z7.number().describe("Page ID")
+      project_id: z7.coerce.number().describe("Project ID"),
+      page_id: z7.coerce.number().optional().describe("Page ID"),
+      id: z7.coerce.number().optional().describe("Page ID (alias for page_id)")
     },
     async (params) => {
       try {
-        const result = await client2.getPage(params.project_id, params.page_id);
+        const pageId = params.page_id ?? params.id;
+        if (!pageId) throw new Error("page_id or id is required");
+        const result = await client2.getPage(params.project_id, pageId);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
       } catch (error) {
         return handleError(error, client2.timeoutMs);
@@ -427,7 +432,7 @@ function registerPageTools(server2, client2) {
     "lp_get_workflow",
     "Get valid workflow states and transitions for a project",
     {
-      project_id: z7.number().describe("Project ID")
+      project_id: z7.coerce.number().describe("Project ID")
     },
     async (params) => {
       try {
@@ -447,11 +452,11 @@ function registerContextTools(server2, client2) {
     "lp_context_list",
     "List available context entries with optional filters",
     {
-      project_id: z8.number().optional().describe("Filter by project ID"),
+      project_id: z8.coerce.number().optional().describe("Filter by project ID"),
       entry_type: z8.string().optional().describe("Filter by entry type"),
       search: z8.string().optional().describe("Text search on entry name"),
-      limit: z8.number().min(1).max(100).optional().describe("Max entries to return (default 50)"),
-      offset: z8.number().min(0).optional().describe("Offset for pagination")
+      limit: z8.coerce.number().min(1).max(100).optional().describe("Max entries to return (default 50)"),
+      offset: z8.coerce.number().min(0).optional().describe("Offset for pagination")
     },
     async (params) => {
       try {
@@ -467,7 +472,7 @@ function registerContextTools(server2, client2) {
     "Fetch a specific context entry by slug or ID",
     {
       slug: z8.string().optional().describe("Entry slug"),
-      id: z8.number().optional().describe("Entry ID")
+      id: z8.coerce.number().optional().describe("Entry ID")
     },
     async (params) => {
       const identifier = params.slug || (params.id !== void 0 ? String(params.id) : void 0);
@@ -489,7 +494,7 @@ function registerContextTools(server2, client2) {
     "lp_context_package",
     "Get the assembled context package for a task \u2014 task details, context entries, specs, pages, comments",
     {
-      task_id: z8.number().describe("Task ID")
+      task_id: z8.coerce.number().describe("Task ID")
     },
     async (params) => {
       try {
@@ -505,7 +510,7 @@ function registerContextTools(server2, client2) {
     "Update a context entry's content (requires write access)",
     {
       slug: z8.string().optional().describe("Entry slug"),
-      id: z8.number().optional().describe("Entry ID"),
+      id: z8.coerce.number().optional().describe("Entry ID"),
       content: z8.string().describe("New markdown content"),
       change_summary: z8.string().describe("What changed and why")
     },
@@ -563,7 +568,7 @@ function registerSessionTools(server2, client2) {
     "lp_session_start",
     "Start a new agent session for a task. Creates session via API and saves session_id to disk for later lookup.",
     {
-      task_id: z9.number().describe("LaunchPad task ID"),
+      task_id: z9.coerce.number().describe("LaunchPad task ID"),
       agent_type: z9.string().optional().describe("Agent type (default: claude_code)")
     },
     async ({ task_id, agent_type }) => {
@@ -582,8 +587,8 @@ function registerSessionTools(server2, client2) {
     "lp_session_heartbeat",
     "Send a heartbeat for an active session. Provide session_id directly or task_id to look up session from disk. Graceful no-op if neither provided.",
     {
-      session_id: z9.number().optional().describe("Session ID"),
-      task_id: z9.number().optional().describe("Task ID to look up session from disk")
+      session_id: z9.coerce.number().optional().describe("Session ID"),
+      task_id: z9.coerce.number().optional().describe("Task ID to look up session from disk")
     },
     async ({ session_id, task_id }) => {
       try {
@@ -606,7 +611,7 @@ function registerSessionTools(server2, client2) {
     "lp_session_progress",
     'Report progress on an active session. Sends an activity update with action "progress".',
     {
-      session_id: z9.number().describe("Session ID"),
+      session_id: z9.coerce.number().describe("Session ID"),
       detail: z9.string().describe("Description of progress made")
     },
     async ({ session_id, detail }) => {
@@ -626,7 +631,7 @@ function registerSessionTools(server2, client2) {
     "lp_session_event",
     "Log a discrete event for a session (commit, ci_pass, ci_fail, pr_opened, blocker, cost_update).",
     {
-      session_id: z9.number().describe("Session ID"),
+      session_id: z9.coerce.number().describe("Session ID"),
       event_type: z9.enum(["commit", "ci_pass", "ci_fail", "pr_opened", "blocker", "cost_update"]).describe("Type of event"),
       payload: z9.record(z9.unknown()).describe("Event payload data")
     },
@@ -645,7 +650,7 @@ function registerSessionTools(server2, client2) {
     "lp_session_blocked",
     'Mark a session as blocked. Updates status to "blocked" and logs a blocker event.',
     {
-      session_id: z9.number().describe("Session ID"),
+      session_id: z9.coerce.number().describe("Session ID"),
       reason: z9.string().describe("Reason the session is blocked")
     },
     async ({ session_id, reason }) => {
@@ -669,9 +674,9 @@ function registerSessionTools(server2, client2) {
     "lp_session_complete",
     "Mark a session as completed with a result summary. Clears session from disk.",
     {
-      session_id: z9.number().describe("Session ID"),
+      session_id: z9.coerce.number().describe("Session ID"),
       result_summary: z9.string().describe("Summary of what was accomplished"),
-      task_id: z9.number().optional().describe("Task ID to clear from disk (if not provided, derived from session)")
+      task_id: z9.coerce.number().optional().describe("Task ID to clear from disk (if not provided, derived from session)")
     },
     async ({ session_id, result_summary, task_id }) => {
       try {
@@ -693,9 +698,9 @@ function registerSessionTools(server2, client2) {
     "lp_session_fail",
     "Mark a session as failed with an error detail. Clears session from disk.",
     {
-      session_id: z9.number().describe("Session ID"),
+      session_id: z9.coerce.number().describe("Session ID"),
       error_detail: z9.string().describe("Description of the failure"),
-      task_id: z9.number().optional().describe("Task ID to clear from disk (if not provided, derived from session)")
+      task_id: z9.coerce.number().optional().describe("Task ID to clear from disk (if not provided, derived from session)")
     },
     async ({ session_id, error_detail, task_id }) => {
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limeadelabs/launchpad-mcp",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "LaunchPad MCP server for Claude Code — AI-native project management integration",
   "type": "module",
   "exports": {
@@ -29,7 +29,13 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "keywords": ["mcp", "launchpad", "claude", "project-management", "ai-agents"],
+  "keywords": [
+    "mcp",
+    "launchpad",
+    "claude",
+    "project-management",
+    "ai-agents"
+  ],
   "license": "MIT",
   "publishConfig": {
     "access": "public"