@studiometa/productive-mcp 0.10.1 → 0.10.3

package/dist/schema.d.ts

@@ -27,8 +27,11 @@ export declare const ResourceSchema: z.ZodEnum<{
     attachments: "attachments";
     discussions: "discussions";
     pages: "pages";
+    activities: "activities";
     batch: "batch";
+    workflows: "workflows";
     reports: "reports";
+    summaries: "summaries";
     search: "search";
 }>;
 /**
@@ -44,11 +47,18 @@ export declare const ActionSchema: z.ZodEnum<{
     delete: "delete";
     resolve: "resolve";
     stop: "stop";
+    context: "context";
     reopen: "reopen";
     run: "run";
     me: "me";
+    complete_task: "complete_task";
+    log_day: "log_day";
+    weekly_standup: "weekly_standup";
     help: "help";
     schema: "schema";
+    my_day: "my_day";
+    project_health: "project_health";
+    team_pulse: "team_pulse";
 }>;
 /**
  * Report types available in Productive.io
@@ -166,8 +176,11 @@ export declare const ProductiveToolInputSchema: z.ZodObject<{
         attachments: "attachments";
         discussions: "discussions";
         pages: "pages";
+        activities: "activities";
         batch: "batch";
+        workflows: "workflows";
         reports: "reports";
+        summaries: "summaries";
         search: "search";
     }>;
     action: z.ZodEnum<{
@@ -179,11 +192,18 @@ export declare const ProductiveToolInputSchema: z.ZodObject<{
         delete: "delete";
         resolve: "resolve";
         stop: "stop";
+        context: "context";
         reopen: "reopen";
         run: "run";
         me: "me";
+        complete_task: "complete_task";
+        log_day: "log_day";
+        weekly_standup: "weekly_standup";
         help: "help";
         schema: "schema";
+        my_day: "my_day";
+        project_health: "project_health";
+        team_pulse: "team_pulse";
     }>;
     id: z.ZodOptional<z.ZodString>;
     filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,CAAC,EAAoB,KAAK,kBAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAGlF,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAMhF;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;EAAoB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;EAAkB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAAuB,CAAC;AAMrD;;GAEG;AACH,eAAO,MAAM,OAAO,aAIgC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,aAKvB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,aAKxB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,aAGqD,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,WAAW,aAG+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc,aAGuD,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,WAAW,aAG+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,SAAS,aAIuC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAKiE,CAAC;AAE/F;;GAEG;AACH,eAAO,MAAM,SAAS,2BAKiC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,YAAY,2BAMsC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,YAAY,6BAKtB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,UAAU,aAMpB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,wCAKxB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,YAAY,6BAKtB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,YAAY,yBAItB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,SAAS,aAAkD,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,UAAU,aAIqB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,SAAS,aAGgB,CAAC;AAMvC;;GAEG;AACH,eAAO,MAAM,YAAY,uDAGsB,CAAC;AAMhD;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqFpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAErE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAAC,mBAAmB,CAAC,CAE7F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAOnF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,CAAC,EAAoB,KAAK,kBAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAGlF,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAMhF;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;EAAoB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAAkB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAAuB,CAAC;AAMrD;;GAEG;AACH,eAAO,MAAM,OAAO,aAIgC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,aAKvB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,aAKxB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,aAGqD,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,WAAW,aAG+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc,aAGuD,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,WAAW,aAG+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,SAAS,aAIuC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAKiE,CAAC;AAE/F;;GAEG;AACH,eAAO,MAAM,SAAS,2BAKiC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,YAAY,2BAMsC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,YAAY,6BAKtB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,UAAU,aAMpB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,wCAKxB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,YAAY,6BAKtB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,YAAY,yBAItB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,SAAS,aAAkD,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,UAAU,aAIqB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,SAAS,aAGgB,CAAC;AAMvC;;GAEG;AACH,eAAO,MAAM,YAAY,uDAGsB,CAAC;AAMhD;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqFpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAErE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAAC,mBAAmB,CAAC,CAE7F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAOnF"}

package/dist/server.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { t as VERSION } from "./version-DoRPyhTL.js";
-import "./handlers-DWowqxFA.js";
+import { t as VERSION } from "./version-BRTaTnUG.js";
+import "./handlers-CaOBYauF.js";
 import { createHttpApp } from "./http.js";
 import { toNodeListener } from "h3";
 import { createServer } from "node:http";

package/dist/stdio.js

@@ -1,4 +1,4 @@
-import { t as executeToolWithCredentials } from "./handlers-DWowqxFA.js";
+import { t as executeToolWithCredentials } from "./handlers-CaOBYauF.js";
 import "./handlers.js";
 import { STDIO_ONLY_TOOLS, TOOLS } from "./tools.js";
 import { getConfig, setConfig } from "@studiometa/productive-api";

package/dist/suggestions.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Proactive suggestion generators for MCP responses.
+ *
+ * Data-aware warnings and recommendations computed from response data.
+ * Different from `_hints` (which show related resources/actions):
+ * - `_hints` tell the agent *what to fetch next*
+ * - `_suggestions` tell the agent *what to pay attention to*
+ *
+ * Key design constraints:
+ * - No extra API calls — compute only from data already in the response.
+ * - Return `string[]` (human-readable messages).
+ * - Emoji prefixes: ⚠️ warnings, ℹ️ info, 📊 stats, ⏱️ timers.
+ */
+import type { JsonApiResource } from '@studiometa/productive-api';
+import type { MyDaySummaryResult } from '@studiometa/productive-core';
+/**
+ * Get suggestions for tasks.list response.
+ *
+ * - Warns about overdue tasks (due_date < today and not closed)
+ * - Informs about unassigned tasks
+ */
+export declare function getTaskListSuggestions(tasks: JsonApiResource[]): string[];
+/**
+ * Get suggestions for tasks.get response.
+ *
+ * - Warns if the single task is overdue (and by how many days)
+ * - Informs if no time has been logged (only when time_entries are included)
+ */
+export declare function getTaskGetSuggestions(task: JsonApiResource, included?: JsonApiResource[]): string[];
+/**
+ * Get suggestions for time.list response.
+ *
+ * - Shows total hours logged across all entries in the response.
+ * - If filtered by today, shows hours vs 8h target.
+ */
+export declare function getTimeListSuggestions(entries: JsonApiResource[], filter?: Record<string, string>): string[];
+/**
+ * Get suggestions for summaries.my_day response.
+ *
+ * - Warns if no time has been logged today.
+ * - Warns if a timer has been running for more than 2 hours.
+ */
+export declare function getMyDaySuggestions(data: MyDaySummaryResult): string[];
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAStE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAqCzE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,EACrB,QAAQ,CAAC,EAAE,eAAe,EAAE,GAC3B,MAAM,EAAE,CAkCV;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EAAE,EAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,EAAE,CAwBV;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAoBtE"}

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAuB/D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,EAAE,IAAI,EAsGvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAoClC,CAAC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAwB/D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,EAAE,IAAI,EAsGvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAoClC,CAAC"}

