@vibescope/mcp-server 0.2.2 → 0.2.4

package/dist/tools.js

@@ -34,9 +34,39 @@ Use mode:'full' for complete context, mode:'lite' (default) for minimal tokens.`
                     enum: ['developer', 'validator', 'deployer', 'reviewer', 'maintainer'],
                     description: 'Agent role: developer (general work, default), validator (task validation), deployer (deployments), reviewer (code review), maintainer (housekeeping)',
                 },
+                hostname: {
+                    type: 'string',
+                    description: 'Machine hostname for worktree tracking. Pass os.hostname() to filter stale worktrees to only those created on this machine.',
+                },
+                agent_type: {
+                    type: 'string',
+                    enum: ['claude', 'gemini', 'cursor', 'windsurf', 'other'],
+                    description: 'Agent type for onboarding. When a new agent type connects to an existing project, setup instructions are returned.',
+                },
             },
         },
     },
+    {
+        name: 'confirm_agent_setup',
+        description: `Confirm that agent setup is complete for this project. Call this after creating your agent's configuration file (e.g., .claude/CLAUDE.md, .gemini/GEMINI.md).
+
+This marks your agent type as fully onboarded to the project, so you won't receive setup instructions again.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                agent_type: {
+                    type: 'string',
+                    enum: ['claude', 'gemini', 'cursor', 'windsurf', 'other'],
+                    description: 'Agent type that completed setup',
+                },
+            },
+            required: ['project_id', 'agent_type'],
+        },
+    },
     {
         name: 'get_help',
         description: 'Get guidance on a specific topic. Use when unsure about workflows.',
@@ -60,6 +90,33 @@ Use mode:'full' for complete context, mode:'lite' (default) for minimal tokens.`
             properties: {},
         },
     },
+    {
+        name: 'report_token_usage',
+        description: `Report actual Claude API token usage for accurate cost tracking.
+
+IMPORTANT: MCP can only estimate tokens from tool I/O (~1-5% of actual usage). Call this tool after each API response to report actual usage from the Claude API response headers.
+
+The Claude API response includes 'usage.input_tokens' and 'usage.output_tokens' - pass those values here for accurate cost attribution.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                input_tokens: {
+                    type: 'number',
+                    description: 'Input tokens from Claude API response (usage.input_tokens)',
+                },
+                output_tokens: {
+                    type: 'number',
+                    description: 'Output tokens from Claude API response (usage.output_tokens)',
+                },
+                model: {
+                    type: 'string',
+                    enum: ['opus', 'sonnet', 'haiku'],
+                    description: 'Model used for this API call (optional, uses session model if not provided)',
+                },
+            },
+            required: ['input_tokens', 'output_tokens'],
+        },
+    },
     // Cost monitoring tools
     {
         name: 'get_cost_summary',
@@ -84,19 +141,7 @@ Use mode:'full' for complete context, mode:'lite' (default) for minimal tokens.`
             required: ['project_id'],
         },
     },
-    {
-        name: 'get_cost_alerts',
-        description: 'Get cost alerts for the current user.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Filter by project (optional)',
-                },
-            },
-        },
-    },
+    // REMOVED: get_cost_alerts - unbounded collection, use dashboard to view alerts
     {
         name: 'add_cost_alert',
         description: 'Add a cost alert threshold.',
@@ -171,58 +216,9 @@ Use mode:'full' for complete context, mode:'lite' (default) for minimal tokens.`
             required: ['alert_id'],
         },
     },
