@iamsamuelfraga/mcp-pipedrive 1.0.3

package/dist/tools/files/upload.js

@@ -0,0 +1,62 @@
+import { UploadFileFromPathSchema } from '../../schemas/file.js';
+import { readFile } from 'fs/promises';
+import { basename } from 'path';
+export function getUploadFileTool(client) {
+    return {
+        'files/upload': {
+            description: `Upload a file to Pipedrive and attach it to a deal, person, organization, activity, or product.
+
+Uploads a file from the specified file path and associates it with at least one entity.
+
+Workflow tips:
+- Provide the full file path to upload
+- At least one entity ID must be provided (deal_id, person_id, org_id, activity_id, or product_id)
+- The file name will be extracted from the path automatically
+- Supports all common file types (documents, images, videos, etc.)
+- Maximum file size depends on your Pipedrive plan
+
+Common use cases:
+- Attach contract to deal: { "file_path": "/path/contract.pdf", "deal_id": 123 }
+- Add profile photo to person: { "file_path": "/path/photo.jpg", "person_id": 456 }
+- Upload document to organization: { "file_path": "/path/doc.docx", "org_id": 789 }
+- Attach multiple entities: { "file_path": "/path/file.pdf", "deal_id": 123, "person_id": 456 }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    file_path: {
+                        type: 'string',
+                        description: 'Path to the file to upload',
+                    },
+                    deal_id: { type: 'number', description: 'ID of the deal to attach the file to' },
+                    person_id: { type: 'number', description: 'ID of the person to attach the file to' },
+                    org_id: { type: 'number', description: 'ID of the organization to attach the file to' },
+                    activity_id: { type: 'number', description: 'ID of the activity to attach the file to' },
+                    product_id: { type: 'number', description: 'ID of the product to attach the file to' },
+                    lead_id: { type: 'number', description: 'ID of the lead to attach the file to' },
+                },
+                required: ['file_path'],
+            },
+            handler: async (args) => {
+                const validated = UploadFileFromPathSchema.parse(args);
+                const { file_path, ...entityIds } = validated;
+                // Read file from disk
+                const fileBuffer = await readFile(file_path);
+                const fileName = basename(file_path);
+                // Build additional fields for entity associations
+                const additionalFields = {};
+                if (entityIds.deal_id)
+                    additionalFields.deal_id = entityIds.deal_id;
+                if (entityIds.person_id)
+                    additionalFields.person_id = entityIds.person_id;
+                if (entityIds.org_id)
+                    additionalFields.org_id = entityIds.org_id;
+                if (entityIds.activity_id)
+                    additionalFields.activity_id = entityIds.activity_id;
+                if (entityIds.product_id)
+                    additionalFields.product_id = entityIds.product_id;
+                return client.uploadFile('/files', fileBuffer, fileName, additionalFields);
+            },
+        },
+    };
+}
+//# sourceMappingURL=upload.js.map

package/dist/tools/files/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../src/tools/files/upload.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,OAAO;QACL,cAAc,EAAE;YACd,WAAW,EAAE;;;;;;;;;;;;;;;gGAe6E;YAC1F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4BAA4B;qBAC1C;oBACD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;oBAChF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;oBACpF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;oBACvF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;oBACxF,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;oBACtF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;iBACjF;gBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;aACxB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvD,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC;gBAE9C,sBAAsB;gBACtB,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAErC,kDAAkD;gBAClD,MAAM,gBAAgB,GAA2B,EAAE,CAAC;gBACpD,IAAI,SAAS,CAAC,OAAO;oBAAE,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;gBACpE,IAAI,SAAS,CAAC,SAAS;oBAAE,gBAAgB,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;gBAC1E,IAAI,SAAS,CAAC,MAAM;oBAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;gBACjE,IAAI,SAAS,CAAC,WAAW;oBAAE,gBAAgB,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;gBAChF,IAAI,SAAS,CAAC,UAAU;oBAAE,gBAAgB,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;gBAE7E,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YAC7E,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/filters/bulk.d.ts

@@ -0,0 +1,18 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getBulkDeleteFiltersTool(client: PipedriveClient): {
+    'filters/bulk_delete': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                ids: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=bulk.d.ts.map

package/dist/tools/filters/bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../../src/tools/filters/bulk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;wBA0BpC,OAAO;;EAOlC"}

package/dist/tools/filters/bulk.js

@@ -0,0 +1,35 @@
+import { BulkDeleteFiltersSchema } from '../../schemas/filter.js';
+export function getBulkDeleteFiltersTool(client) {
+    return {
+        'filters/bulk_delete': {
+            description: `Delete multiple filters at once in Pipedrive.
+
+Marks multiple filters as deleted in a single operation. More efficient than deleting one at a time.
+
+Workflow tips:
+- Provide comma-separated filter IDs as a string (e.g., "1,2,3,4")
+- Use filters/list to find filter IDs to delete
+- All specified filters will be deleted in one API call
+- Deletion is permanent and cannot be undone
+
+Common use cases:
+- Delete multiple filters: { "ids": "123,456,789" }
+- Clean up old filters: { "ids": "1,2,3,4,5" }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ids: {
+                        type: 'string',
+                        description: 'Comma-separated filter IDs to delete (required). Example: "1,2,3"',
+                    },
+                },
+                required: ['ids'],
+            },
+            handler: async (args) => {
+                const validated = BulkDeleteFiltersSchema.parse(args);
+                return client.delete('/filters', { ids: validated.ids });
+            },
+        },
+    };
+}
+//# sourceMappingURL=bulk.js.map

