@studiometa/productive-mcp 0.10.6 → 0.10.8

package/dist/version-DpBFJ7eV.js

@@ -0,0 +1,236 @@
+import { a as handleSchemaOverview, c as handleDeals, i as handleServices, n as handleTasks, o as handleProjects, r as handleSummaries, s as handlePeople } from "./handlers-t95fhdps.js";
+import { ProductiveApi } from "@studiometa/productive-api";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { fromHandlerContext } from "@studiometa/productive-core";
+/**
+* MCP Server Instructions
+*
+* These instructions are sent to Claude Desktop during initialization
+* and used as context/hints for the LLM. This ensures the AI agent
+* knows how to properly use the Productive.io MCP server.
+*
+* The content is derived from skills/SKILL.md (without YAML frontmatter).
+*/
+var __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+* Load instructions from SKILL.md file
+* Removes YAML frontmatter (content between --- markers)
+*/
+function loadInstructions() {
+	try {
+		return readFileSync(join(__dirname, "..", "skills", "SKILL.md"), "utf-8").replace(/^---\n[\s\S]*?\n---\n+/, "").trim();
+	} catch {
+		return "Productive.io MCP Server - Use the productive tool with resource and action parameters.";
+	}
+}
+const INSTRUCTIONS = loadInstructions();
+/** MIME type used for all resource content */
+var MIME_TYPE = "application/json";
+/**
+* Static resources that are always available without API credentials
+*/
+const STATIC_RESOURCES = [{
+	uri: "productive://schema",
+	name: "Schema",
+	description: "Overview of all Productive.io resources, their actions and filters",
+	mimeType: MIME_TYPE
+}, {
+	uri: "productive://instructions",
+	name: "Instructions",
+	description: "Server instructions and usage guide for the Productive.io MCP server",
+	mimeType: MIME_TYPE
+}];
+/**
+* Dynamic resources that are computed at read time (require credentials)
+*/
+const DYNAMIC_RESOURCES = [{
+	uri: "productive://summaries/my_day",
+	name: "My Day",
+	description: "Personal dashboard: open tasks, today's time entries, active timers",
+	mimeType: MIME_TYPE
+}, {
+	uri: "productive://summaries/team_pulse",
+	name: "Team Pulse",
+	description: "Team-wide time tracking activity for today",
+	mimeType: MIME_TYPE
+}];
+/**
+* Resource templates that accept URI parameters (require credentials)
+*/
+const RESOURCE_TEMPLATES = [
+	{
+		uriTemplate: "productive://projects/{id}",
+		name: "Project",
+		description: "Details of a specific project by ID",
+		mimeType: MIME_TYPE
+	},
+	{
+		uriTemplate: "productive://tasks/{id}",
+		name: "Task",
+		description: "Details of a specific task by ID",
+		mimeType: MIME_TYPE
+	},
+	{
+		uriTemplate: "productive://people/{id}",
+		name: "Person",
+		description: "Details of a specific person by ID",
+		mimeType: MIME_TYPE
+	},
+	{
+		uriTemplate: "productive://deals/{id}",
+		name: "Deal",
+		description: "Details of a specific deal or budget by ID",
+		mimeType: MIME_TYPE
+	},
+	{
+		uriTemplate: "productive://projects/{id}/tasks",
+		name: "Project Tasks",
+		description: "All tasks belonging to a specific project",
+		mimeType: MIME_TYPE
+	},
+	{
+		uriTemplate: "productive://projects/{id}/services",
+		name: "Project Services",
+		description: "All services belonging to a specific project",
+		mimeType: MIME_TYPE
+	}
+];
+/** Route patterns and their handler factories */
+var URI_PATTERNS = [
+	{
+		pattern: /^productive:\/\/schema$/,
+		handler: async () => {
+			const text = handleSchemaOverview().content[0];
+			return JSON.parse(text.text);
+		}
+	},
+	{
+		pattern: /^productive:\/\/instructions$/,
+		handler: async () => ({ instructions: INSTRUCTIONS })
+	},
+	{
+		pattern: /^productive:\/\/summaries\/my_day$/,
+		handler: async (_, credentials) => {
+			return extractJsonFromResult(await handleSummaries("my_day", {}, buildHandlerContext(credentials)));
+		}
+	},
+	{
+		pattern: /^productive:\/\/summaries\/team_pulse$/,
+		handler: async (_, credentials) => {
+			return extractJsonFromResult(await handleSummaries("team_pulse", {}, buildHandlerContext(credentials)));
+		}
+	},
+	{
+		pattern: /^productive:\/\/projects\/([^/]+)\/tasks$/,
+		handler: async ([, id], credentials) => {
+			const ctx = buildHandlerContext(credentials, { filter: { project_id: id } });
+			return extractJsonFromResult(await handleTasks("list", { project_id: id }, ctx));
+		}
+	},
+	{
+		pattern: /^productive:\/\/projects\/([^/]+)\/services$/,
+		handler: async ([, id], credentials) => {
+			return extractJsonFromResult(await handleServices("list", {}, buildHandlerContext(credentials, { filter: { project_id: id } })));
+		}
+	},
+	{
+		pattern: /^productive:\/\/projects\/([^/]+)$/,
+		handler: async ([, id], credentials) => {
+			const ctx = buildHandlerContext(credentials);
+			return extractJsonFromResult(await handleProjects("get", { id }, ctx));
+		}
+	},
+	{
+		pattern: /^productive:\/\/tasks\/([^/]+)$/,
+		handler: async ([, id], credentials) => {
+			const ctx = buildHandlerContext(credentials);
+			return extractJsonFromResult(await handleTasks("get", { id }, ctx));
+		}
+	},
+	{
+		pattern: /^productive:\/\/people\/([^/]+)$/,
+		handler: async ([, id], credentials) => {
+			const ctx = buildHandlerContext(credentials);
+			return extractJsonFromResult(await handlePeople("get", { id }, ctx, credentials));
+		}
+	},
+	{
+		pattern: /^productive:\/\/deals\/([^/]+)$/,
+		handler: async ([, id], credentials) => {
+			const ctx = buildHandlerContext(credentials);
+			return extractJsonFromResult(await handleDeals("get", { id }, ctx));
+		}
+	}
+];
+/**
+* Build a HandlerContext from credentials, with optional filter overrides.
+*/
+function buildHandlerContext(credentials, overrides = {}) {
+	const execCtx = fromHandlerContext({ api: new ProductiveApi({ config: {
+		apiToken: credentials.apiToken,
+		organizationId: credentials.organizationId,
+		userId: credentials.userId,
+		baseUrl: process.env.PRODUCTIVE_BASE_URL
+	} }) }, { userId: credentials.userId });
+	return {
+		formatOptions: { compact: false },
+		filter: overrides.filter,
+		perPage: 50,
+		includeHints: false,
+		includeSuggestions: false,
+		executor: () => execCtx
+	};
+}
+/**
+* Extract the parsed JSON data from a ToolResult.
+* Throws if the result is an error or not parseable.
+*/
+function extractJsonFromResult(result) {
+	if (result.isError) {
+		const text = result.content[0].text;
+		throw new Error(text);
+	}
+	const text = result.content[0].text;
+	try {
+		return JSON.parse(text);
+	} catch {
+		return { text };
+	}
+}
+/**
+* List all static and dynamic resources (no credentials needed for static).
+*/
+function listResources() {
+	return [...STATIC_RESOURCES, ...DYNAMIC_RESOURCES];
+}
+/**
+* List all resource templates.
+*/
+function listResourceTemplates() {
+	return RESOURCE_TEMPLATES;
+}
+/**
+* Read a resource by URI.
+*
+* Routes the URI to the appropriate handler. Throws on unknown URI.
+*/
+async function readResource(uri, credentials) {
+	for (const { pattern, handler } of URI_PATTERNS) {
+		const match = uri.match(pattern);
+		if (match) {
+			const data = await handler(match, credentials);
+			return { contents: [{
+				uri,
+				mimeType: MIME_TYPE,
+				text: JSON.stringify(data, null, 2)
+			}] };
+		}
+	}
+	throw new Error(`Unknown resource URI: ${uri}. Available static resources: ${STATIC_RESOURCES.map((r) => r.uri).join(", ")}. Available dynamic resources: ${DYNAMIC_RESOURCES.map((r) => r.uri).join(", ")}. Resource templates: ${RESOURCE_TEMPLATES.map((t) => t.uriTemplate).join(", ")}.`);
+}
+const VERSION = "0.10.8";
+export { INSTRUCTIONS as a, readResource as i, listResourceTemplates as n, listResources as r, VERSION as t };
+
+//# sourceMappingURL=version-DpBFJ7eV.js.map