-    {
-        name: 'get_task_costs',
-        description: 'Get cost breakdown by task for a project.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max tasks to return (default: 20)',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
-    {
-        name: 'get_body_of_work_costs',
-        description: 'Get cost breakdown by body of work with phase-level details. Returns costs for pre/core/post phases and model breakdown.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                body_of_work_id: {
-                    type: 'string',
-                    description: 'Body of work UUID (optional if project_id provided)',
-                },
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID to get all body of work costs (optional if body_of_work_id provided)',
-                },
-            },
-        },
-    },
-    {
-        name: 'get_sprint_costs',
-        description: 'Get cost breakdown by sprint with velocity metrics. Returns cost per story point and phase breakdown.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sprint_id: {
-                    type: 'string',
-                    description: 'Sprint UUID (optional if project_id provided)',
-                },
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID to get all sprint costs (optional if sprint_id provided)',
-                },
-            },
-        },
-    },
+    // REMOVED: get_task_costs - unbounded collection, use get_cost_summary for aggregated data
+    // REMOVED: get_body_of_work_costs - unbounded collection, use get_cost_summary for aggregated data
+    // REMOVED: get_sprint_costs - unbounded collection, use get_cost_summary for aggregated data
     // Knowledge Base Query Tool
     {
         name: 'query_knowledge_base',
@@ -396,17 +392,47 @@ Use mode:'full' for complete context, mode:'lite' (default) for minimal tokens.`
                     type: 'boolean',
                     description: 'Automatically tag deployments on main branch',
                 },
-                git_auto_commit_on_complete: {
+                deployment_instructions: {
+                    type: 'string',
+                    description: 'Instructions for how to deploy (e.g., "Push to main for Vercel auto-deploy", "Run fly deploy")',
+                },
+                // Git and validation settings
+                git_delete_branch_on_merge: {
                     type: 'boolean',
-                    description: 'Agents must commit changes after completing tasks',
+                    description: 'Delete feature branch after PR merge (default: true)',
                 },
-                git_auto_pr_on_complete: {
+                require_pr_for_validation: {
                     type: 'boolean',
-                    description: 'Agents must create PR after completing tasks',
+                    description: 'Require PR exists before task validation can be approved (default: true for github-flow/git-flow)',
                 },
-                deployment_instructions: {
-                    type: 'string',
-                    description: 'Instructions for how to deploy (e.g., "Push to main for Vercel auto-deploy", "Run fly deploy")',
+                auto_merge_on_approval: {
+                    type: 'boolean',
+                    description: 'Automatically merge PR when validator approves (default: true)',
+                },
+                validation_required: {
+                    type: 'boolean',
+                    description: 'Completed tasks require validation before being considered done (default: true)',
+                },
+                // Task default settings
+                default_task_priority: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 5,
+                    description: 'Default priority for new tasks when not specified (1=highest, 5=lowest, default: 3)',
+                },
+                require_time_estimates: {
+                    type: 'boolean',
+                    description: 'Require estimated_minutes when creating tasks (default: false)',
+                },
+                // Agent behavior settings
+                fallback_activities_enabled: {
+                    type: 'boolean',
+                    description: 'Allow agents to perform background activities when no tasks available (default: true)',
+                },
+                preferred_fallback_activities: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of preferred fallback activities (e.g., ["code_review", "security_review"]). Null means all allowed.',
                 },
             },
             required: ['project_id'],
@@ -431,8 +457,76 @@ Use mode:'full' for complete context, mode:'lite' (default) for minimal tokens.`
         },
     },
     {
-        name: 'get_tasks',
-        description: 'Get tasks for a project, optionally filtered by status. By default returns only root tasks (not subtasks).',
+        name: 'get_project_summary',
+        description: 'Get a unified project overview with aggregated stats. Token-efficient way to get task counts, blockers, findings, active agents, and more in a single call.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    // Targeted task endpoints (token-efficient)
+    {
+        name: 'get_task',
+        description: `Get a single task by ID with optional subtasks and milestones.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task_id: {
+                    type: 'string',
+                    description: 'Task UUID',
+                },
+                include_subtasks: {
+                    type: 'boolean',
+                    description: 'Include subtasks array (default: false)',
+                },
+                include_milestones: {
+                    type: 'boolean',
+                    description: 'Include milestones array (default: false)',
+                },
+            },
+            required: ['task_id'],
+        },
+    },
+    {
+        name: 'search_tasks',
+        description: `Search tasks by text query. Supports pagination with offset. Use for finding specific tasks by title or description.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                query: {
+                    type: 'string',
+                    description: 'Search query (min 2 chars). Searches title and description.',
+                },
+                status: {
+                    type: 'array',
+                    items: { type: 'string', enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'] },
+                    description: 'Filter by status (optional, array)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max results per page (1-20, default: 10)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of results to skip for pagination (default: 0)',
+                },
+            },
+            required: ['project_id', 'query'],
+        },
+    },
+    {
+        name: 'get_tasks_by_priority',
+        description: `Get tasks filtered by priority. Supports pagination with offset. Use for finding high-priority or low-priority tasks.`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -440,6 +534,50 @@ Use mode:'full' for complete context, mode:'lite' (default) for minimal tokens.`
                     type: 'string',
                     description: 'Project UUID',
                 },
+                priority: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 5,
+                    description: 'Exact priority to match (1=highest, 5=lowest)',
+                },
+                priority_max: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 5,
+                    description: 'Max priority (for range, e.g., priority=1, priority_max=2 gets P1 and P2)',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'],
+                    description: 'Filter by status (default: pending)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max results per page (1-20, default: 10)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of results to skip for pagination (default: 0)',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'get_recent_tasks',
+        description: `Get tasks ordered by creation date. Supports pagination with offset. Use to find oldest pending tasks or newest additions.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                order: {
+                    type: 'string',
+                    enum: ['newest', 'oldest'],
+                    description: 'Sort order (default: newest)',
+                },
                 status: {
                     type: 'string',
                     enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'],
@@ -447,15 +585,25 @@ Use mode:'full' for complete context, mode:'lite' (default) for minimal tokens.`
                 },
                 limit: {
                     type: 'number',
-                    description: 'Max number of tasks to return (default 50)',
+                    description: 'Max results per page (1-20, default: 10)',
                 },
-                include_subtasks: {
-                    type: 'boolean',
-                    description: 'Include subtasks in results (default false). Use get_subtasks for subtasks of a specific task.',
+                offset: {
+                    type: 'number',
+                    description: 'Number of results to skip for pagination (default: 0)',
                 },
-                include_metadata: {
-                    type: 'boolean',
-                    description: 'When true, returns all task fields (description, progress, timestamps, etc.). When false (default), returns only id/title/priority/status to save tokens.',
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'get_task_stats',
+        description: `Get aggregate task statistics for a project. Returns counts by status and priority, no task data. Most token-efficient way to understand project state.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
                 },
             },
             required: ['project_id'],