package/dist/tools.js

@@ -14,7 +14,8 @@ function generateDescription() {
 		"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."
+		"Batch: resource=batch action=run with operations=[{resource,action,...}] executes up to 10 ops in parallel.",
+		"Rich context: action=context on tasks/projects/deals for full context in one call."
 	].join("\n");
 }
 /**

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.',\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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"}
+{"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    'Rich context: action=context on tasks/projects/deals for full context in one call.',\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-DoRPyhTL.js → version-BRTaTnUG.js}

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

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"version-BRTaTnUG.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.10.1",
+  "version": "0.10.3",
   "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.10.1",
-    "@studiometa/productive-core": "0.10.1",
+    "@studiometa/productive-api": "0.10.3",
+    "@studiometa/productive-core": "0.10.3",
     "h3": "^1.15.1",
     "zod": "4.3.6"
   },

package/skills/SKILL.md

@@ -23,33 +23,22 @@ productive(resource, action, [parameters...])
 
 | Resource      | Actions                                                                  | Description                                              |
 | ------------- | ------------------------------------------------------------------------ | -------------------------------------------------------- |
-| `projects`    | `list`, `get`, `resolve`, `help`                                         | Project management                                       |
+| `projects`    | `list`, `get`, `resolve`, `context`, `help`                              | Project management                                       |
 | `time`        | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Time tracking                                            |
-| `tasks`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Task management                                          |
+| `tasks`       | `list`, `get`, `create`, `update`, `resolve`, `context`, `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                                    |
+| `deals`       | `list`, `get`, `create`, `update`, `resolve`, `context`, `help`          | Sales deals & budgets (use `filter[type]=2` for 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                                     |
+| `activities`  | `list`, `help`                                                           | Activity feed (audit log of create/update/delete events) |
 | `reports`     | `get`, `help`                                                            | Generate reports                                         |
+| `workflows`   | `complete_task`, `log_day`, `weekly_standup`, `help`                     | Compound workflows chaining multiple operations          |
 
 ### Getting Help
 
@@ -265,6 +254,13 @@ Response:
 ### Services
 
 ```json
+// List services for a deal (budget line items) — prefer this over project_id when you have a deal
+{
+  "resource": "services",
+  "action": "list",
+  "filter": { "deal_id": "12345" }
+}
+
 // List services for a project
 {
   "resource": "services",
@@ -385,6 +381,78 @@ Response:
 { "resource": "discussions", "action": "reopen", "id": "67890" }
 ```
 
+### Workflows
+
+Compound workflows that chain multiple operations into a single tool call.
+
+```json
+// Complete a task (marks closed, posts comment, stops timers)
+{
+  "resource": "workflows",
+  "action": "complete_task",
+  "task_id": "12345",
+  "comment": "All done! Tests passing.",
+  "stop_timer": true
+}
+
+// Complete a task without stopping timers
+{
+  "resource": "workflows",
+  "action": "complete_task",
+  "task_id": "12345",
+  "stop_timer": false
+}
+
+// Log a full day across multiple services (time in minutes)
+{
+  "resource": "workflows",
+  "action": "log_day",
+  "date": "2024-01-16",
+  "entries": [
+    { "project_id": "100", "service_id": "111", "duration_minutes": 240, "note": "Frontend development" },
+    { "project_id": "100", "service_id": "222", "duration_minutes": 120, "note": "Code review" },
+    { "project_id": "200", "service_id": "333", "duration_minutes": 60, "note": "Client meeting" }
+  ]
+}
+
+// Get weekly standup (this week)
+{ "resource": "workflows", "action": "weekly_standup" }
+
+// Get standup for a specific week (provide the Monday date)
+{
+  "resource": "workflows",
+  "action": "weekly_standup",
+  "week_start": "2024-01-15"
+}
+
+// Get standup for a specific person
+{
+  "resource": "workflows",
+  "action": "weekly_standup",
+  "person_id": "12345"
+}
+```
+
+#### complete_task returns
+
+- `task` — Updated task info (id, title, closed status)
+- `comment_posted` — Whether the comment was successfully posted
+- `comment_id` — ID of the created comment (if posted)
+- `timers_stopped` — Number of timers that were stopped
+- `errors` — Array of sub-step errors (partial results still returned)
+
+#### log_day returns
+
+- `entries` — Per-entry results with `success`, `time_entry` (on success), or `error` (on failure)
+- `succeeded` / `failed` — Counts of successful and failed entries
+- `total_minutes_logged` — Sum of minutes for successful entries
+
+#### weekly_standup returns
+
+- `completed_tasks` — Tasks closed this week with project names
+- `time_logged` — Total minutes and breakdown by project (sorted by most time first)
+- `upcoming_deadlines` — Open tasks due in the next 7 days with `days_until_due`
+
 ## Filters Reference
 
 ### Time Entries
@@ -523,6 +591,28 @@ Force full details on list:
 
 When fetching a single resource with `action: "get"`, the response includes a `_hints` field with suggestions for related resources and common actions. This helps discover how to fetch additional context.
 
+## Proactive Suggestions
+
+Certain responses include a `_suggestions` field with data-aware warnings and recommendations. Unlike `_hints` (which point to related resources), `_suggestions` draw attention to things that need action based on the data returned.
+
+| Resource    | Action   | Suggestions generated                                |
+| ----------- | -------- | ---------------------------------------------------- |
+| `tasks`     | `list`   | ⚠️ overdue tasks count, ℹ️ unassigned tasks count    |
+| `tasks`     | `get`    | ⚠️ task is N days overdue, ℹ️ no time entries        |
+| `time`      | `list`   | 📊 total hours logged (or X/8h if filtered by today) |
+| `summaries` | `my_day` | ⚠️ no time logged today, ⏱️ timer running too long   |
+
+Example:
+
+```json
+{
+  "data": [{ "id": "1", "title": "Fix bug", "due_date": "2024-01-01" }],
+  "_suggestions": ["⚠️ 1 task(s) are overdue", "ℹ️ 1 task(s) have no assignee"]
+}
+```
+
+Suggestions are suppressed when `no_hints: true` is set.
+
 Example response for a task:
 
 ```json
@@ -622,6 +712,38 @@ The response includes `_hints` showing how to fetch related resources.
 ❌ **Wrong:** Using `include: ["comments"]` on tasks (not supported)
 ✅ **Right:** Fetch comments separately with `resource: "comments", action: "list"`
 
+## Rich Context (Single Call)
+
+Use `action=context` to fetch a resource along with all its related data in a single call. This replaces the multi-step approach described above.
+
+**Available for:** `tasks`, `projects`, `deals`
+
+### Tasks
+
+```json
+{ "resource": "tasks", "action": "context", "id": "16097010" }
+```
+
+Returns: task details + comments + time entries + subtasks
+
+### Projects
+
+```json
+{ "resource": "projects", "action": "context", "id": "12345" }
+```
+
+Returns: project details + open tasks + services + recent time entries
+
+### Deals
+
+```json
+{ "resource": "deals", "action": "context", "id": "12345" }
+```
+
+Returns: deal details + services + comments + time entries
+
+> **Note:** Related data is limited to 20 items per type. For full listings, use separate `list` calls with appropriate filters.
+
 ## Time Values
 
 **Time is always in MINUTES:**
@@ -669,3 +791,4 @@ Key points:
 4. **Use `query`** for text search - behavior varies by resource but may include related fields (e.g., tasks query may match project names)
 5. **Check `people.me`** first to get the current user's ID for filters
 6. **Follow `_hints`** - When getting a resource, check the `_hints` field for suggestions on fetching related context
+7. **Act on `_suggestions`** - When present, `_suggestions` highlight data issues (overdue tasks, no time logged, etc.) that may need attention or should be surfaced to the user