package/dist/version-DpBFJ7eV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-DpBFJ7eV.js","names":[],"sources":["../src/instructions.ts","../src/resources.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 * MCP Resources handlers for Productive MCP Server\n *\n * Exposes Productive data via MCP resources/ capability so clients can browse\n * and read data without tool calls.\n *\n * Static resources (always available):\n *   productive://schema          — full resource schema overview\n *   productive://instructions    — server instructions / SKILL.md content\n *\n * Resource templates (parameterized, require API calls):\n *   productive://projects/{id}            — project details\n *   productive://tasks/{id}               — task details\n *   productive://people/{id}              — person details\n *   productive://deals/{id}               — deal details\n *   productive://projects/{id}/tasks      — tasks for a project\n *   productive://projects/{id}/services   — services for a project\n *\n * Dynamic resources (computed):\n *   productive://summaries/my_day         — personal dashboard\n *   productive://summaries/team_pulse     — team activity\n */\n\nimport type { ReadResourceResult as McpReadResourceResult } from '@modelcontextprotocol/sdk/types.js';\n\nimport { ProductiveApi } from '@studiometa/productive-api';\nimport { fromHandlerContext } from '@studiometa/productive-core';\n\nimport type { ProductiveCredentials } from './auth.js';\nimport type { HandlerContext } from './handlers/types.js';\n\nimport { handleDeals } from './handlers/deals.js';\nimport { handlePeople } from './handlers/people.js';\nimport { handleProjects } from './handlers/projects.js';\nimport { handleSchemaOverview } from './handlers/schema.js';\nimport { handleServices } from './handlers/services.js';\nimport { handleSummaries } from './handlers/summaries.js';\nimport { handleTasks } from './handlers/tasks.js';\nimport { INSTRUCTIONS } from './instructions.js';\n\n/** MIME type used for all resource content */\nconst MIME_TYPE = 'application/json';\n\n/**\n * A single resource content item returned in resources/read responses\n */\nexport interface ResourceContent {\n  uri: string;\n  mimeType: string;\n  text: string;\n}\n\n/**\n * Shape of a resources/read response (re-export of SDK type for consumers)\n */\nexport type ReadResourceResult = McpReadResourceResult;\n\n/**\n * Shape of a static resource descriptor (resources/list)\n */\nexport interface StaticResource {\n  uri: string;\n  name: string;\n  description: string;\n  mimeType: string;\n}\n\n/**\n * Shape of a resource template descriptor (resources/templates/list)\n */\nexport interface ResourceTemplate {\n  uriTemplate: string;\n  name: string;\n  description: string;\n  mimeType: string;\n}\n\n// ---------------------------------------------------------------------------\n// Static resource definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Static resources that are always available without API credentials\n */\nexport const STATIC_RESOURCES: StaticResource[] = [\n  {\n    uri: 'productive://schema',\n    name: 'Schema',\n    description: 'Overview of all Productive.io resources, their actions and filters',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uri: 'productive://instructions',\n    name: 'Instructions',\n    description: 'Server instructions and usage guide for the Productive.io MCP server',\n    mimeType: MIME_TYPE,\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Dynamic resource definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Dynamic resources that are computed at read time (require credentials)\n */\nexport const DYNAMIC_RESOURCES: StaticResource[] = [\n  {\n    uri: 'productive://summaries/my_day',\n    name: 'My Day',\n    description: \"Personal dashboard: open tasks, today's time entries, active timers\",\n    mimeType: MIME_TYPE,\n  },\n  {\n    uri: 'productive://summaries/team_pulse',\n    name: 'Team Pulse',\n    description: 'Team-wide time tracking activity for today',\n    mimeType: MIME_TYPE,\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Resource template definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Resource templates that accept URI parameters (require credentials)\n */\nexport const RESOURCE_TEMPLATES: ResourceTemplate[] = [\n  {\n    uriTemplate: 'productive://projects/{id}',\n    name: 'Project',\n    description: 'Details of a specific project by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://tasks/{id}',\n    name: 'Task',\n    description: 'Details of a specific task by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://people/{id}',\n    name: 'Person',\n    description: 'Details of a specific person by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://deals/{id}',\n    name: 'Deal',\n    description: 'Details of a specific deal or budget by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://projects/{id}/tasks',\n    name: 'Project Tasks',\n    description: 'All tasks belonging to a specific project',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://projects/{id}/services',\n    name: 'Project Services',\n    description: 'All services belonging to a specific project',\n    mimeType: MIME_TYPE,\n  },\n];\n\n// ---------------------------------------------------------------------------\n// URI pattern matching\n// ---------------------------------------------------------------------------\n\n/** Route patterns and their handler factories */\nconst URI_PATTERNS: Array<{\n  pattern: RegExp;\n  handler: (match: RegExpMatchArray, credentials: ProductiveCredentials) => Promise<unknown>;\n}> = [\n  // Static resources (no credentials needed)\n  {\n    pattern: /^productive:\\/\\/schema$/,\n    handler: async () => {\n      const result = handleSchemaOverview();\n      const text = result.content[0] as { text: string };\n      return JSON.parse(text.text);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/instructions$/,\n    handler: async () => ({ instructions: INSTRUCTIONS }),\n  },\n\n  // Dynamic summaries\n  {\n    pattern: /^productive:\\/\\/summaries\\/my_day$/,\n    handler: async (_, credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleSummaries('my_day', {}, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/summaries\\/team_pulse$/,\n    handler: async (_, credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleSummaries('team_pulse', {}, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n\n  // Project nested resources (before single project to avoid conflict)\n  {\n    pattern: /^productive:\\/\\/projects\\/([^/]+)\\/tasks$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials, { filter: { project_id: id } });\n      const result = await handleTasks('list', { project_id: id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/projects\\/([^/]+)\\/services$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials, { filter: { project_id: id } });\n      // handleServices uses CommonArgs; project_id is passed via ctx.filter\n      const result = await handleServices('list', {}, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n\n  // Single entity resources\n  {\n    pattern: /^productive:\\/\\/projects\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleProjects('get', { id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/tasks\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleTasks('get', { id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/people\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handlePeople('get', { id }, ctx, credentials);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/deals\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleDeals('get', { id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Build a HandlerContext from credentials, with optional filter overrides.\n */\nfunction buildHandlerContext(\n  credentials: ProductiveCredentials,\n  overrides: { filter?: Record<string, string> } = {},\n): HandlerContext {\n  const api = new ProductiveApi({\n    config: {\n      apiToken: credentials.apiToken,\n      organizationId: credentials.organizationId,\n      userId: credentials.userId,\n      baseUrl: process.env.PRODUCTIVE_BASE_URL,\n    },\n  });\n\n  const execCtx = fromHandlerContext({ api }, { userId: credentials.userId });\n\n  return {\n    formatOptions: { compact: false },\n    filter: overrides.filter,\n    perPage: 50,\n    includeHints: false,\n    includeSuggestions: false,\n    executor: () => execCtx,\n  };\n}\n\n/**\n * Extract the parsed JSON data from a ToolResult.\n * Throws if the result is an error or not parseable.\n */\nfunction extractJsonFromResult(result: { content: unknown[]; isError?: boolean }): unknown {\n  if (result.isError) {\n    const text = (result.content[0] as { text: string }).text;\n    throw new Error(text);\n  }\n  const text = (result.content[0] as { text: string }).text;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return { text };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * List all static and dynamic resources (no credentials needed for static).\n */\nexport function listResources(): StaticResource[] {\n  return [...STATIC_RESOURCES, ...DYNAMIC_RESOURCES];\n}\n\n/**\n * List all resource templates.\n */\nexport function listResourceTemplates(): ResourceTemplate[] {\n  return RESOURCE_TEMPLATES;\n}\n\n/**\n * Read a resource by URI.\n *\n * Routes the URI to the appropriate handler. Throws on unknown URI.\n */\nexport async function readResource(\n  uri: string,\n  credentials: ProductiveCredentials,\n): Promise<ReadResourceResult> {\n  for (const { pattern, handler } of URI_PATTERNS) {\n    const match = uri.match(pattern);\n    if (match) {\n      const data = await handler(match, credentials);\n      return {\n        contents: [\n          {\n            uri,\n            mimeType: MIME_TYPE,\n            text: JSON.stringify(data, null, 2),\n          },\n        ],\n      };\n    }\n  }\n\n  throw new Error(\n    `Unknown resource URI: ${uri}. ` +\n      `Available static resources: ${STATIC_RESOURCES.map((r) => r.uri).join(', ')}. ` +\n      `Available dynamic resources: ${DYNAMIC_RESOURCES.map((r) => r.uri).join(', ')}. ` +\n      `Resource templates: ${RESOURCE_TEMPLATES.map((t) => t.uriTemplate).join(', ')}.`,\n  );\n}\n","/**\n * Package version - injected from package.json at build time\n */\ndeclare const __VERSION__: string;\nexport const VERSION = __VERSION__;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiometa/productive-mcp",
-  "version": "0.10.6",
+  "version": "0.10.8",
   "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.6",