@@ -569,6 +717,10 @@ For projects without git branching (trunk-based or none), use skip_worktree_requ
                     type: 'string',
                     description: 'Git worktree path for this task (e.g., "../project-task-abc123"). Store this for cleanup tracking across sessions.',
                 },
+                worktree_hostname: {
+                    type: 'string',
+                    description: 'Machine hostname where worktree was created (os.hostname()). Required with worktree_path to enable machine-aware cleanup.',
+                },
                 model_capability: {
                     type: 'string',
                     enum: ['haiku', 'sonnet', 'opus'],
@@ -586,6 +738,11 @@ For projects without git branching (trunk-based or none), use skip_worktree_requ
         name: 'complete_task',
         description: `Mark task done. Returns next_task which you MUST start immediately without asking the user.
 
+CRITICAL: Before calling complete_task on branching workflows (github-flow, git-flow):
+1. Create your PR targeting the correct branch (develop for git-flow, main for github-flow)
+2. Call add_task_reference(task_id, pr_url) to link the PR to your task
+3. THEN call complete_task - validators CANNOT approve tasks without a PR reference
+
 CRITICAL: After calling this tool, you must:
 1. If next_task is returned → Start it immediately by calling update_task(task_id, status: "in_progress")
 2. If no next_task → Call get_next_task() or start a fallback_activity
@@ -669,6 +826,20 @@ The auto_continue: true flag in the response means you are expected to continue
             required: ['blocker_id'],
         },
     },
+    {
+        name: 'get_blocker',
+        description: `Get a single blocker by ID. More token-efficient than get_blockers when you need details for a specific blocker.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                blocker_id: {
+                    type: 'string',
+                    description: 'Blocker UUID',
+                },
+            },
+            required: ['blocker_id'],
+        },
+    },
     {
         name: 'get_blockers',
         description: `Get blockers for a project, optionally filtered by status.`,
@@ -684,6 +855,29 @@ The auto_continue: true flag in the response means you are expected to continue
                     enum: ['open', 'resolved'],
                     description: 'Filter by status (default: open)',
                 },
+                limit: {
+                    type: 'number',
+                    description: 'Max number of blockers to return (default 10, max 200)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of blockers to skip for pagination (default 0)',
+                },
+                search_query: {
+                    type: 'string',
+                    description: 'Search blockers by description',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'get_blockers_stats',
+        description: `Get aggregate statistics about blockers for a project. Returns total count and breakdown by status. Much more token-efficient than get_blockers when you just need to understand the overall state.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: { type: 'string', description: 'Project UUID' },
             },
             required: ['project_id'],
         },
@@ -719,6 +913,20 @@ The auto_continue: true flag in the response means you are expected to continue
             required: ['project_id', 'title', 'description'],
         },
     },
+    {
+        name: 'get_decision',
+        description: `Get a single decision by ID. More token-efficient than get_decisions when you need details for a specific decision.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                decision_id: {
+                    type: 'string',
+                    description: 'Decision UUID',
+                },
+            },
+            required: ['decision_id'],
+        },
+    },
     {
         name: 'get_decisions',
         description: `Get recorded decisions for a project.`,
@@ -729,6 +937,29 @@ The auto_continue: true flag in the response means you are expected to continue
                     type: 'string',
                     description: 'Project UUID',
                 },
