@iamsamuelfraga/mcp-pipedrive 1.0.3

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

@@ -0,0 +1,461 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+/**
+ * Get all person-related tools
+ */
+export declare function getPersonTools(client: PipedriveClient): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly user_id: {
+                readonly type: "number";
+                readonly description: "Filter by owner user ID";
+            };
+            readonly org_id: {
+                readonly type: "number";
+                readonly description: "Filter by organization ID";
+            };
+            readonly first_char: {
+                readonly type: "string";
+                readonly description: "Filter by first character of name (e.g., \"A\", \"B\")";
+            };
+            readonly filter_id: {
+                readonly type: "number";
+                readonly description: "Filter ID to apply";
+            };
+            readonly sort: {
+                readonly type: "string";
+                readonly description: "Field to sort by (e.g., \"name\", \"email\")";
+            };
+        };
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Full name of the person (required)";
+            };
+            readonly owner_id: {
+                readonly type: "number";
+                readonly description: "ID of the user who will own this person";
+            };
+            readonly org_id: {
+                readonly type: "number";
+                readonly description: "ID of the organization this person belongs to";
+            };
+            readonly email: {
+                readonly type: "array";
+                readonly description: "Email addresses array. Example: [{\"value\": \"john@company.com\", \"primary\": true, \"label\": \"work\"}]";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly value: {
+                            readonly type: "string";
+                            readonly description: "Email address";
+                        };
+                        readonly primary: {
+                            readonly type: "boolean";
+                            readonly description: "Is this the primary email?";
+                        };
+                        readonly label: {
+                            readonly type: "string";
+                            readonly description: "Label (work, home, other)";
+                        };
+                    };
+                    readonly required: readonly ["value"];
+                };
+            };
+            readonly phone: {
+                readonly type: "array";
+                readonly description: "Phone numbers array. Example: [{\"value\": \"+1234567890\", \"primary\": true, \"label\": \"mobile\"}]";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly value: {
+                            readonly type: "string";
+                            readonly description: "Phone number";
+                        };
+                        readonly primary: {
+                            readonly type: "boolean";
+                            readonly description: "Is this the primary phone?";
+                        };
+                        readonly label: {
+                            readonly type: "string";
+                            readonly description: "Label (work, mobile, home)";
+                        };
+                    };
+                    readonly required: readonly ["value"];
+                };
+            };
+            readonly visible_to: {
+                readonly type: "string";
+                readonly description: "Visibility: 1 (owner only), 3 (entire company), 5 (owner's followers), 7 (visibility group)";
+                readonly enum: readonly ["1", "3", "5", "7"];
+            };
+            readonly marketing_status: {
+                readonly type: "string";
+                readonly description: "Marketing consent status";
+                readonly enum: readonly ["no_consent", "unsubscribed", "subscribed", "archived"];
+            };
+            readonly add_time: {
+                readonly type: "string";
+                readonly description: "Creation time in YYYY-MM-DD HH:MM:SS format";
+            };
+        };
+        readonly required: readonly ["name"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "number";
+                readonly description: "Person ID";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "number";
+                readonly description: "Person ID to update";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Full name of the person";
+            };
+            readonly owner_id: {
+                readonly type: "number";
+                readonly description: "ID of the user who will own this person";
+            };
+            readonly org_id: {
+                readonly type: "number";
+                readonly description: "ID of the organization this person belongs to";
+            };
+            readonly email: {
+                readonly type: "array";
+                readonly description: "Email addresses array (replaces existing). Example: [{\"value\": \"john@company.com\", \"primary\": true, \"label\": \"work\"}]";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly value: {
+                            readonly type: "string";
+                            readonly description: "Email address";
+                        };
+                        readonly primary: {
+                            readonly type: "boolean";
+                            readonly description: "Is this the primary email?";
+                        };
+                        readonly label: {
+                            readonly type: "string";
+                            readonly description: "Label (work, home, other)";
+                        };
+                    };
+                    readonly required: readonly ["value"];
+                };
+            };
+            readonly phone: {
+                readonly type: "array";
+                readonly description: "Phone numbers array (replaces existing). Example: [{\"value\": \"+1234567890\", \"primary\": true, \"label\": \"mobile\"}]";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly value: {
+                            readonly type: "string";
+                            readonly description: "Phone number";
+                        };
+                        readonly primary: {
+                            readonly type: "boolean";
+                            readonly description: "Is this the primary phone?";
+                        };
+                        readonly label: {
+                            readonly type: "string";
+                            readonly description: "Label (work, mobile, home)";
+                        };
+                    };
+                    readonly required: readonly ["value"];
+                };
+            };
+            readonly visible_to: {
+                readonly type: "string";
+                readonly description: "Visibility: 1 (owner only), 3 (entire company), 5 (owner's followers), 7 (visibility group)";
+                readonly enum: readonly ["1", "3", "5", "7"];
+            };
+            readonly marketing_status: {
+                readonly type: "string";
+                readonly description: "Marketing consent status";
+                readonly enum: readonly ["no_consent", "unsubscribed", "subscribed", "archived"];
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "number";
+                readonly description: "Person ID to delete";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly term: {
+                readonly type: "string";
+                readonly description: "Search term (minimum 2 characters)";
+            };
+            readonly fields: {
+                readonly type: "string";
+                readonly description: "Fields to search in: name, email, phone, notes, custom_fields, or all (default: all)";
+                readonly enum: readonly ["name", "email", "phone", "notes", "custom_fields", "all"];
+            };
+            readonly exact_match: {
+                readonly type: "boolean";
+                readonly description: "Use exact match instead of fuzzy search (default: false)";
+            };
+            readonly org_id: {
+                readonly type: "number";
+                readonly description: "Filter by organization ID";
+            };
+            readonly include_fields: {
+                readonly type: "string";
+                readonly description: "Comma-separated list of additional fields to include";
+            };
+            readonly start: {
+                readonly type: "number";
+                readonly description: "Pagination start (default: 0)";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Number of results to return, max 500 (default: 100)";
+            };
+        };
+        readonly required: readonly ["term"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "number";
+                readonly description: "Person ID";
+            };
+            readonly user_id: {
+                readonly type: "number";
+                readonly description: "User ID to add as follower";
+            };
+        };
+        readonly required: readonly ["id", "user_id"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "number";
+                readonly description: "Person ID";
+            };
+            readonly follower_id: {
+                readonly type: "number";
+                readonly description: "User ID of the follower to remove";
+            };
+        };
+        readonly required: readonly ["id", "follower_id"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "number";
+                readonly description: "ID of the person to keep (primary person)";
+            };
+            readonly merge_with_id: {
+                readonly type: "number";
+                readonly description: "ID of the person to merge and delete (secondary person)";
+            };
+        };
+        readonly required: readonly ["id", "merge_with_id"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "number";
+                readonly description: "Person ID";
+            };
+            readonly file: {
+                readonly type: "string";
+                readonly description: "Base64-encoded image file or file buffer";
+            };
+            readonly filename: {
+                readonly type: "string";
+                readonly description: "Name of the image file (e.g., \"photo.jpg\")";
+            };
+            readonly crop_x: {
+                readonly type: "number";
+                readonly description: "X coordinate for cropping (pixels)";
+            };
+            readonly crop_y: {
+                readonly type: "number";
+                readonly description: "Y coordinate for cropping (pixels)";
+            };
+            readonly crop_width: {
+                readonly type: "number";
+                readonly description: "Width of crop area (pixels)";
+            };
+            readonly crop_height: {
+                readonly type: "number";
+                readonly description: "Height of crop area (pixels)";
+            };
+        };
+        readonly required: readonly ["id", "file", "filename"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly ids: {
+                readonly type: "string";
+                readonly description: "Comma-separated list of person IDs to delete (e.g., \"123,456,789\")";
+            };
+        };
+        readonly required: readonly ["ids"];
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly cursor: {
+                readonly type: "string";
+                readonly description: "Cursor for pagination (from previous response)";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Number of items to return (default: 100, max: 500)";
+            };
+            readonly since: {
+                readonly type: "string";
+                readonly description: "Start date for filtering (YYYY-MM-DD format)";
+            };
+            readonly until: {
+                readonly type: "string";
+                readonly description: "End date for filtering (YYYY-MM-DD format)";
+            };
+            readonly owner_id: {
+                readonly type: "number";
+                readonly description: "Filter by owner user ID";
+            };
+            readonly first_char: {
+                readonly type: "string";
+                readonly description: "Filter by first character of name (single letter)";
+            };
+        };
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+})[];
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/tools/persons/index.js