-    "@studiometa/productive-core": "0.10.6",
+    "@studiometa/productive-api": "0.10.8",
+    "@studiometa/productive-core": "0.10.8",
     "h3": "^1.15.1",
     "zod": "4.3.6"
   },

package/skills/SKILL.md

@@ -21,24 +21,25 @@ productive(resource, action, [parameters...])
 
 ### Resources & Actions
 
-| Resource      | Actions                                                                  | Description                                              |
-| ------------- | ------------------------------------------------------------------------ | -------------------------------------------------------- |
-| `projects`    | `list`, `get`, `resolve`, `context`, `help`                              | Project management                                       |
-| `time`        | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Time tracking                                            |
-| `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`, `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          |
+| Resource        | Actions                                                                  | Description                                              |
+| --------------- | ------------------------------------------------------------------------ | -------------------------------------------------------- |
+| `projects`      | `list`, `get`, `resolve`, `context`, `help`                              | Project management                                       |
+| `time`          | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Time tracking                                            |
+| `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`, `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) |
+| `custom_fields` | `list`, `get`, `help`                                                    | Custom field definitions and option values               |
+| `reports`       | `get`, `help`                                                            | Generate reports                                         |
+| `workflows`     | `complete_task`, `log_day`, `weekly_standup`, `help`                     | Compound workflows chaining multiple operations          |
 
 ### Getting Help
 