+                limit: {
+                    type: 'number',
+                    description: 'Max number of decisions to return (default 10, max 200)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of decisions to skip for pagination (default 0)',
+                },
+                search_query: {
+                    type: 'string',
+                    description: 'Search decisions by title',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'get_decisions_stats',
+        description: `Get aggregate statistics about decisions for a project. Returns total count. More token-efficient than get_decisions when you just need to know how many decisions exist.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: { type: 'string', description: 'Project UUID' },
             },
             required: ['project_id'],
         },
@@ -791,6 +1022,20 @@ The auto_continue: true flag in the response means you are expected to continue
             required: ['idea_id'],
         },
     },
+    {
+        name: 'get_idea',
+        description: `Get a single idea by ID. More token-efficient than get_ideas when you need details for a specific idea.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                idea_id: {
+                    type: 'string',
+                    description: 'Idea UUID',
+                },
+            },
+            required: ['idea_id'],
+        },
+    },
     {
         name: 'get_ideas',
         description: `Get recorded ideas for a project, optionally filtered by status.`,
@@ -808,7 +1053,7 @@ The auto_continue: true flag in the response means you are expected to continue
                 },
                 limit: {
                     type: 'number',
-                    description: 'Max number of ideas to return (default 50, max 100)',
+                    description: 'Max number of ideas to return (default 10, max 100)',
                 },
                 offset: {
                     type: 'number',
@@ -836,6 +1081,29 @@ The auto_continue: true flag in the response means you are expected to continue
             required: ['task_id'],
         },
     },
+    {
+        name: 'cancel_task',
+        description: `Cancel a task with an optional reason. Use this when a task should be marked as cancelled rather than deleted (e.g., PR was closed, work was superseded). The task remains visible with a cancelled status for historical tracking.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task_id: {
+                    type: 'string',
+                    description: 'Task UUID',
+                },
+                cancelled_reason: {
+                    type: 'string',
+                    description: 'Reason for cancellation',
+                    enum: ['pr_closed', 'superseded', 'user_cancelled', 'validation_failed', 'obsolete', 'blocked'],
+                },
+                cancellation_note: {
+                    type: 'string',
+                    description: 'Optional note explaining the cancellation (logged to progress)',
+                },
+            },
+            required: ['task_id'],
+        },
+    },
     {
         name: 'add_task_reference',
         description: 'Add a reference URL to a task (docs, PRs, issues).',
@@ -938,9 +1206,20 @@ The auto_continue: true flag in the response means you are expected to continue
             required: ['project_id', 'title'],
         },
     },
+    {
+        name: 'get_finding',
+        description: `Get a single finding by ID. More token-efficient than get_findings when you need details for a specific finding.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                finding_id: { type: 'string', description: 'Finding UUID' },
+            },
+            required: ['finding_id'],
+        },
+    },
     {
         name: 'get_findings',
-        description: `Get findings for a project, optionally filtered by category, severity, or status. Use summary_only=true to reduce token usage by returning only essential fields (id, title, category, severity, status). For just counts, use get_findings_stats instead.`,
+        description: `Get findings for a project, optionally filtered by category, severity, or status. Returns summary fields by default (id, title, category, severity, status). Set summary_only=false for full details. For just counts, use get_findings_stats instead.`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -948,10 +1227,10 @@ The auto_continue: true flag in the response means you are expected to continue
                 category: { type: 'string', enum: ['performance', 'security', 'code_quality', 'accessibility', 'documentation', 'architecture', 'testing', 'other'], description: 'Filter by category (optional)' },
                 severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Filter by severity (optional)' },
                 status: { type: 'string', enum: ['open', 'addressed', 'dismissed', 'wontfix'], description: 'Filter by status (default: open)' },
-                limit: { type: 'number', description: 'Max number of findings to return (default 50, max 200)' },
+                limit: { type: 'number', description: 'Max number of findings to return (default 10, max 200)' },
                 offset: { type: 'number', description: 'Number of findings to skip for pagination (default 0)' },
                 search_query: { type: 'string', description: 'Search findings by title' },
-                summary_only: { type: 'boolean', description: 'When true, returns only id, title, category, severity, status (reduces tokens by ~80%). Default: false' },
+                summary_only: { type: 'boolean', description: 'When true (default), returns only id, title, category, severity, status. Set to false for full details.' },
             },
             required: ['project_id'],
         },