package/dist/tools/filters/bulk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.js","sourceRoot":"","sources":["../../../src/tools/filters/bulk.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,UAAU,wBAAwB,CAAC,MAAuB;IAC9D,OAAO;QACL,qBAAqB,EAAE;YACrB,WAAW,EAAE;;;;;;;;;;;;+CAY4B;YACzC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,GAAG,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mEAAmE;qBACjF;iBACF;gBACD,QAAQ,EAAE,CAAC,KAAK,CAAC;aAClB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAEtD,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3D,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/filters/create.d.ts

@@ -0,0 +1,27 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getCreateFilterTool(client: PipedriveClient): {
+    'filters/create': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                conditions: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=create.d.ts.map

package/dist/tools/filters/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/tools/filters/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;wBAgE/B,OAAO;;EAMlC"}

package/dist/tools/filters/create.js

@@ -0,0 +1,73 @@
+import { CreateFilterSchema } from '../../schemas/filter.js';
+export function getCreateFilterTool(client) {
+    return {
+        'filters/create': {
+            description: `Create a new filter in Pipedrive.
+
+Adds a new filter with conditions. Returns the filter ID upon success.
+
+IMPORTANT LIMITATIONS:
+- Only ONE first-level condition group is supported (must be glued with 'AND')
+- Only TWO second-level condition groups are supported
+- First second-level group must be glued with 'AND'
+- Second second-level group must be glued with 'OR'
+- Maximum of 16 conditions per filter
+
+Workflow tips:
+- Use filters/helpers to discover available field IDs and operators
+- Structure: { glue: "and", conditions: [{ glue: "and", conditions: [...] }, { glue: "or", conditions: [...] }] }
+- Common operators: =, !=, <, >, <=, >=, LIKE, IN, IS NULL, IS NOT NULL
+- Filter types: deals, org, people, products, activities
+
+Example simple filter:
+{
+  "name": "High value deals",
+  "type": "deals",
+  "conditions": {
+    "glue": "and",
+    "conditions": [
+      {
+        "glue": "and",
+        "conditions": [
+          {
+            "object": "deal",
+            "field_id": "value",
+            "operator": ">",
+            "value": 10000
+          }
+        ]
+      },
+      {
+        "glue": "or",
+        "conditions": [null]
+      }
+    ]
+  }
+}`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'Filter name (required)',
+                    },
+                    type: {
+                        type: 'string',
+                        enum: ['deals', 'org', 'people', 'products', 'activities'],
+                        description: 'Filter type (required)',
+                    },
+                    conditions: {
+                        type: 'object',
+                        description: 'Filter conditions structure with glue and conditions array (required)',
+                    },
+                },
+                required: ['name', 'type', 'conditions'],
+            },
+            handler: async (args) => {
+                const validated = CreateFilterSchema.parse(args);
+                return client.post('/filters', validated);
+            },
+        },
+    };
+}
+//# sourceMappingURL=create.js.map

package/dist/tools/filters/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/filters/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,UAAU,mBAAmB,CAAC,MAAuB;IACzD,OAAO;QACL,gBAAgB,EAAE;YAChB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCjB;YACI,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,wBAAwB;qBACtC;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC;wBAC1D,WAAW,EAAE,wBAAwB;qBACtC;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,uEAAuE;qBACrF;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC;aACzC;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjD,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAC5C,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/filters/delete.d.ts