@@ -472,89 +473,166 @@ Compound workflows that chain multiple operations into a single tool call.
 
 ## Filters Reference
 
+> **Tip:** Use `action: "help"` on any resource to see the full, up-to-date list of filters, fields, and examples. Use `action: "schema"` for a compact machine-readable spec.
+>
+> ```json
+> { "resource": "tasks", "action": "help" }
+> { "resource": "tasks", "action": "schema" }
+> ```
+
+### Text Search with `query`
+
+Many resources support a `query` filter for full-text search. You can pass it either as a top-level shorthand or via the `filter` object (passthrough pattern):
+
+```json
+// Shorthand (top-level)
+{ "resource": "projects", "action": "list", "query": "website" }
+
+// Filter passthrough (explicit)
+{ "resource": "projects", "action": "list", "filter": { "query": "website" } }
+```
+
+Resources that support `query`: **projects**, **tasks**, **people**, **companies**, **deals**
+
 ### Time Entries
 
-- `person_id` - Filter by person (use "me" for current user)
-- `project_id` - Filter by project
-- `service_id` - Filter by service
-- `task_id` - Filter by task
-- `company_id` - Filter by company
-- `deal_id` / `budget_id` - Filter by deal/budget
-- `after` - After date (YYYY-MM-DD)
-- `before` - Before date (YYYY-MM-DD)
+- `person_id` - Filter by person (use "me" for current user) (array)
+- `project_id` - Filter by project (array)
+- `service_id` - Filter by service (array)
+- `task_id` - Filter by task (array)
+- `company_id` - Filter by company (array)
+- `deal_id` / `budget_id` - Filter by deal/budget (array)
+- `after` / `before` - Date range (YYYY-MM-DD)
+- `date` - Exact date (YYYY-MM-DD)
 - `status` - Approval status: `1`=approved, `2`=unapproved, `3`=rejected
 - `billing_type_id` - Billing type: `1`=fixed, `2`=actuals, `3`=non_billable
 - `invoicing_status` - Invoicing: `1`=not_invoiced, `2`=drafted, `3`=finalized