@@ -1051,7 +1330,7 @@ The auto_continue: true flag in the response means you are expected to continue
                 },
                 limit: {
                     type: 'number',
-                    description: 'Max number of items to return (default 50, max 200)',
+                    description: 'Max number of items to return (default 10, max 200)',
                 },
             },
             required: ['project_id'],
@@ -1145,7 +1424,7 @@ Max depth is 1 (subtasks cannot have their own subtasks).`,
     },
     {
         name: 'get_subtasks',
-        description: `Get subtasks for a parent task.
+        description: `Get subtasks for a parent task with pagination.
 Returns subtasks with aggregate completion stats.`,
         inputSchema: {
             type: 'object',
@@ -1159,6 +1438,14 @@ Returns subtasks with aggregate completion stats.`,
                     enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'],
                     description: 'Filter by status (optional)',
                 },
+                limit: {
+                    type: 'number',
+                    description: 'Max subtasks to return (default: 20, max: 50)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of subtasks to skip (default: 0)',
+                },
             },
             required: ['parent_task_id'],
         },
@@ -1171,7 +1458,9 @@ Returns tasks with worktree_path set where:
 - Task is completed or cancelled (worktree should have been cleaned up)
 - Task has been abandoned (no activity for 24+ hours while in_progress)
 
-IMPORTANT: Call this on session start to clean up orphaned worktrees from previous sessions.
+IMPORTANT: Pass hostname (os.hostname()) to only see worktrees created on THIS machine.
+Worktrees created on other machines cannot be removed locally.
+
 For each stale worktree:
 1. Run: git worktree remove <worktree_path>
 2. Call: clear_worktree_path(task_id)`,
@@ -1182,6 +1471,18 @@ For each stale worktree:
                     type: 'string',
                     description: 'Project UUID',
                 },
+                hostname: {
+                    type: 'string',
+                    description: 'Machine hostname (os.hostname()). Only returns worktrees created on this machine, preventing attempts to clean up worktrees on other machines.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max worktrees to return (default: 50)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of worktrees to skip for pagination (default: 0)',
+                },
             },
             required: ['project_id'],
         },
@@ -1217,6 +1518,10 @@ This marks the task as cleaned up so it won't appear in get_stale_worktrees.`,
                     type: ['string', 'null'],
                     description: 'Report your current git worktree path (e.g., "../project-task-abc123"). Set to null to clear.',
                 },
+                hostname: {
+                    type: 'string',
+                    description: 'Machine hostname (os.hostname()). Updates session hostname for worktree tracking.',
+                },
             },
         },
     },
@@ -1511,6 +1816,25 @@ This marks the task as cleaned up so it won't appear in get_stale_worktrees.`,
                     description: 'Filter by stage (optional)',
                     enum: ['preparation', 'deployment', 'verification', 'all'],
                 },
+                limit: {
+                    type: 'number',
+                    description: 'Max number of requirements to return (default 50, max 200)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of requirements to skip for pagination (default 0)',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'get_deployment_requirements_stats',
+        description: `Get aggregate statistics about deployment requirements for a project. Returns total count and breakdowns by status, stage, and type. More token-efficient than get_deployment_requirements when you just need to understand the overall state.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: { type: 'string', description: 'Project UUID' },
             },
             required: ['project_id'],
         },
@@ -1580,6 +1904,14 @@ This marks the task as cleaned up so it won't appear in get_stale_worktrees.`,
                     type: 'boolean',
                     description: 'Include disabled schedules (default: false)',
                 },
+                limit: {
+                    type: 'number',
+                    description: 'Max schedules to return (default: 50)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of schedules to skip for pagination (default: 0)',
+                },
             },
             required: ['project_id'],
         },
@@ -1748,6 +2080,10 @@ This marks the task as cleaned up so it won't appear in get_stale_worktrees.`,
                     type: 'number',
                     description: 'Max number of history entries to return (default 50)',
                 },
+                offset: {
+                    type: 'number',
+                    description: 'Number of entries to skip for pagination (default 0)',
+                },
             },
             required: ['project_id'],
         },
@@ -1762,6 +2098,14 @@ This marks the task as cleaned up so it won't appear in get_stale_worktrees.`,
                     type: 'string',
                     description: 'Project UUID',
                 },
