@iamsamuelfraga/mcp-pipedrive 1.0.3

package/dist/tools/deals/update.js

@@ -0,0 +1,85 @@
+import { UpdateDealSchema, MoveDealStageSchema } from '../../schemas/deal.js';
+export function getUpdateDealTools(client) {
+    return {
+        'deals/update': {
+            description: `Update an existing deal.
+
+Updates one or more fields of an existing deal. Only provide fields you want to change.
+
+Workflow tips:
+- Only specify fields you want to update
+- Use deals/get first to see current values
+- Use deals/move_to_stage for simple stage changes
+- To mark as won/lost, update status field
+
+Common use cases:
+- Update value: { "id": 123, "value": 7500 }
+- Change title: { "id": 123, "title": "Updated Deal Name" }
+- Mark as won: { "id": 123, "status": "won" }
+- Update multiple fields: { "id": 123, "value": 10000, "expected_close_date": "2024-12-31", "probability": 75 }
+- Move to new stage: { "id": 123, "stage_id": 5 }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'number', description: 'ID of the deal to update' },
+                    title: { type: 'string', description: 'Deal title' },
+                    value: { type: 'number', description: 'Deal value' },
+                    currency: { type: 'string', description: '3-letter currency code' },
+                    user_id: { type: 'number', description: 'ID of the user who will own this deal' },
+                    person_id: { type: 'number', description: 'ID of the person' },
+                    org_id: { type: 'number', description: 'ID of the organization' },
+                    pipeline_id: { type: 'number', description: 'ID of the pipeline' },
+                    stage_id: { type: 'number', description: 'ID of the stage' },
+                    status: {
+                        type: 'string',
+                        enum: ['open', 'won', 'lost'],
+                        description: 'Deal status',
+                    },
+                    expected_close_date: {
+                        type: 'string',
+                        description: 'Expected close date in YYYY-MM-DD format',
+                    },
+                    probability: { type: 'number', description: 'Deal success probability (0-100)' },
+                    lost_reason: { type: 'string', description: 'Reason why the deal was lost' },
+                    visible_to: {
+                        type: 'string',
+                        enum: ['1', '3', '5', '7'],
+                        description: 'Visibility setting',
+                    },
+                },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const { id, ...updates } = UpdateDealSchema.parse(args);
+                return client.put(`/deals/${id}`, updates);
+            },
+        },
+        'deals/move_to_stage': {
+            description: `Move a deal to a different stage in the pipeline.
+
+Convenience tool to move a deal to another stage. Use this instead of deals/update when only changing stages.
+
+Workflow tips:
+- Use pipelines/list to get available stages
+- Moving stages may trigger automations in Pipedrive
+- Stage must be in the same pipeline or specify pipeline_id
+
+Common use cases:
+- Move to next stage: { "id": 123, "stage_id": 5 }
+- Move to won/lost stage: { "id": 123, "stage_id": 10 }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'number', description: 'ID of the deal to move' },
+                    stage_id: { type: 'number', description: 'ID of the stage to move the deal to' },
+                },
+                required: ['id', 'stage_id'],
+            },
+            handler: async (args) => {
+                const { id, stage_id } = MoveDealStageSchema.parse(args);
+                return client.put(`/deals/${id}`, { stage_id });
+            },
+        },
+    };
+}
+//# sourceMappingURL=update.js.map

package/dist/tools/deals/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/deals/update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,MAAM,UAAU,kBAAkB,CAAC,MAAuB;IACxD,OAAO;QACL,cAAc,EAAE;YACd,WAAW,EAAE;;;;;;;;;;;;;;;kDAe+B;YAC5C,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;oBAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;oBACpD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;oBACpD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;oBACnE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;oBACjF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;oBAC9D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;oBACjE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;oBAClE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;oBAC5D,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;wBAC7B,WAAW,EAAE,aAAa;qBAC3B;oBACD,mBAAmB,EAAE;wBACnB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,0CAA0C;qBACxD;oBACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAChF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;oBAC5E,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;wBAC1B,WAAW,EAAE,oBAAoB;qBAClC;iBACF;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxD,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YAC7C,CAAC;SACF;QAED,qBAAqB,EAAE;YACrB,WAAW,EAAE;;;;;;;;;;;wDAWqC;YAClD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;oBAC7D,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;iBACjF;gBACD,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;aAC7B;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzD,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClD,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/deals/updates.d.ts

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

package/dist/tools/deals/updates.d.ts.map

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

package/dist/tools/deals/updates.js