@@ -0,0 +1,18 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getDeleteFilterTool(client: PipedriveClient): {
+    'filters/delete': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=delete.d.ts.map

package/dist/tools/filters/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/tools/filters/delete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;wBA0B/B,OAAO;;EAOlC"}

package/dist/tools/filters/delete.js

@@ -0,0 +1,35 @@
+import { DeleteFilterSchema } from '../../schemas/filter.js';
+export function getDeleteFilterTool(client) {
+    return {
+        'filters/delete': {
+            description: `Delete a filter in Pipedrive.
+
+Marks a filter as deleted. The filter will no longer be available for use.
+
+Workflow tips:
+- Use filters/list to find filter IDs to delete
+- Use filters/get to verify filter details before deletion
+- For deleting multiple filters at once, use filters/bulk_delete instead
+- Deletion is permanent and cannot be undone
+
+Common use cases:
+- Delete a specific filter: { "id": 123 }
+- Remove unused filter: { "id": 456 }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: {
+                        type: 'number',
+                        description: 'ID of the filter to delete (required)',
+                    },
+                },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const validated = DeleteFilterSchema.parse(args);
+                return client.delete(`/filters/${validated.id}`);
+            },
+        },
+    };
+}
+//# sourceMappingURL=delete.js.map

package/dist/tools/filters/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/filters/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,UAAU,mBAAmB,CAAC,MAAuB;IACzD,OAAO;QACL,gBAAgB,EAAE;YAChB,WAAW,EAAE;;;;;;;;;;;;sCAYmB;YAChC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,EAAE,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,uCAAuC;qBACrD;iBACF;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAEjD,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/filters/get.d.ts

@@ -0,0 +1,18 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getGetFilterTool(client: PipedriveClient): {
+    'filters/get': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=get.d.ts.map

package/dist/tools/filters/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/tools/filters/get.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;wBA0B5B,OAAO;;EAWlC"}

package/dist/tools/filters/get.js

@@ -0,0 +1,36 @@
+import { GetFilterSchema } from '../../schemas/filter.js';
+export function getGetFilterTool(client) {
+    return {
+        'filters/get': {
+            description: `Get a specific filter by ID.
+
+Returns detailed data about a specific filter, including its condition lines.
+
+Workflow tips:
+- Returns complete filter configuration including conditions structure
+- Use filters/list to discover available filter IDs
+- The conditions field contains the filter's logic (glue, conditions array)
+- Results are heavily cached for 15 minutes
+
+Common use cases:
+- Get filter details: { "id": 123 }
+- Inspect filter conditions: { "id": 456 }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: {
+                        type: 'number',
+                        description: 'ID of the filter to retrieve (required)',
+                    },
+                },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const validated = GetFilterSchema.parse(args);
+                return client.get(`/filters/${validated.id}`, {}, { enabled: true, ttl: 900000 } // Cache for 15 minutes
+                );
+            },
+        },
+    };
+}
+//# sourceMappingURL=get.js.map

package/dist/tools/filters/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/filters/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO;QACL,aAAa,EAAE;YACb,WAAW,EAAE;;;;;;;;;;;;2CAYwB;YACrC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,EAAE,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,yCAAyC;qBACvD;iBACF;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE9C,OAAO,MAAM,CAAC,GAAG,CACf,YAAY,SAAS,CAAC,EAAE,EAAE,EAC1B,EAAE,EACF,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,uBAAuB;iBACvD,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/filters/helpers.d.ts