+                limit: {
+                    type: 'number',
+                    description: 'Max schedules to return (default: 50)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of schedules to skip for pagination (default: 0)',
+                },
             },
             required: ['project_id'],
         },
@@ -1779,6 +2123,14 @@ This marks the task as cleaned up so it won't appear in get_stale_worktrees.`,
                     type: 'string',
                     description: 'Project UUID',
                 },
+                limit: {
+                    type: 'number',
+                    description: 'Max number of requests to return (default 50, max 200)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of requests to skip for pagination (default 0)',
+                },
             },
             required: ['project_id'],
         },
@@ -2189,14 +2541,7 @@ Only returns tasks where all dependencies are completed.`,
     // ============================================================================
     // Organization Tools
     // ============================================================================
-    {
-        name: 'list_organizations',
-        description: 'List organizations the current user belongs to.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
+    // REMOVED: list_organizations - unbounded collection, use dashboard to view organizations
     {
         name: 'create_organization',
         description: 'Create a new organization. You become the owner.',
@@ -2259,20 +2604,7 @@ Only returns tasks where all dependencies are completed.`,
             required: ['organization_id'],
         },
     },
-    {
-        name: 'list_org_members',
-        description: 'List members of an organization.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                organization_id: {
-                    type: 'string',
-                    description: 'Organization UUID',
-                },
-            },
-            required: ['organization_id'],
-        },
-    },
+    // REMOVED: list_org_members - unbounded collection, use dashboard to view members
     {
         name: 'invite_member',
         description: 'Invite a user to an organization by email. Requires admin role.',
@@ -2415,20 +2747,7 @@ Only returns tasks where all dependencies are completed.`,
             required: ['project_id', 'organization_id'],
         },
     },
-    {
-        name: 'list_project_shares',
-        description: 'List all organizations a project is shared with.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project_id: {
-                    type: 'string',
-                    description: 'Project UUID',
-                },
-            },
-            required: ['project_id'],
-        },
-    },
+    // REMOVED: list_project_shares - unbounded collection, use dashboard to view shares
     // File checkout/checkin tools for multi-agent coordination
     {
         name: 'checkout_file',
@@ -2500,6 +2819,10 @@ Only returns tasks where all dependencies are completed.`,
                     type: 'number',
                     description: 'Max checkouts to return (default: 50)',
                 },
+                offset: {
+                    type: 'number',
+                    description: 'Number of checkouts to skip for pagination (default 0)',
+                },
             },
             required: ['project_id'],
         },
@@ -2540,6 +2863,20 @@ Only returns tasks where all dependencies are completed.`,
             required: ['project_id', 'file_path'],
         },
     },
+    {
+        name: 'get_file_checkouts_stats',
+        description: 'Get aggregate statistics about file checkouts for a project. Returns counts by status without the actual checkout data. This is much more token-efficient than get_file_checkouts for understanding the overall state.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
     // Role management tools
     {
         name: 'get_role_settings',
@@ -2633,6 +2970,10 @@ Only returns tasks where all dependencies are completed.`,
                     type: 'string',
                     description: 'Project UUID',
                 },
+                counts_only: {
+                    type: 'boolean',
+                    description: 'When true (default), returns only counts per role to save tokens. Set to false for full agent details.',
+                },
             },
             required: ['project_id'],
         },
@@ -2873,7 +3214,7 @@ Tasks can be added during 'planning' status. Story points contribute to committe
     },
     {
         name: 'get_sprint_backlog',
-        description: `Get tasks from backlog/pending that can be added to a sprint.
+        description: `Get tasks from backlog/pending that can be added to a sprint with pagination.
 Returns tasks not already assigned to any body of work or sprint.`,
         inputSchema: {
             type: 'object',
@@ -2886,6 +3227,14 @@ Returns tasks not already assigned to any body of work or sprint.`,
                     type: 'string',
                     description: 'Sprint UUID to exclude already-added tasks (optional)',
                 },
+                limit: {
+                    type: 'number',
+                    description: 'Max tasks to return (default: 20, max: 50)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of tasks to skip (default: 0)',
+                },
             },
             required: ['project_id'],
         },
@@ -3006,6 +3355,10 @@ Returns committed vs completed points and average velocity.`,
                     type: 'number',
                     description: 'Max issues to return (default: 50)',
                 },
+                offset: {
+                    type: 'number',
+                    description: 'Number of issues to skip for pagination (default 0)',
+                },
             },
             required: ['project_id'],
         },