@@ -0,0 +1,96 @@
+import { GetDealSchema } from '../../schemas/deal.js';
+export function getUpdateTools(client) {
+    return {
+        'deals/list_field_updates': {
+            description: `List updates about deal field values (changelog).
+
+Returns the complete changelog of a deal, showing all field value changes over time.
+
+Workflow tips:
+- See who changed what and when
+- Useful for audit trails and compliance
+- Shows old and new values for each field
+- Includes timestamp and user information
+- Cached for 5 minutes
+
+Common use cases:
+- View full changelog: { "id": 123 }
+- Audit field changes for compliance
+- Track who updated deal value or stage
+- Understand deal modification history`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'number', description: 'ID of the deal' },
+                },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const { id } = GetDealSchema.parse(args);
+                return client.get(`/deals/${id}/changelog`, undefined, { enabled: true, ttl: 300000 });
+            },
+        },
+        'deals/list_updates': {
+            description: `List updates about a deal (flow).
+
+Returns a chronological list of all updates and activities related to a deal, including field changes, notes, emails, and other events.
+
+Workflow tips:
+- Shows complete activity feed for a deal
+- Includes field updates, notes, emails, and activities
+- Chronologically ordered
+- More comprehensive than changelog
+- Cached for 5 minutes
+
+Common use cases:
+- View deal activity feed: { "id": 123 }
+- See all interactions and changes
+- Track deal progression timeline
+- Review communication history`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'number', description: 'ID of the deal' },
+                },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const { id } = GetDealSchema.parse(args);
+                return client.get(`/deals/${id}/flow`, undefined, { enabled: true, ttl: 300000 });
+            },
+        },
+        'deals/list_participant_updates': {
+            description: `List updates about participants of a deal.
+
+Returns the changelog of participants added to or removed from a deal.
+
+Workflow tips:
+- Track when participants were added/removed
+- See who made participant changes
+- Useful for team collaboration tracking
+- Shows participant modification history
+- Cached for 5 minutes
+
+Common use cases:
+- View participant history: { "id": 123 }
+- Track team involvement over time
+- Audit participant changes
+- Understand collaboration patterns`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'number', description: 'ID of the deal' },
+                },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const { id } = GetDealSchema.parse(args);
+                return client.get(`/deals/${id}/participantsChangelog`, undefined, {
+                    enabled: true,
+                    ttl: 300000,
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=updates.js.map

package/dist/tools/deals/updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.js","sourceRoot":"","sources":["../../../src/tools/deals/updates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO;QACL,0BAA0B,EAAE;YAC1B,WAAW,EAAE;;;;;;;;;;;;;;;uCAeoB;YACjC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;iBACtD;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,EAAE,EAAE,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzC,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YACzF,CAAC;SACF;QAED,oBAAoB,EAAE;YACpB,WAAW,EAAE;;;;;;;;;;;;;;;+BAeY;YACzB,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;iBACtD;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,EAAE,EAAE,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzC,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YACpF,CAAC;SACF;QAED,gCAAgC,EAAE;YAChC,WAAW,EAAE;;;;;;;;;;;;;;;oCAeiB;YAC9B,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;iBACtD;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,EAAE,EAAE,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzC,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,wBAAwB,EAAE,SAAS,EAAE;oBACjE,OAAO,EAAE,IAAI;oBACb,GAAG,EAAE,MAAM;iBACZ,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/fields/activity-fields.d.ts

@@ -0,0 +1,13 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getListActivityFieldsTool(client: PipedriveClient): {
+    'fields/list_activity_fields': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=activity-fields.d.ts.map

package/dist/tools/fields/activity-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-fields.d.ts","sourceRoot":"","sources":["../../../src/tools/fields/activity-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;EAkChE"}

package/dist/tools/fields/activity-fields.js

@@ -0,0 +1,36 @@
+export function getListActivityFieldsTool(client) {
+    return {
+        'fields/list_activity_fields': {
+            description: `Get all field definitions for activities, including custom fields.
+
+Use this to discover what fields are available before creating or updating activities. Returns field keys, types, validation rules, and whether fields are required.
+
+Response includes:
+- Field ID and key (use key in API requests)
+- Field name and type (varchar, text, enum, date, time, etc.)
+- Validation info (mandatory, editable, searchable)
+- Options for enum/dropdown fields
+- Filtering and sorting capabilities
+
+Cached for 15 minutes as field definitions rarely change.
+
+Common use cases:
+- Discover custom fields before creating activities
+- Check field types and validation rules
+- Find field keys for API requests
+- Understand available enum options for activity fields`,
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                return client.get('/activityFields', undefined, {
+                    enabled: true,
+                    ttl: 900000, // 15 minutes
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=activity-fields.js.map

package/dist/tools/fields/activity-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-fields.js","sourceRoot":"","sources":["../../../src/tools/fields/activity-fields.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,yBAAyB,CAAC,MAAuB;IAC/D,OAAO;QACL,6BAA6B,EAAE;YAC7B,WAAW,EAAE;;;;;;;;;;;;;;;;;wDAiBqC;YAClD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;YACD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,OAAO,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,SAAS,EAAE;oBAC9C,OAAO,EAAE,IAAI;oBACb,GAAG,EAAE,MAAM,EAAE,aAAa;iBAC3B,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/fields/all-fields.d.ts

@@ -0,0 +1,19 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getListAllFieldsTool(client: PipedriveClient): {
+    'fields/list_all_fields': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<{
+            deal_fields: unknown;
+            person_fields: unknown;
+            organization_fields: unknown;
+            activity_fields: unknown;
+            product_fields: unknown;
+        }>;
+    };
+};
+//# sourceMappingURL=all-fields.d.ts.map

package/dist/tools/fields/all-fields.d.ts.map

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

package/dist/tools/fields/all-fields.js

@@ -0,0 +1,53 @@
+export function getListAllFieldsTool(client) {
+    return {
+        'fields/list_all_fields': {
+            description: `Get ALL field definitions across all entity types in a single call.
+
+This is a convenient aggregator that fetches field definitions for deals, persons, organizations, activities, and products in one request. Useful for getting a complete overview of all custom fields in your Pipedrive account.
+
+Returns an object with fields grouped by entity type:
+- deal_fields: All deal field definitions
+- person_fields: All person field definitions
+- organization_fields: All organization field definitions
+- activity_fields: All activity field definitions
+- product_fields: All product field definitions
+
+Each field includes:
+- Field ID, key, and name
+- Field type and validation rules
+- Options for enum fields
+- Flags: mandatory, editable, searchable, filterable, sortable
+
+Cached for 15 minutes as field definitions rarely change.
+
+Common use cases:
+- Get complete field overview across all entities
+- Build field mapping documentation
+- Audit custom fields setup
+- Prepare for data migration or integration`,
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                // Fetch all field types in parallel
+                const [dealFields, personFields, orgFields, activityFields, productFields] = await Promise.all([
+                    client.get('/dealFields', undefined, { enabled: true, ttl: 900000 }),
+                    client.get('/personFields', undefined, { enabled: true, ttl: 900000 }),
+                    client.get('/organizationFields', undefined, { enabled: true, ttl: 900000 }),
+                    client.get('/activityFields', undefined, { enabled: true, ttl: 900000 }),
+                    client.get('/productFields', undefined, { enabled: true, ttl: 900000 }),
+                ]);
+                return {
+                    deal_fields: dealFields,
+                    person_fields: personFields,
+                    organization_fields: orgFields,
+                    activity_fields: activityFields,
+                    product_fields: productFields,
+                };
+            },
+        },
+    };
+}
+//# sourceMappingURL=all-fields.js.map

package/dist/tools/fields/all-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"all-fields.js","sourceRoot":"","sources":["../../../src/tools/fields/all-fields.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,OAAO;QACL,wBAAwB,EAAE;YACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;4CAuByB;YACtC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;YACD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,oCAAoC;gBACpC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,CAAC,GACxE,MAAM,OAAO,CAAC,GAAG,CAAC;oBAChB,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;oBACpE,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;oBACtE,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;oBAC5E,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;oBACxE,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;iBACxE,CAAC,CAAC;gBAEL,OAAO;oBACL,WAAW,EAAE,UAAU;oBACvB,aAAa,EAAE,YAAY;oBAC3B,mBAAmB,EAAE,SAAS;oBAC9B,eAAe,EAAE,cAAc;oBAC/B,cAAc,EAAE,aAAa;iBAC9B,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/fields/deal-fields.d.ts

@@ -0,0 +1,13 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getListDealFieldsTool(client: PipedriveClient): {
+    'fields/list_deal_fields': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=deal-fields.d.ts.map

package/dist/tools/fields/deal-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deal-fields.d.ts","sourceRoot":"","sources":["../../../src/tools/fields/deal-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;EAkC5D"}

package/dist/tools/fields/deal-fields.js

@@ -0,0 +1,36 @@
+export function getListDealFieldsTool(client) {
+    return {
+        'fields/list_deal_fields': {
+            description: `Get all field definitions for deals, including custom fields.
+
+Use this to discover what fields are available before creating or updating deals. Returns field keys, types, validation rules, and whether fields are required.
+
+Response includes:
+- Field ID and key (use key in API requests)
+- Field name and type (varchar, text, enum, date, monetary, etc.)
+- Validation info (mandatory, editable, searchable)
+- Options for enum/dropdown fields
+- Filtering and sorting capabilities
+
+Cached for 15 minutes as field definitions rarely change.
+
+Common use cases:
+- Discover custom fields before creating deals
+- Check field types and validation rules
+- Find field keys for API requests
+- Understand available enum options`,
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                return client.get('/dealFields', undefined, {
+                    enabled: true,
+                    ttl: 900000, // 15 minutes
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=deal-fields.js.map

package/dist/tools/fields/deal-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deal-fields.js","sourceRoot":"","sources":["../../../src/tools/fields/deal-fields.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,OAAO;QACL,yBAAyB,EAAE;YACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;oCAiBiB;YAC9B,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;YACD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,OAAO,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE;oBAC1C,OAAO,EAAE,IAAI;oBACb,GAAG,EAAE,MAAM,EAAE,aAAa;iBAC3B,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/fields/get-field.d.ts

@@ -0,0 +1,23 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getGetFieldTool(client: PipedriveClient): {
+    'fields/get_field': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                entity_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                field_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=get-field.d.ts.map

package/dist/tools/fields/get-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-field.d.ts","sourceRoot":"","sources":["../../../src/tools/fields/get-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAUjE,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;wBAkC3B,OAAO;;EAoBlC"}

package/dist/tools/fields/get-field.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+const GetFieldSchema = z.object({
+    entity_type: z.enum(['deal', 'person', 'organization', 'activity', 'product'], {
+        description: 'Type of entity (deal, person, organization, activity, product)',
+    }),
+    field_id: z.number({ description: 'Field ID to retrieve' }),
+});
+export function getGetFieldTool(client) {
+    return {
+        'fields/get_field': {
+            description: `Get details of a specific field by ID and entity type.
+
+Retrieves complete information about a single field definition, including all validation rules, options, and metadata.
+
+Response includes:
+- Field ID, key, and name
+- Field type and validation rules
+- Options for enum fields
+- Flags: mandatory, editable, searchable, filterable, sortable, bulk_edit_allowed
+
+Cached for 15 minutes as field definitions rarely change.
+
+Common use cases:
+- Get specific field details: { "entity_type": "deal", "field_id": 12345 }
+- Check field validation rules before updating
+- Retrieve enum options for a dropdown field`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    entity_type: {
+                        type: 'string',
+                        enum: ['deal', 'person', 'organization', 'activity', 'product'],
+                        description: 'Type of entity (deal, person, organization, activity, product)',
+                    },
+                    field_id: {
+                        type: 'number',
+                        description: 'Field ID to retrieve',
+                    },
+                },
+                required: ['entity_type', 'field_id'],
+            },
+            handler: async (args) => {
+                const { entity_type, field_id } = GetFieldSchema.parse(args);
+                const endpointMap = {
+                    deal: 'dealFields',
+                    person: 'personFields',
+                    organization: 'organizationFields',
+                    activity: 'activityFields',
+                    product: 'productFields',
+                };
+                const endpoint = `/${endpointMap[entity_type]}/${field_id}`;
+                return client.get(endpoint, undefined, {
+                    enabled: true,
+                    ttl: 900000, // 15 minutes
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=get-field.js.map

package/dist/tools/fields/get-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-field.js","sourceRoot":"","sources":["../../../src/tools/fields/get-field.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;QAC7E,WAAW,EAAE,gEAAgE;KAC9E,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO;QACL,kBAAkB,EAAE;YAClB,WAAW,EAAE;;;;;;;;;;;;;;;6CAe0B;YACvC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,CAAC;wBAC/D,WAAW,EAAE,gEAAgE;qBAC9E;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,sBAAsB;qBACpC;iBACF;gBACD,QAAQ,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC;aACtC;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE7D,MAAM,WAAW,GAAG;oBAClB,IAAI,EAAE,YAAY;oBAClB,MAAM,EAAE,cAAc;oBACtB,YAAY,EAAE,oBAAoB;oBAClC,QAAQ,EAAE,gBAAgB;oBAC1B,OAAO,EAAE,eAAe;iBACzB,CAAC;gBAEF,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAE5D,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE;oBACrC,OAAO,EAAE,IAAI;oBACb,GAAG,EAAE,MAAM,EAAE,aAAa;iBAC3B,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}