@iamsamuelfraga/mcp-pipedrive 1.0.3

package/dist/tools/leads/archived.js

@@ -0,0 +1,51 @@
+import { ListArchivedLeadsSchema } from '../../schemas/lead.js';
+export function getListArchivedLeadsTool(client) {
+    return {
+        'leads/list_archived': {
+            description: `List archived leads with pagination and filtering options.
+
+Returns a paginated list of archived leads. Archived leads are leads that have been
+moved out of the active Leads Inbox but not deleted or converted to deals.
+
+Workflow tips:
+- Archived leads are sorted by creation time (oldest to newest)
+- Use owner_id to filter by lead owner
+- Use person_id or organization_id to filter by associated entities
+- filter_id takes precedence over other filters
+- Use start/limit for pagination (default limit: 100, max: 500)
+- Archived leads can be restored to active status using leads/update
+
+Common use cases:
+- List all archived leads: {}
+- List archived leads for a specific owner: { "owner_id": 123 }
+- List archived leads for a person: { "person_id": 456 }
+- Review archived leads before deletion: { "limit": 50 }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    owner_id: { type: 'number', description: 'Filter by owner (user) ID' },
+                    person_id: { type: 'number', description: 'Filter by person ID' },
+                    organization_id: { type: 'number', description: 'Filter by organization ID' },
+                    filter_id: { type: 'number', description: 'ID of the filter to use' },
+                    sort: {
+                        type: 'string',
+                        description: 'Field names and sorting mode (e.g., "title ASC, value DESC")',
+                    },
+                    start: { type: 'number', description: 'Pagination start', default: 0 },
+                    limit: { type: 'number', description: 'Number of items to return', default: 100 },
+                },
+            },
+            handler: async (args) => {
+                const validated = ListArchivedLeadsSchema.parse(args);
+                const { start, limit, ...filters } = validated;
+                return client.get('/leads/archived', {
+                    ...filters,
+                    start: start ?? 0,
+                    limit: limit ?? 100,
+                }, { enabled: true, ttl: 300000 } // Cache for 5 minutes
+                );
+            },
+        },
+    };
+}
+//# sourceMappingURL=archived.js.map

package/dist/tools/leads/archived.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archived.js","sourceRoot":"","sources":["../../../src/tools/leads/archived.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,UAAU,wBAAwB,CAAC,MAAuB;IAC9D,OAAO;QACL,qBAAqB,EAAE;YACrB,WAAW,EAAE;;;;;;;;;;;;;;;;;yDAiBsC;YACnD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;oBACtE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;oBACjE,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;oBAC7E,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;oBACrE,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,8DAA8D;qBAC5E;oBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,EAAE;oBACtE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE,OAAO,EAAE,GAAG,EAAE;iBAClF;aACF;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACtD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS,CAAC;gBAE/C,OAAO,MAAM,CAAC,GAAG,CACf,iBAAiB,EACjB;oBACE,GAAG,OAAO;oBACV,KAAK,EAAE,KAAK,IAAI,CAAC;oBACjB,KAAK,EAAE,KAAK,IAAI,GAAG;iBACpB,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,sBAAsB;iBACtD,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,76 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getCreateLeadTool(client: PipedriveClient): {
+    'leads/create': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                title: {
+                    type: string;
+                    description: string;
+                };
+                owner_id: {
+                    type: string;
+                    description: string;
+                };
+                label_ids: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                person_id: {
+                    type: string;
+                    description: string;
+                };
+                organization_id: {
+                    type: string;
+                    description: string;
+                };
+                value: {
+                    type: string;
+                    properties: {
+                        amount: {
+                            type: string;
+                            description: string;
+                        };
+                        currency: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    description: string;
+                };
+                expected_close_date: {
+                    type: string;
+                    description: string;
+                };
+                visible_to: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                was_seen: {
+                    type: string;
+                    description: string;
+                };
+                origin_id: {
+                    type: string;
+                    description: string;
+                };
+                channel: {
+                    type: string;
+                    description: string;
+                };
+                channel_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=create.d.ts.map

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

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

package/dist/tools/leads/create.js

@@ -0,0 +1,76 @@
+import { CreateLeadSchema } from '../../schemas/lead.js';
+export function getCreateLeadTool(client) {
+    return {
+        'leads/create': {
+            description: `Create a new lead in Pipedrive.
+
+Creates a new lead with the specified information. A lead must be linked to a person or an organization (or both).
+All leads created through the API will have source_name "API" and origin "API".
+
+Workflow tips:
+- Title is required
+- Must have person_id, organization_id, or both
+- Use persons/search or organizations/search to get IDs
+- Value is optional but recommended (object with amount and currency)
+- Leads inherit custom fields structure from deals
+- Set expected_close_date in YYYY-MM-DD format
+- label_ids is an array of UUID strings
+
+Common use cases:
+- Simple lead: { "title": "New Lead", "person_id": 123 }
+- Lead with value: { "title": "Lead", "person_id": 123, "value": { "amount": 5000, "currency": "USD" } }
+- Lead with org: { "title": "Company Lead", "organization_id": 456 }
+- Full lead: { "title": "Big Lead", "person_id": 123, "organization_id": 456, "value": { "amount": 50000, "currency": "USD" }, "expected_close_date": "2024-12-31", "owner_id": 1 }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Lead title (required)' },
+                    owner_id: { type: 'number', description: 'ID of the user who will own this lead' },
+                    label_ids: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Array of label UUIDs',
+                    },
+                    person_id: {
+                        type: 'number',
+                        description: 'ID of the person this lead is associated with',
+                    },
+                    organization_id: {
+                        type: 'number',
+                        description: 'ID of the organization this lead is associated with',
+                    },
+                    value: {
+                        type: 'object',
+                        properties: {
+                            amount: { type: 'number', description: 'Lead value amount' },
+                            currency: { type: 'string', description: '3-letter currency code (e.g., USD, EUR)' },
+                        },
+                        description: 'Lead value with amount and currency',
+                    },
+                    expected_close_date: {
+                        type: 'string',
+                        description: 'Expected close date in YYYY-MM-DD format',
+                    },
+                    visible_to: {
+                        type: 'string',
+                        enum: ['1', '3', '5', '7'],
+                        description: "Visibility: 1=Owner, 3=Owner's group, 5=Owner's group and sub-groups, 7=Entire company",
+                    },
+                    was_seen: {
+                        type: 'boolean',
+                        description: 'Whether the lead was seen',
+                    },
+                    origin_id: { type: 'string', description: 'Origin ID for tracking' },
+                    channel: { type: 'number', description: 'Channel ID' },
+                    channel_id: { type: 'string', description: 'Channel identifier string' },
+                },
+                required: ['title'],
+            },
+            handler: async (args) => {
+                const validated = CreateLeadSchema.parse(args);
+                return client.post('/leads', validated);
+            },
+        },
+    };
+}
+//# sourceMappingURL=create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/leads/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,OAAO;QACL,cAAc,EAAE;YACd,WAAW,EAAE;;;;;;;;;;;;;;;;;;oLAkBiK;YAC9K,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;oBAC/D,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;oBAClF,SAAS,EAAE;wBACT,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,sBAAsB;qBACpC;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,+CAA+C;qBAC7D;oBACD,eAAe,EAAE;wBACf,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,qDAAqD;qBACnE;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;4BAC5D,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;yBACrF;wBACD,WAAW,EAAE,qCAAqC;qBACnD;oBACD,mBAAmB,EAAE;wBACnB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,0CAA0C;qBACxD;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;wBAC1B,WAAW,EACT,wFAAwF;qBAC3F;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,2BAA2B;qBACzC;oBACD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;oBACpE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;oBACtD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;iBACzE;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAC1C,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getDeleteLeadTool(client: PipedriveClient): {
+    'leads/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/leads/delete.d.ts.map

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