+- `invoiced` - Invoiced status (boolean)
+- `creator_id` / `approver_id` - Filter by creator or approver (array)
+- `booking_id` - Filter by booking (array)
+- `autotracked` - Auto-tracked entries (boolean)
 
 ### Tasks
 
-- `project_id` - Filter by project
-- `company_id` - Filter by company
-- `assignee_id` - Filter by assigned person
-- `creator_id` - Filter by task creator
+- `query` - Text search on task title
+- `project_id` - Filter by project (array)
+- `company_id` - Filter by company (array)
+- `assignee_id` - Filter by assigned person (array)
+- `creator_id` - Filter by task creator (array)
 - `status` - Status: `1`=open, `2`=closed (or "open", "closed", "all")
-- `task_list_id` - Filter by task list
-- `board_id` - Filter by board
-- `workflow_status_id` - Filter by workflow status (kanban column)
-- `parent_task_id` - Filter by parent task (for subtasks)
+- `task_list_id` - Filter by task list (array)
+- `task_list_status` - Task list status: `1`=open, `2`=closed
+- `board_id` - Filter by board (array)
+- `workflow_status_id` - Filter by workflow status/kanban column (array)
+- `workflow_status_category_id` - Workflow category: `1`=not started, `2`=started, `3`=closed
+- `workflow_id` - Filter by workflow (array)
+- `parent_task_id` - Filter by parent task (for subtasks) (array)
+- `task_type` - Task type: `1`=parent task, `2`=subtask
 - `overdue_status` - Overdue: `1`=not overdue, `2`=overdue
 - `due_date_on` / `due_date_before` / `due_date_after` - Due date filters