@@ -0,0 +1,12 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getFilterHelpersTool(client: PipedriveClient): {
+    'filters/helpers': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+        };
+        handler: (_args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/tools/filters/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/filters/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe;;;;;;;yBA8B/B,OAAO;;EASnC"}

package/dist/tools/filters/helpers.js

@@ -0,0 +1,38 @@
+export function getFilterHelpersTool(client) {
+    return {
+        'filters/helpers': {
+            description: `Get all available filter helpers and field types.
+
+Returns comprehensive information about what conditions and helpers are available for creating/updating filters.
+
+This tool helps you understand:
+- What field IDs are available for each object type
+- What operators can be used with each field
+- Field data types (text, number, date, etc.)
+- Available options for enum/select fields
+- Helper types for building filter UIs
+
+Workflow tips:
+- Use this BEFORE creating or updating filters to know available fields
+- Essential for understanding what field_id values to use in conditions
+- Shows which operators are valid for each field type
+- Results are heavily cached for 15 minutes
+- No parameters needed - returns all available helpers
+
+Common use cases:
+- Discover available deal fields: {}
+- Find person field IDs: {}
+- Check valid operators for a field: {}
+- Get dropdown options for enum fields: {}`,
+            inputSchema: {
+                type: 'object',
+                properties: {},
+            },
+            handler: async (_args) => {
+                return client.get('/filters/helpers', {}, { enabled: true, ttl: 900000 } // Cache for 15 minutes
+                );
+            },
+        },
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/filters/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/tools/filters/helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,OAAO;QACL,iBAAiB,EAAE;YACjB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;2CAsBwB;YACrC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE;aACf;YACD,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE;gBAChC,OAAO,MAAM,CAAC,GAAG,CACf,kBAAkB,EAClB,EAAE,EACF,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,uBAAuB;iBACvD,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/filters/index.d.ts

@@ -0,0 +1,134 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+/**
+ * Get all filter-related tools for the MCP server
+ *
+ * This function aggregates all 7 filter tools into a single object:
+ * - List operations: list
+ * - CRUD operations: create, get, update, delete
+ * - Bulk operations: bulk_delete
+ * - Helpers: helpers (get available filter fields and operators)
+ *
+ * Filters are used to create reusable condition sets that can be applied
+ * when fetching lists of deals, leads, persons, organizations, or products.
+ *
+ * Key features:
+ * - Support for 5 filter types: deals, org, people, products, activities
+ * - Complex condition structure with AND/OR logic
+ * - Heavy caching (15 minutes) for optimal performance
+ * - Helper endpoint to discover available fields and operators
+ *
+ * @param client - The PipedriveClient instance to use for API calls
+ * @returns Object containing all filter tools with their configurations
+ */
+export declare function getFilterTools(client: PipedriveClient): {
+    'filters/helpers': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+        };
+        handler: (_args: unknown) => Promise<unknown>;
+    };
+    'filters/bulk_delete': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                ids: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+    'filters/delete': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+    'filters/update': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: string;
+                    description: string;
+                };
+                name: {
+                    type: string;
+                    description: string;
+                };
+                conditions: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+    'filters/create': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                conditions: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+    'filters/get': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+    'filters/list': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/filters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/filters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AASjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUrD"}

package/dist/tools/filters/index.js

@@ -0,0 +1,40 @@
+import { getListFiltersTools } from './list.js';
+import { getGetFilterTool } from './get.js';
+import { getCreateFilterTool } from './create.js';
+import { getUpdateFilterTool } from './update.js';
+import { getDeleteFilterTool } from './delete.js';
+import { getBulkDeleteFiltersTool } from './bulk.js';
+import { getFilterHelpersTool } from './helpers.js';
+/**
+ * Get all filter-related tools for the MCP server
+ *
+ * This function aggregates all 7 filter tools into a single object:
+ * - List operations: list
+ * - CRUD operations: create, get, update, delete
+ * - Bulk operations: bulk_delete
+ * - Helpers: helpers (get available filter fields and operators)
+ *
+ * Filters are used to create reusable condition sets that can be applied
+ * when fetching lists of deals, leads, persons, organizations, or products.
+ *
+ * Key features:
+ * - Support for 5 filter types: deals, org, people, products, activities
+ * - Complex condition structure with AND/OR logic
+ * - Heavy caching (15 minutes) for optimal performance
+ * - Helper endpoint to discover available fields and operators
+ *
+ * @param client - The PipedriveClient instance to use for API calls
+ * @returns Object containing all filter tools with their configurations
+ */
+export function getFilterTools(client) {
+    return {
+        ...getListFiltersTools(client),
+        ...getGetFilterTool(client),
+        ...getCreateFilterTool(client),
+        ...getUpdateFilterTool(client),
+        ...getDeleteFilterTool(client),
+        ...getBulkDeleteFiltersTool(client),
+        ...getFilterHelpersTool(client),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/filters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/filters/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO;QACL,GAAG,mBAAmB,CAAC,MAAM,CAAC;QAC9B,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC3B,GAAG,mBAAmB,CAAC,MAAM,CAAC;QAC9B,GAAG,mBAAmB,CAAC,MAAM,CAAC;QAC9B,GAAG,mBAAmB,CAAC,MAAM,CAAC;QAC9B,GAAG,wBAAwB,CAAC,MAAM,CAAC;QACnC,GAAG,oBAAoB,CAAC,MAAM,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/tools/filters/list.d.ts

@@ -0,0 +1,18 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getListFiltersTools(client: PipedriveClient): {
+    'filters/list': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=list.d.ts.map

package/dist/tools/filters/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/tools/filters/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;wBA4B/B,OAAO;;EAWlC"}