package/dist/tools/leads/delete.js

@@ -0,0 +1,37 @@
+import { DeleteLeadSchema } from '../../schemas/lead.js';
+export function getDeleteLeadTool(client) {
+    return {
+        'leads/delete': {
+            description: `Delete a specific lead from Pipedrive.
+
+Permanently deletes a lead by its UUID. This action cannot be undone.
+
+Workflow tips:
+- Lead ID must be a UUID
+- This permanently deletes the lead
+- Consider archiving instead (use leads/update with is_archived: true)
+- Returns the deleted lead's ID on success
+
+Common use cases:
+- Delete a lead: { "id": "adf21080-0e10-11eb-879b-05d71fb426ec" }
+
+Alternative:
+- Archive instead of delete: Use leads/update with { "id": "<uuid>", "is_archived": true }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: {
+                        type: 'string',
+                        description: 'UUID of the lead to delete',
+                    },
+                },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const validated = DeleteLeadSchema.parse(args);
+                return client.delete(`/leads/${validated.id}`);
+            },
+        },
+    };
+}
+//# sourceMappingURL=delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/leads/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,OAAO;QACL,cAAc,EAAE;YACd,WAAW,EAAE;;;;;;;;;;;;;;2FAcwE;YACrF,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,EAAE,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4BAA4B;qBAC1C;iBACF;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/C,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getGetLeadTool(client: PipedriveClient): {
+    'leads/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/leads/get.d.ts.map

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

package/dist/tools/leads/get.js

@@ -0,0 +1,36 @@
+import { GetLeadSchema } from '../../schemas/lead.js';
+export function getGetLeadTool(client) {
+    return {
+        'leads/get': {
+            description: `Get details of a specific lead by UUID.
+
+Returns detailed information about a single lead including all fields and custom field values.
+
+Workflow tips:
+- Lead IDs are UUIDs (not integers like other entities)
+- Use leads/search to find leads by title or other fields
+- Custom fields from deals are inherited by leads
+- Only set custom field values will appear in response
+
+Common use cases:
+- Get lead details: { "id": "adf21080-0e10-11eb-879b-05d71fb426ec" }
+- Retrieve lead for update: { "id": "<uuid>" }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: {
+                        type: 'string',
+                        description: 'UUID of the lead to retrieve',
+                    },
+                },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const validated = GetLeadSchema.parse(args);
+                return client.get(`/leads/${validated.id}`, {}, { enabled: true, ttl: 300000 } // Cache for 5 minutes
+                );
+            },
+        },
+    };
+}
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/tools/leads/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO;QACL,WAAW,EAAE;YACX,WAAW,EAAE;;;;;;;;;;;;+CAY4B;YACzC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,EAAE,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,8BAA8B;qBAC5C;iBACF;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5C,OAAO,MAAM,CAAC,GAAG,CACf,UAAU,SAAS,CAAC,EAAE,EAAE,EACxB,EAAE,EACF,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,sBAAsB;iBACtD,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}