+- `start_date_before` / `start_date_after` - Start date filters
+- `after` / `before` - Created date range
+- `closed_after` / `closed_before` - Closed date range
+- `project_manager_id` - Filter by project manager (array)
+- `subscriber_id` - Filter by subscriber/watcher (array)
+- `tags` - Filter by tags
 
 ### Projects
 
-- `company_id` - Filter by company
+- `query` - Text search on project name
+- `company_id` - Filter by company (array)
 - `project_type` - Type: `1`=internal, `2`=client
-- `responsible_id` - Filter by project manager
-- `person_id` - Filter by team member
+- `responsible_id` - Filter by project manager (array)
+- `person_id` - Filter by team member (array)
 - `status` - Status: `1`=active, `2`=archived
 
 ### Services
 
-- `project_id` - Filter by project
-- `deal_id` - Filter by deal
-- `task_id` - Filter by task
-- `person_id` - Filter by person (trackable by)
+- `project_id` - Filter by project (array)
+- `deal_id` - Filter by deal (array)
+- `task_id` - Filter by task (array)
+- `person_id` - Filter by person/trackable by (array)
+- `name` - Filter by service name (text match)
 - `budget_status` - Status: `1`=open, `2`=delivered
+- `stage_status_id` - Stage: `1`=open, `2`=won, `3`=lost, `4`=delivered (array)
 - `billing_type` - Type: `1`=fixed, `2`=actuals, `3`=none
-- `time_tracking_enabled` - Boolean
+- `unit` - Unit: `1`=hour, `2`=piece, `3`=day
+- `time_tracking_enabled` / `expense_tracking_enabled` - Boolean
+- `trackable_by_person_id` - Services trackable by a specific person
+- `after` / `before` - Date range
 
 ### People
 
+- `query` - Text search on name or email
+- `email` - Filter by exact email address
 - `status` - Status: `1`=active, `2`=deactivated
 - `person_type` - Type: `1`=user, `2`=contact, `3`=placeholder
-- `company_id` - Filter by company
+- `company_id` - Filter by company (array)
 - `project_id` - Filter by project
-- `role_id` - Filter by role
+- `role_id` - Filter by role (array)
 - `team` - Filter by team name
+- `manager_id` - Filter by manager
+- `custom_role_id` - Filter by custom role
+- `tags` - Filter by tags
+
+### Companies
+
+- `query` - Text search on company name
+- `name` - Exact name match
+- `company_code` / `billing_name` / `vat` - Filter by specific fields
+- `status` - Status (integer)
+- `archived` - Archived status (boolean)
+- `project_id` - Filter by project (array)
+- `subsidiary_id` - Filter by subsidiary (array)
+- `default_currency` - Filter by currency code (e.g. USD, EUR)
 
 ### Deals
 
-- `company_id` - Filter by company
-- `project_id` - Filter by project
-- `responsible_id` - Filter by responsible person
-- `pipeline_id` - Filter by pipeline
-- `stage_status_id` - Stage: `1`=open, `2`=won, `3`=lost
+- `query` - Text search on deal name
+- `number` - Filter by deal number
+- `company_id` - Filter by company (array)
+- `project_id` - Filter by project (array)
+- `responsible_id` - Filter by responsible person (array)
+- `creator_id` - Filter by creator (array)
+- `pipeline_id` - Filter by pipeline (array)
+- `stage_status_id` - Stage: `1`=open, `2`=won, `3`=lost (array)
+- `status_id` - Filter by deal status (array)
 - `type` - Type: `1`=deal, `2`=budget
