@vibescope/mcp-server 0.2.3 → 0.2.4

package/src/tools.ts

@@ -37,9 +37,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.',
@@ -63,6 +93,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',
@@ -87,19 +144,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.',
@@ -174,58 +219,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',
@@ -399,17 +395,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'],
@@ -434,8 +460,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: {
@@ -443,6 +537,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'],
@@ -450,15 +588,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'],
@@ -572,6 +720,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'],
@@ -589,6 +741,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
@@ -672,6 +829,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.`,
@@ -687,6 +858,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'],
 		},
@@ -722,6 +916,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.`,
@@ -732,6 +940,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'],
 		},
@@ -794,6 +1025,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.`,
@@ -811,7 +1056,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',
@@ -839,6 +1084,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).',
@@ -941,9 +1209,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: {
@@ -951,10 +1230,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'],
 		},
@@ -1054,7 +1333,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'],
@@ -1148,7 +1427,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',
@@ -1162,6 +1441,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'],
 		},
@@ -1174,7 +1461,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)`,
@@ -1185,6 +1474,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'],
 		},
@@ -1220,6 +1521,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.',
+				},
 			},
 		},
 	},
@@ -1514,6 +1819,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'],
 		},
@@ -1583,6 +1907,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'],
 		},
@@ -1751,6 +2083,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'],
 		},
@@ -1765,6 +2101,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'],
 		},
@@ -1782,6 +2126,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'],
 		},
@@ -2192,14 +2544,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.',
@@ -2262,20 +2607,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.',
@@ -2418,20 +2750,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',
@@ -2503,6 +2822,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'],
 		},
@@ -2543,6 +2866,21 @@ 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',
@@ -2636,6 +2974,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'],
 		},
@@ -2876,7 +3218,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',
@@ -2889,6 +3231,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'],
 		},
@@ -3009,6 +3359,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'],
 		},