@studiometa/productive-mcp 0.9.2 → 0.10.1

package/dist/tools.js

@@ -4,7 +4,18 @@ import { ACTIONS, REPORT_TYPES, RESOURCES } from "@studiometa/productive-core";
 * Adding a resource or action to constants.ts automatically updates this description.
 */
 function generateDescription() {
-	return `Productive.io API. Resources: ${RESOURCES.join(", ")}. Actions: ${ACTIONS.join(", ")} (varies by resource). Use query for text search on list actions. Reports: use resource=reports, action=get with report_type. Filters: project_id, person_id, service_id, company_id, after/before (dates). Use include to fetch related data. Use compact=false for full details (default for get, true for list). Use action=help with a resource for detailed documentation.`;
+	return [
+		"Productive.io API.",
+		`Resources: ${RESOURCES.join(", ")}.`,
+		`Actions: ${ACTIONS.join(", ")} (varies by resource).`,
+		"Discovery: action=help with any resource for filters, fields, examples. action=schema for compact machine-readable spec.",
+		"Filters: filter:{key:value}. Common: project_id, person_id, after/before (YYYY-MM-DD).",
+		"Includes: include:[...] for related data (e.g. [\"project\",\"assignee\"]).",
+		"Output: compact=false for full detail (default for get; list defaults true).",
+		"Search: query for text search on list actions. Cross-resource: resource=search action=run with query searches projects, companies, people, tasks simultaneously.",
+		"Reports: resource=reports action=get with report_type, from, to.",
+		"Batch: resource=batch action=run with operations=[{resource,action,...}] executes up to 10 ops in parallel."
+	].join("\n");
 }
 /**
 * Single consolidated tool for Productive.io MCP server
@@ -41,7 +52,7 @@ const TOOLS = [{
 			action: {
 				type: "string",
 				enum: [...ACTIONS],
-				description: "Action to perform. Use \"help\" for detailed documentation on a resource."
+				description: "Use \"help\" for resource documentation"
 			},
 			id: { type: "string" },
 			filter: { type: "object" },
@@ -54,11 +65,16 @@ const TOOLS = [{
 			include: {
 				type: "array",
 				items: { type: "string" },
-				description: "Related resources to include (e.g., [\"project\", \"assignee\", \"comments\"])"
+				description: "Related data to include (e.g. [\"project\",\"assignee\"])"
 			},
 			query: {
 				type: "string",
-				description: "Text search query for list actions (searches name/title fields)"
+				description: "Text search for list actions"
+			},
+			resources: {
+				type: "array",
+				items: { type: "string" },
+				description: "Resource types to search (for resource=search). Defaults to [projects, companies, people, tasks]. Valid values: projects, companies, people, tasks, deals."
 			},
 			person_id: { type: "string" },
 			service_id: { type: "string" },
@@ -75,30 +91,62 @@ const TOOLS = [{
 			name: { type: "string" },
 			page_id: {
 				type: "string",
-				description: "Page ID. Find pages using resource=\"pages\" action=\"list\""
+				description: "Page ID (list pages to find)"
 			},
 			parent_page_id: {
 				type: "string",
-				description: "Parent page ID for creating sub-pages"
+				description: "Parent page ID for sub-pages"
+			},
+			body: {
+				type: "string",
+				description: "Comment/page body content"
 			},
-			body: { type: "string" },
 			deal_id: { type: "string" },
 			comment_id: {
 				type: "string",
-				description: "Comment ID for filtering attachments"
+				description: "Comment ID (for attachments)"
 			},
 			time_entry_id: { type: "string" },
-			started_on: { type: "string" },
-			ended_on: { type: "string" },
+			started_on: {
+				type: "string",
+				description: "Booking date (YYYY-MM-DD)"
+			},
+			ended_on: {
+				type: "string",
+				description: "Booking end date (YYYY-MM-DD)"
+			},
 			event_id: { type: "string" },
 			report_type: {
 				type: "string",
-				enum: [...REPORT_TYPES]
+				enum: [...REPORT_TYPES],
+				description: "Required for resource=reports action=get"
+			},
+			group: {
+				type: "string",
+				description: "Report grouping: person, project, service"
+			},
+			from: {
+				type: "string",
+				description: "Report start (YYYY-MM-DD); filter.after for time"
+			},
+			to: {
+				type: "string",
+				description: "Report end (YYYY-MM-DD); filter.before for time"
 			},
-			group: { type: "string" },
-			from: { type: "string" },
-			to: { type: "string" },
-			status: { type: "string" }
+			status: { type: "string" },
+			operations: {
+				type: "array",
+				items: {
+					type: "object",
+					properties: {
+						resource: { type: "string" },
+						action: { type: "string" }
+					},
+					required: ["resource", "action"]
+				},
+				maxItems: 10,
+				description: "Array of operations for batch execution (max 10). Each operation needs resource, action, and any additional params."
+			}
 		},
 		required: ["resource", "action"]
 	}

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","names":[],"sources":["../src/tools.ts"],"sourcesContent":["import type { Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { RESOURCES, ACTIONS, REPORT_TYPES } from '@studiometa/productive-core';\n\n/**\n * Generate the tool description dynamically from the constants.\n * Adding a resource or action to constants.ts automatically updates this description.\n */\nfunction generateDescription(): string {\n  return (\n    `Productive.io API. Resources: ${RESOURCES.join(', ')}. ` +\n    `Actions: ${ACTIONS.join(', ')} (varies by resource). ` +\n    'Use query for text search on list actions. ' +\n    'Reports: use resource=reports, action=get with report_type. ' +\n    'Filters: project_id, person_id, service_id, company_id, after/before (dates). ' +\n    'Use include to fetch related data. ' +\n    'Use compact=false for full details (default for get, true for list). ' +\n    'Use action=help with a resource for detailed documentation.'\n  );\n}\n\n/**\n * Single consolidated tool for Productive.io MCP server\n *\n * The resource/action/report_type enums and description are derived from\n * the shared constants in constants.ts — the single source of truth for both\n * the MCP tool definition and the Zod validation schemas.\n * Adding a new resource, action, or report type there automatically updates\n * both the tool exposed to clients and the validation layer.\n *\n * MCP Annotations (for MCP directory compliance):\n * - readOnlyHint: false - Tool can create/update data\n * - destructiveHint: false - Tool does not permanently delete data\n * - idempotentHint: false - Create actions are not idempotent\n * - openWorldHint: true - Tool interacts with external Productive.io API\n */\nexport const TOOLS: Tool[] = [\n  {\n    name: 'productive',\n    description: generateDescription(),\n    annotations: {\n      title: 'Productive.io',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: true,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        resource: {\n          type: 'string',\n          enum: [...RESOURCES],\n        },\n        action: {\n          type: 'string',\n          enum: [...ACTIONS],\n          description: 'Action to perform. Use \"help\" for detailed documentation on a resource.',\n        },\n        id: { type: 'string' },\n        filter: { type: 'object' },\n        page: { type: 'number' },\n        per_page: { type: 'number' },\n        compact: {\n          type: 'boolean',\n          description: 'Compact output (default: true for list, false for get)',\n        },\n        include: {\n          type: 'array',\n          items: { type: 'string' },\n          description: 'Related resources to include (e.g., [\"project\", \"assignee\", \"comments\"])',\n        },\n        query: {\n          type: 'string',\n          description: 'Text search query for list actions (searches name/title fields)',\n        },\n        // Common fields\n        person_id: { type: 'string' },\n        service_id: { type: 'string' },\n        task_id: { type: 'string' },\n        company_id: { type: 'string' },\n        time: { type: 'number' },\n        date: { type: 'string' },\n        note: { type: 'string' },\n        // Task fields\n        title: { type: 'string' },\n        project_id: { type: 'string' },\n        task_list_id: { type: 'string' },\n        description: { type: 'string' },\n        assignee_id: { type: 'string' },\n        // Company fields\n        name: { type: 'string' },\n        // Page fields\n        page_id: {\n          type: 'string',\n          description: 'Page ID. Find pages using resource=\"pages\" action=\"list\"',\n        },\n        parent_page_id: { type: 'string', description: 'Parent page ID for creating sub-pages' },\n        // Comment fields\n        body: { type: 'string' },\n        deal_id: { type: 'string' },\n        // Attachment fields\n        comment_id: { type: 'string', description: 'Comment ID for filtering attachments' },\n        // Timer fields\n        time_entry_id: { type: 'string' },\n        // Booking fields\n        started_on: { type: 'string' },\n        ended_on: { type: 'string' },\n        event_id: { type: 'string' },\n        // Report fields\n        report_type: {\n          type: 'string',\n          enum: [...REPORT_TYPES],\n        },\n        group: { type: 'string' },\n        from: { type: 'string' },\n        to: { type: 'string' },\n        status: { type: 'string' },\n      },\n      required: ['resource', 'action'],\n    },\n  },\n];\n\n/**\n * Additional tools only available in stdio mode (local execution)\n * These tools manage persistent configuration\n */\nexport const STDIO_ONLY_TOOLS: Tool[] = [\n  {\n    name: 'productive_configure',\n    description: 'Configure Productive.io credentials',\n    annotations: {\n      title: 'Configure Productive',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        organizationId: { type: 'string' },\n        apiToken: { type: 'string' },\n        userId: { type: 'string' },\n      },\n      required: ['organizationId', 'apiToken'],\n    },\n  },\n  {\n    name: 'productive_get_config',\n    description: 'Get current configuration',\n    annotations: {\n      title: 'Get Productive Config',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n];\n"],"mappings":";;;;;AAQA,SAAS,sBAA8B;AACrC,QACE,iCAAiC,UAAU,KAAK,KAAK,CAAC,aAC1C,QAAQ,KAAK,KAAK,CAAC;;;;;;;;;;;;;;;;;AAyBnC,MAAa,QAAgB,CAC3B;CACE,MAAM;CACN,aAAa,qBAAqB;CAClC,aAAa;EACX,OAAO;EACP,cAAc;EACd,iBAAiB;EACjB,gBAAgB;EAChB,eAAe;EAChB;CACD,aAAa;EACX,MAAM;EACN,YAAY;GACV,UAAU;IACR,MAAM;IACN,MAAM,CAAC,GAAG,UAAU;IACrB;GACD,QAAQ;IACN,MAAM;IACN,MAAM,CAAC,GAAG,QAAQ;IAClB,aAAa;IACd;GACD,IAAI,EAAE,MAAM,UAAU;GACtB,QAAQ,EAAE,MAAM,UAAU;GAC1B,MAAM,EAAE,MAAM,UAAU;GACxB,UAAU,EAAE,MAAM,UAAU;GAC5B,SAAS;IACP,MAAM;IACN,aAAa;IACd;GACD,SAAS;IACP,MAAM;IACN,OAAO,EAAE,MAAM,UAAU;IACzB,aAAa;IACd;GACD,OAAO;IACL,MAAM;IACN,aAAa;IACd;GAED,WAAW,EAAE,MAAM,UAAU;GAC7B,YAAY,EAAE,MAAM,UAAU;GAC9B,SAAS,EAAE,MAAM,UAAU;GAC3B,YAAY,EAAE,MAAM,UAAU;GAC9B,MAAM,EAAE,MAAM,UAAU;GACxB,MAAM,EAAE,MAAM,UAAU;GACxB,MAAM,EAAE,MAAM,UAAU;GAExB,OAAO,EAAE,MAAM,UAAU;GACzB,YAAY,EAAE,MAAM,UAAU;GAC9B,cAAc,EAAE,MAAM,UAAU;GAChC,aAAa,EAAE,MAAM,UAAU;GAC/B,aAAa,EAAE,MAAM,UAAU;GAE/B,MAAM,EAAE,MAAM,UAAU;GAExB,SAAS;IACP,MAAM;IACN,aAAa;IACd;GACD,gBAAgB;IAAE,MAAM;IAAU,aAAa;IAAyC;GAExF,MAAM,EAAE,MAAM,UAAU;GACxB,SAAS,EAAE,MAAM,UAAU;GAE3B,YAAY;IAAE,MAAM;IAAU,aAAa;IAAwC;GAEnF,eAAe,EAAE,MAAM,UAAU;GAEjC,YAAY,EAAE,MAAM,UAAU;GAC9B,UAAU,EAAE,MAAM,UAAU;GAC5B,UAAU,EAAE,MAAM,UAAU;GAE5B,aAAa;IACX,MAAM;IACN,MAAM,CAAC,GAAG,aAAa;IACxB;GACD,OAAO,EAAE,MAAM,UAAU;GACzB,MAAM,EAAE,MAAM,UAAU;GACxB,IAAI,EAAE,MAAM,UAAU;GACtB,QAAQ,EAAE,MAAM,UAAU;GAC3B;EACD,UAAU,CAAC,YAAY,SAAS;EACjC;CACF,CACF;;;;;AAMD,MAAa,mBAA2B,CACtC;CACE,MAAM;CACN,aAAa;CACb,aAAa;EACX,OAAO;EACP,cAAc;EACd,iBAAiB;EACjB,gBAAgB;EAChB,eAAe;EAChB;CACD,aAAa;EACX,MAAM;EACN,YAAY;GACV,gBAAgB,EAAE,MAAM,UAAU;GAClC,UAAU,EAAE,MAAM,UAAU;GAC5B,QAAQ,EAAE,MAAM,UAAU;GAC3B;EACD,UAAU,CAAC,kBAAkB,WAAW;EACzC;CACF,EACD;CACE,MAAM;CACN,aAAa;CACb,aAAa;EACX,OAAO;EACP,cAAc;EACd,iBAAiB;EACjB,gBAAgB;EAChB,eAAe;EAChB;CACD,aAAa;EACX,MAAM;EACN,YAAY,EAAE;EACf;CACF,CACF"}
+{"version":3,"file":"tools.js","names":[],"sources":["../src/tools.ts"],"sourcesContent":["import type { Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { RESOURCES, ACTIONS, REPORT_TYPES } from '@studiometa/productive-core';\n\n/**\n * Generate the tool description dynamically from the constants.\n * Adding a resource or action to constants.ts automatically updates this description.\n */\nfunction generateDescription(): string {\n  return [\n    'Productive.io API.',\n    `Resources: ${RESOURCES.join(', ')}.`,\n    `Actions: ${ACTIONS.join(', ')} (varies by resource).`,\n    'Discovery: action=help with any resource for filters, fields, examples. action=schema for compact machine-readable spec.',\n    'Filters: filter:{key:value}. Common: project_id, person_id, after/before (YYYY-MM-DD).',\n    'Includes: include:[...] for related data (e.g. [\"project\",\"assignee\"]).',\n    'Output: compact=false for full detail (default for get; list defaults true).',\n    'Search: query for text search on list actions. Cross-resource: resource=search action=run with query searches projects, companies, people, tasks simultaneously.',\n    'Reports: resource=reports action=get with report_type, from, to.',\n    'Batch: resource=batch action=run with operations=[{resource,action,...}] executes up to 10 ops in parallel.',\n  ].join('\\n');\n}\n\n/**\n * Single consolidated tool for Productive.io MCP server\n *\n * The resource/action/report_type enums and description are derived from\n * the shared constants in constants.ts — the single source of truth for both\n * the MCP tool definition and the Zod validation schemas.\n * Adding a new resource, action, or report type there automatically updates\n * both the tool exposed to clients and the validation layer.\n *\n * MCP Annotations (for MCP directory compliance):\n * - readOnlyHint: false - Tool can create/update data\n * - destructiveHint: false - Tool does not permanently delete data\n * - idempotentHint: false - Create actions are not idempotent\n * - openWorldHint: true - Tool interacts with external Productive.io API\n */\nexport const TOOLS: Tool[] = [\n  {\n    name: 'productive',\n    description: generateDescription(),\n    annotations: {\n      title: 'Productive.io',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: true,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        resource: {\n          type: 'string',\n          enum: [...RESOURCES],\n        },\n        action: {\n          type: 'string',\n          enum: [...ACTIONS],\n          description: 'Use \"help\" for resource documentation',\n        },\n        id: { type: 'string' },\n        filter: { type: 'object' },\n        page: { type: 'number' },\n        per_page: { type: 'number' },\n        compact: {\n          type: 'boolean',\n          description: 'Compact output (default: true for list, false for get)',\n        },\n        include: {\n          type: 'array',\n          items: { type: 'string' },\n          description: 'Related data to include (e.g. [\"project\",\"assignee\"])',\n        },\n        query: { type: 'string', description: 'Text search for list actions' },\n        resources: {\n          type: 'array',\n          items: { type: 'string' },\n          description:\n            'Resource types to search (for resource=search). Defaults to [projects, companies, people, tasks]. Valid values: projects, companies, people, tasks, deals.',\n        },\n        // Common fields\n        person_id: { type: 'string' },\n        service_id: { type: 'string' },\n        task_id: { type: 'string' },\n        company_id: { type: 'string' },\n        time: { type: 'number' },\n        date: { type: 'string' },\n        note: { type: 'string' },\n        // Task fields\n        title: { type: 'string' },\n        project_id: { type: 'string' },\n        task_list_id: { type: 'string' },\n        description: { type: 'string' },\n        assignee_id: { type: 'string' },\n        // Company fields\n        name: { type: 'string' },\n        // Page fields\n        page_id: { type: 'string', description: 'Page ID (list pages to find)' },\n        parent_page_id: { type: 'string', description: 'Parent page ID for sub-pages' },\n        // Comment fields\n        body: { type: 'string', description: 'Comment/page body content' },\n        deal_id: { type: 'string' },\n        // Attachment fields\n        comment_id: { type: 'string', description: 'Comment ID (for attachments)' },\n        // Timer fields\n        time_entry_id: { type: 'string' },\n        // Booking fields\n        started_on: { type: 'string', description: 'Booking date (YYYY-MM-DD)' },\n        ended_on: { type: 'string', description: 'Booking end date (YYYY-MM-DD)' },\n        event_id: { type: 'string' },\n        // Report fields\n        report_type: {\n          type: 'string',\n          enum: [...REPORT_TYPES],\n          description: 'Required for resource=reports action=get',\n        },\n        group: { type: 'string', description: 'Report grouping: person, project, service' },\n        from: { type: 'string', description: 'Report start (YYYY-MM-DD); filter.after for time' },\n        to: { type: 'string', description: 'Report end (YYYY-MM-DD); filter.before for time' },\n        status: { type: 'string' },\n        // Batch fields\n        operations: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              resource: { type: 'string' },\n              action: { type: 'string' },\n            },\n            required: ['resource', 'action'],\n          },\n          maxItems: 10,\n          description:\n            'Array of operations for batch execution (max 10). Each operation needs resource, action, and any additional params.',\n        },\n      },\n      required: ['resource', 'action'],\n    },\n  },\n];\n\n/**\n * Additional tools only available in stdio mode (local execution)\n * These tools manage persistent configuration\n */\nexport const STDIO_ONLY_TOOLS: Tool[] = [\n  {\n    name: 'productive_configure',\n    description: 'Configure Productive.io credentials',\n    annotations: {\n      title: 'Configure Productive',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        organizationId: { type: 'string' },\n        apiToken: { type: 'string' },\n        userId: { type: 'string' },\n      },\n      required: ['organizationId', 'apiToken'],\n    },\n  },\n  {\n    name: 'productive_get_config',\n    description: 'Get current configuration',\n    annotations: {\n      title: 'Get Productive Config',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n];\n"],"mappings":"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"}

package/dist/{version-IB2ulmSy.js → version-DoRPyhTL.js}

@@ -23,7 +23,7 @@ function loadInstructions() {
 	}
 }
 const INSTRUCTIONS = loadInstructions();
-const VERSION = "0.9.2";
+const VERSION = "0.10.1";
 export { INSTRUCTIONS as n, VERSION as t };
 
-//# sourceMappingURL=version-IB2ulmSy.js.map
+//# sourceMappingURL=version-DoRPyhTL.js.map

package/dist/{version-IB2ulmSy.js.map → version-DoRPyhTL.js.map}

@@ -1 +1 @@
-{"version":3,"file":"version-IB2ulmSy.js","names":[],"sources":["../src/instructions.ts","../src/version.ts"],"sourcesContent":["/**\n * MCP Server Instructions\n *\n * These instructions are sent to Claude Desktop during initialization\n * and used as context/hints for the LLM. This ensures the AI agent\n * knows how to properly use the Productive.io MCP server.\n *\n * The content is derived from skills/SKILL.md (without YAML frontmatter).\n */\n\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * Load instructions from SKILL.md file\n * Removes YAML frontmatter (content between --- markers)\n */\nfunction loadInstructions(): string {\n  try {\n    // In dist/, go up to package root, then to skills/\n    const skillPath = join(__dirname, '..', 'skills', 'SKILL.md');\n    const content = readFileSync(skillPath, 'utf-8');\n\n    // Remove YAML frontmatter (between --- markers at start of file)\n    const withoutFrontmatter = content.replace(/^---\\n[\\s\\S]*?\\n---\\n+/, '');\n\n    return withoutFrontmatter.trim();\n  } catch {\n    // Fallback if file not found (shouldn't happen in production)\n    return 'Productive.io MCP Server - Use the productive tool with resource and action parameters.';\n  }\n}\n\nexport const INSTRUCTIONS = loadInstructions();\n","/**\n * Package version - injected from package.json at build time\n */\ndeclare const __VERSION__: string;\nexport const VERSION = __VERSION__;\n"],"mappings":";;;;;;;;;;;;AAcA,IAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;;;;;AAMzD,SAAS,mBAA2B;AAClC,KAAI;AAQF,SALgB,aADE,KAAK,WAAW,MAAM,UAAU,WAAW,EACrB,QAAQ,CAGb,QAAQ,0BAA0B,GAAG,CAE9C,MAAM;SAC1B;AAEN,SAAO;;;AAIX,MAAa,eAAe,kBAAkB;AChC9C,MAAa,UAAA"}
+{"version":3,"file":"version-DoRPyhTL.js","names":[],"sources":["../src/instructions.ts","../src/version.ts"],"sourcesContent":["/**\n * MCP Server Instructions\n *\n * These instructions are sent to Claude Desktop during initialization\n * and used as context/hints for the LLM. This ensures the AI agent\n * knows how to properly use the Productive.io MCP server.\n *\n * The content is derived from skills/SKILL.md (without YAML frontmatter).\n */\n\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * Load instructions from SKILL.md file\n * Removes YAML frontmatter (content between --- markers)\n */\nfunction loadInstructions(): string {\n  try {\n    // In dist/, go up to package root, then to skills/\n    const skillPath = join(__dirname, '..', 'skills', 'SKILL.md');\n    const content = readFileSync(skillPath, 'utf-8');\n\n    // Remove YAML frontmatter (between --- markers at start of file)\n    const withoutFrontmatter = content.replace(/^---\\n[\\s\\S]*?\\n---\\n+/, '');\n\n    return withoutFrontmatter.trim();\n  } catch {\n    // Fallback if file not found (shouldn't happen in production)\n    return 'Productive.io MCP Server - Use the productive tool with resource and action parameters.';\n  }\n}\n\nexport const INSTRUCTIONS = loadInstructions();\n","/**\n * Package version - injected from package.json at build time\n */\ndeclare const __VERSION__: string;\nexport const VERSION = __VERSION__;\n"],"mappings":";;;;;;;;;;;;AAcA,IAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;;;;;AAMzD,SAAS,mBAA2B;AAClC,KAAI;AAQF,SALgB,aADE,KAAK,WAAW,MAAM,UAAU,WAAW,EACrB,QAAQ,CAGb,QAAQ,0BAA0B,GAAG,CAE9C,MAAM;SAC1B;AAEN,SAAO;;;AAIX,MAAa,eAAe,kBAAkB;AChC9C,MAAa,UAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiometa/productive-mcp",
-  "version": "0.9.2",
+  "version": "0.10.1",
   "description": "MCP server for Productive.io API - Model Context Protocol integration for Claude Desktop",
   "keywords": [
     "ai",
@@ -87,8 +87,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@studiometa/productive-api": "0.9.2",
-    "@studiometa/productive-core": "0.9.2",
+    "@studiometa/productive-api": "0.10.1",
+    "@studiometa/productive-core": "0.10.1",
     "h3": "^1.15.1",
     "zod": "4.3.6"
   },

package/skills/SKILL.md

@@ -7,6 +7,10 @@ description: MCP server for Productive.io - use with Claude Desktop or MCP-compa
 
 MCP (Model Context Protocol) server for Productive.io. Provides a single unified tool for all operations.
 
+## Quick Start
+
+Before your first interaction with any resource, call `action=help` with that resource to discover valid filters, required fields, includes, and examples.
+
 ## The `productive` Tool
 
 Single unified tool with this signature:
@@ -17,36 +21,35 @@ productive(resource, action, [parameters...])
 
 ### Resources & Actions
 
-| Resource      | Actions                                                                  | Description             |
-| ------------- | ------------------------------------------------------------------------ | ----------------------- |
-| `projects`    | `list`, `get`, `resolve`, `help`                                         | Project management      |
-| `time`        | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Time tracking           |
-| `tasks`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Task management         |
-| `services`    | `list`, `get`, `resolve`, `help`                                         | Budget line items       |
-| `people`      | `list`, `get`, `me`, `resolve`, `help`                                   | Team members            |
-| `companies`   | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Client companies        |
-| `comments`    | `list`, `get`, `create`, `update`, `help`                                | Comments on tasks/deals |
-| `attachments` | `list`, `get`, `delete`, `help`                                          | File attachments        |
-| `timers`      | `list`, `get`, `start`, `stop`, `help`                                   | Active timers           |
-| `deals`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Sales deals             |
-| `bookings`    | `list`, `get`, `create`, `update`, `help`                                | Resource scheduling     |
-| `budgets`     | `list`, `get`, `help`                                                    | Budget tracking         |
-| `reports`     | `get`, `help`                                                            | Generate reports        |
-| Resource      | Actions                                                                  | Description             |
-| ------------- | ------------------------------------------------------------------------ | ----------------------- |
-| `projects`    | `list`, `get`, `resolve`, `help`                                         | Project management      |
-| `time`        | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Time tracking           |
-| `tasks`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Task management         |
-| `services`    | `list`, `get`, `resolve`, `help`                                         | Budget line items       |
-| `people`      | `list`, `get`, `me`, `resolve`, `help`                                   | Team members            |
-| `companies`   | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Client companies        |
-| `comments`    | `list`, `get`, `create`, `update`, `help`                                | Comments on tasks/deals |
-| `timers`      | `list`, `get`, `start`, `stop`, `help`                                   | Active timers           |
-| `deals`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Sales deals             |
-| `bookings`    | `list`, `get`, `create`, `update`, `help`                                | Resource scheduling     |
-| `pages`       | `list`, `get`, `create`, `update`, `delete`, `help`                      | Wiki/docs pages         |
-| `discussions` | `list`, `get`, `create`, `update`, `delete`, `resolve`, `reopen`, `help` | Discussions on pages    |
-| `reports`     | `get`, `help`                                                            | Generate reports        |
+| Resource      | Actions                                                                  | Description                                              |
+| ------------- | ------------------------------------------------------------------------ | -------------------------------------------------------- |
+| `projects`    | `list`, `get`, `resolve`, `help`                                         | Project management                                       |
+| `time`        | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Time tracking                                            |
+| `tasks`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Task management                                          |
+| `services`    | `list`, `get`, `resolve`, `help`                                         | Budget line items                                        |
+| `people`      | `list`, `get`, `me`, `resolve`, `help`                                   | Team members                                             |
+| `companies`   | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Client companies                                         |
+| `comments`    | `list`, `get`, `create`, `update`, `help`                                | Comments on tasks/deals                                  |
+| `attachments` | `list`, `get`, `delete`, `help`                                          | File attachments                                         |
+| `timers`      | `list`, `get`, `start`, `stop`, `help`                                   | Active timers                                            |
+| `deals`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Sales deals & budgets (use `filter[type]=2` for budgets) |
+| `bookings`    | `list`, `get`, `create`, `update`, `help`                                | Resource scheduling                                      |
+| `reports`     | `get`, `help`                                                            | Generate reports                                         |
+| Resource      | Actions                                                                  | Description                                              |
+| ------------- | ------------------------------------------------------------------------ | -----------------------                                  |
+| `projects`    | `list`, `get`, `resolve`, `help`                                         | Project management                                       |
+| `time`        | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Time tracking                                            |
+| `tasks`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Task management                                          |
+| `services`    | `list`, `get`, `resolve`, `help`                                         | Budget line items                                        |
+| `people`      | `list`, `get`, `me`, `resolve`, `help`                                   | Team members                                             |
+| `companies`   | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Client companies                                         |
+| `comments`    | `list`, `get`, `create`, `update`, `help`                                | Comments on tasks/deals                                  |
+| `timers`      | `list`, `get`, `start`, `stop`, `help`                                   | Active timers                                            |
+| `deals`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Sales deals & budgets                                    |
+| `bookings`    | `list`, `get`, `create`, `update`, `help`                                | Resource scheduling                                      |
+| `pages`       | `list`, `get`, `create`, `update`, `delete`, `help`                      | Wiki/docs pages                                          |
+| `discussions` | `list`, `get`, `create`, `update`, `delete`, `resolve`, `reopen`, `help` | Discussions on pages                                     |
+| `reports`     | `get`, `help`                                                            | Generate reports                                         |
 
 ### Getting Help
 
@@ -302,22 +305,6 @@ Response:
 { "resource": "timers", "action": "stop", "id": "67890" }
 ```
 
-### Budgets
-
-```json
-// List all budgets
-{ "resource": "budgets", "action": "list" }
-
-// List budgets for a project
-{ "resource": "budgets", "action": "list", "filter": { "project_id": "12345" } }
-
-// Get budget details
-{ "resource": "budgets", "action": "get", "id": "67890" }
-
-// List billable budgets
-{ "resource": "budgets", "action": "list", "filter": { "billable": "true" } }
-```
-
 ### Reports
 
 ```json
@@ -465,6 +452,8 @@ Response:
 - `type` - Type: `1`=deal, `2`=budget
 - `budget_status` - Budget status: `1`=open, `2`=closed
 
+> **Note:** Budgets are deals with `budget=true`. There is no separate `/budgets` endpoint. Use `filter[type]=2` to list only budgets.
+
 ### Bookings
 
 - `person_id` - Filter by person
@@ -476,14 +465,6 @@ Response:
 - `booking_type` - Type: `event` (absence) or `service` (budget)
 - `draft` - Tentative status: `true`/`false`
 
-### Budgets
-
-- `project_id` - Filter by project
-- `company_id` - Filter by company
-- `deal_id` - Filter by deal
-- `billable` - Filter by billable status: `true`/`false`
-- `budget_type` - Filter by budget type
-
 ### Pages
 
 - `project_id` - Filter by project

package/dist/handlers/budgets.d.ts

@@ -1,9 +0,0 @@
-/**
- * Budgets MCP handler.
- *
- * Thin adapter that delegates business logic to core executors
- * and handles MCP-specific concerns (hints, error formatting, JSON results).
- */
-import type { CommonArgs, HandlerContext, ToolResult } from './types.js';
-export declare function handleBudgets(action: string, args: CommonArgs, ctx: HandlerContext): Promise<ToolResult>;
-//# sourceMappingURL=budgets.d.ts.map

package/dist/handlers/budgets.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../src/handlers/budgets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AASzE,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,UAAU,CAAC,CAiCrB"}