+- `deal_type_id` - Deal type: `1`=internal, `2`=client
 - `budget_status` - Budget status: `1`=open, `2`=closed
+- `project_type` - Project type: `1`=internal, `2`=client
+- `subsidiary_id` - Filter by subsidiary (array)
+- `tags` - Filter by tags
+- `recurring` - Recurring deals (boolean)
+- `needs_invoicing` / `time_approval` - Boolean filters
 
 > **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
+- `person_id` - Filter by person (array)
 - `service_id` - Filter by service
-- `project_id` - Filter by project
-- `company_id` - Filter by company
-- `event_id` - Filter by event
-- `after` / `before` - Date range
+- `project_id` - Filter by project (array)
+- `company_id` - Filter by company (array)
+- `event_id` - Filter by event/absence (array)
+- `task_id` - Filter by task (array)
+- `approver_id` - Filter by approver (array)
+- `after` / `before` - Date range (YYYY-MM-DD)
+- `started_on` / `ended_on` - Exact start/end date
 - `booking_type` - Type: `event` (absence) or `service` (budget)
-- `draft` - Tentative status: `true`/`false`
+- `draft` - Tentative bookings only: `true`/`false`
+- `with_draft` - Include tentative bookings: `true`/`false`
+- `status` / `approval_status` - Approval status (array)
+- `billing_type_id` - Billing type: `1`=fixed, `2`=actuals, `3`=none (array)
+- `person_type` - Person type: `1`=user, `2`=contact, `3`=placeholder
+- `canceled` - Canceled bookings (boolean)
 
 ### Pages
 
-- `project_id` - Filter by project
+- `project_id` - Filter by project (array)
 - `creator_id` - Filter by creator
 - `parent_page_id` - Filter by parent page (for sub-pages)
+- `edited_at` - Filter by last edited date (ISO 8601)
 
 ### Discussions
 
@@ -564,15 +642,46 @@ Compound workflows that chain multiple operations into a single tool call.
 ### Comments
 
 - `task_id` - Filter by task
-- `deal_id` - Filter by deal
-- `project_id` - Filter by project
-- `page_id` - Filter by page
+- `project_id` - Filter by project (array)
+- `page_id` - Filter by page (array)
 - `discussion_id` - Filter by discussion
+- `draft` - Draft comments: `true`/`false`
+- `workflow_status_category_id` - Filter by workflow status category (array)
+
+### Activities
+
+- `event` - Event type: create, copy, update, delete, etc.
+- `type` - Activity type: `1`=Comment, `2`=Changeset, `3`=Email
+- `after` / `before` - ISO 8601 timestamp range
+- `person_id` - Filter by person (array)
+- `project_id` - Filter by project (array)
+- `company_id` / `task_id` / `deal_id` / `discussion_id` - Filter by resource (array)
+- `item_type` - Resource type (e.g. Task, Page, Deal, Workspace)
+- `parent_type` / `root_type` - Parent/root resource type
+- `has_attachments` / `pinned` - Boolean filters
+
+### Custom Fields
+
+- `customizable_type` - Resource type: Task, Deal, Company, Project, Booking, Service, etc.
+- `archived` - Archived status: `true`/`false`
+- `name` - Filter by field name
+- `project_id` - Filter by project
+- `global` - Global custom fields: `true`/`false`
+
+**Workflow to resolve custom field values:**
+
+1. Fetch a task/deal with `custom_fields` attribute (raw `{field_id: value}` hash)
+2. List definitions: `resource=custom_fields, action=list, filter={customizable_type: "Task"}`
+3. For select/multi-select: get field with options: `resource=custom_fields, action=get, id=<field_id>, include=["options"]`
+4. Map field IDs to names, option IDs to values
+
+**Data types:** 1=Text, 2=Number, 3=Select, 4=Date, 5=Multi-select, 6=Person, 7=Attachment
 
 ### Timers
 
 - `person_id` - Filter by person
 - `time_entry_id` - Filter by time entry
+- `started_at` / `stopped_at` - Filter by start/stop time (ISO 8601)
 
 ## Include (Related Resources)