@@ -0,0 +1,58 @@
+import { getListPersonsTool, getListAllPersonsAutoTool } from './list.js';
+import { getCreatePersonTool } from './create.js';
+import { getGetPersonTool } from './get.js';
+import { getUpdatePersonTool } from './update.js';
+import { getDeletePersonTool } from './delete.js';
+import { getSearchPersonsTool } from './search.js';
+import { getListPersonDealsTool } from './deals.js';
+import { getListPersonActivitiesTool } from './activities.js';
+import { getListPersonFilesTool } from './files.js';
+import { getAddPersonFollowerTool, getListPersonFollowersTool } from './followers.js';
+import { getDeletePersonFollowerTool } from './follower-actions.js';
+import { getListPersonChangelogTool, getListPersonFlowTool } from './updates.js';
+import { getListPersonMailMessagesTool } from './mail.js';
+import { getMergePersonsTool } from './merge.js';
+import { getListPersonPermittedUsersTool } from './permissions.js';
+import { getDeletePersonPictureTool, getAddPersonPictureTool } from './picture.js';
+import { getListPersonProductsTool } from './products.js';
+import { getBulkDeletePersonsTool } from './bulk.js';
+import { getPersonsCollectionTool } from './collection.js';
+/**
+ * Get all person-related tools
+ */
+export function getPersonTools(client) {
+    return [
+        // List and pagination
+        getListPersonsTool(client),
+        getListAllPersonsAutoTool(client),
+        getPersonsCollectionTool(client),
+        // CRUD operations
+        getCreatePersonTool(client),
+        getGetPersonTool(client),
+        getUpdatePersonTool(client),
+        getDeletePersonTool(client),
+        getBulkDeletePersonsTool(client),
+        // Search
+        getSearchPersonsTool(client),
+        // Related entities
+        getListPersonDealsTool(client),
+        getListPersonActivitiesTool(client),
+        getListPersonFilesTool(client),
+        getListPersonProductsTool(client),
+        getListPersonMailMessagesTool(client),
+        // Followers
+        getAddPersonFollowerTool(client),
+        getListPersonFollowersTool(client),
+        getDeletePersonFollowerTool(client),
+        // Updates and changelog
+        getListPersonChangelogTool(client),
+        getListPersonFlowTool(client),
+        // Advanced operations
+        getMergePersonsTool(client),
+        getListPersonPermittedUsersTool(client),
+        // Picture management
+        getAddPersonPictureTool(client),
+        getDeletePersonPictureTool(client),
+    ];
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/persons/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,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,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO;QACL,sBAAsB;QACtB,kBAAkB,CAAC,MAAM,CAAC;QAC1B,yBAAyB,CAAC,MAAM,CAAC;QACjC,wBAAwB,CAAC,MAAM,CAAC;QAEhC,kBAAkB;QAClB,mBAAmB,CAAC,MAAM,CAAC;QAC3B,gBAAgB,CAAC,MAAM,CAAC;QACxB,mBAAmB,CAAC,MAAM,CAAC;QAC3B,mBAAmB,CAAC,MAAM,CAAC;QAC3B,wBAAwB,CAAC,MAAM,CAAC;QAEhC,SAAS;QACT,oBAAoB,CAAC,MAAM,CAAC;QAE5B,mBAAmB;QACnB,sBAAsB,CAAC,MAAM,CAAC;QAC9B,2BAA2B,CAAC,MAAM,CAAC;QACnC,sBAAsB,CAAC,MAAM,CAAC;QAC9B,yBAAyB,CAAC,MAAM,CAAC;QACjC,6BAA6B,CAAC,MAAM,CAAC;QAErC,YAAY;QACZ,wBAAwB,CAAC,MAAM,CAAC;QAChC,0BAA0B,CAAC,MAAM,CAAC;QAClC,2BAA2B,CAAC,MAAM,CAAC;QAEnC,wBAAwB;QACxB,0BAA0B,CAAC,MAAM,CAAC;QAClC,qBAAqB,CAAC,MAAM,CAAC;QAE7B,sBAAsB;QACtB,mBAAmB,CAAC,MAAM,CAAC;QAC3B,+BAA+B,CAAC,MAAM,CAAC;QAEvC,qBAAqB;QACrB,uBAAuB,CAAC,MAAM,CAAC;QAC/B,0BAA0B,CAAC,MAAM,CAAC;KACnC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,86 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+/**
+ * Tool for listing persons with pagination
+ */
+export declare function getListPersonsTool(client: PipedriveClient): {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly start: {
+                readonly type: "number";
+                readonly description: "Pagination start (default: 0)";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Items per page, max 500 (default: 100)";
+            };
+            readonly user_id: {
+                readonly type: "number";
+                readonly description: "Filter by owner user ID";
+            };
+            readonly org_id: {
+                readonly type: "number";
+                readonly description: "Filter by organization ID";
+            };
+            readonly first_char: {
+                readonly type: "string";
+                readonly description: "Filter by first character of name (e.g., \"A\", \"B\")";
+            };
+            readonly filter_id: {
+                readonly type: "number";
+                readonly description: "Filter ID to apply";
+            };
+            readonly sort: {
+                readonly type: "string";
+                readonly description: "Field to sort by (e.g., \"name\", \"email\")";
+            };
+        };
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Tool for auto-pagination to fetch all persons
+ */
+export declare function getListAllPersonsAutoTool(client: PipedriveClient): {
+    name: string;
+    description: string;
+    inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly user_id: {
+                readonly type: "number";
+                readonly description: "Filter by owner user ID";
+            };
+            readonly org_id: {
+                readonly type: "number";
+                readonly description: "Filter by organization ID";
+            };
+            readonly first_char: {
+                readonly type: "string";
+                readonly description: "Filter by first character of name (e.g., \"A\", \"B\")";
+            };
+            readonly filter_id: {
+                readonly type: "number";
+                readonly description: "Filter ID to apply";
+            };
+            readonly sort: {
+                readonly type: "string";
+                readonly description: "Field to sort by (e.g., \"name\", \"email\")";
+            };
+        };
+    };
+    handler: (params: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/tools/persons/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA6C9B,OAAO;;;;;;EA+BlC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAwCrC,OAAO;;;;;;EAwClC"}