salesflare-mcp-server 1.0.0

package/dist/tools/contacts.js

@@ -0,0 +1,290 @@
+/**
+ * Contact tools for Salesflare MCP Server
+ *
+ * Implements CRUD operations for contacts:
+ * - salesflare_contacts_list: List contacts with filtering and pagination
+ * - salesflare_contacts_create: Create new contacts
+ * - salesflare_contacts_update: Update existing contacts
+ * - salesflare_contacts_delete: Delete contacts
+ *
+ * @module tools/contacts
+ */
+import { SalesflareError, ErrorCode } from '../utils/errors.js';
+/**
+ * Contact tool definitions with Zod schemas
+ */
+const contactTools = [
+    {
+        name: 'salesflare_contacts_list',
+        description: 'List contacts from Salesflare CRM with optional filtering and pagination. ' +
+            'Supports filtering by email, name, company_id, tags, owner, domain, and search. ' +
+            'Returns paginated results with total count and has_more indicator.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                email: { type: 'string', description: 'Filter by exact email match' },
+                name: { type: 'string', description: 'Filter by name (partial match, case-insensitive)' },
+                company_id: { type: 'string', description: 'Filter by company ID (UUID)' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags' },
+                owner: { type: 'string', description: 'Filter by owner ID or name' },
+                domain: { type: 'string', description: 'Filter by email domain (partial match)' },
+                search: { type: 'string', description: 'Free-text search across contact fields' },
+                page: { type: 'number', description: 'Page number (default: 1)' },
+                limit: { type: 'number', description: 'Items per page (default: 20, max: 100)' },
+            },
+        },
+    },
+    {
+        name: 'salesflare_contacts_create',
+        description: 'Create a new contact in Salesflare CRM. ' +
+            'Email is required. Optional fields include name, phone, company_id, job_title, tags, and owner_id.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: "Contact's full name" },
+                email: { type: 'string', description: "Contact's email address (required)" },
+                phone: { type: 'string', description: "Contact's phone number" },
+                company_id: { type: 'string', description: 'Company ID to associate (UUID)' },
+                job_title: { type: 'string', description: 'Job title at the company' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Tags to assign' },
+                owner_id: { type: 'string', description: 'Owner/user ID to assign (UUID)' },
+            },
+            required: ['email'],
+        },
+    },
+    {
+        name: 'salesflare_contacts_update',
+        description: 'Update an existing contact in Salesflare CRM. ' +
+            'Requires contact_id. All other fields are optional - only provided fields will be updated.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                contact_id: { type: 'string', description: 'Contact UUID to update' },
+                name: { type: 'string', description: "Contact's full name" },
+                email: { type: 'string', description: "Contact's email address" },
+                phone: { type: 'string', description: "Contact's phone number" },
+                company_id: { type: 'string', description: 'Company ID to associate (UUID)' },
+                job_title: { type: 'string', description: 'Job title at the company' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Tags to assign' },
+                owner_id: { type: 'string', description: 'Owner/user ID to assign (UUID)' },
+            },
+            required: ['contact_id'],
+        },
+    },
+    {
+        name: 'salesflare_contacts_delete',
+        description: 'Delete a contact from Salesflare CRM. ' +
+            'Requires contact_id. This action cannot be undone.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                contact_id: { type: 'string', description: 'Contact UUID to delete' },
+            },
+            required: ['contact_id'],
+        },
+    },
+];
+/**
+ * Exported contact tools array for unified registration
+ */
+export { contactTools };
+/**
+ * Handle contact tool calls
+ *
+ * @param client - Salesflare API client
+ * @param name - Tool name
+ * @param args - Tool arguments
+ * @returns Tool response
+ */
+export async function handleContactsTool(client, name, args) {
+    switch (name) {
+        case 'salesflare_contacts_list':
+            return await handleListContacts(client, args);
+        case 'salesflare_contacts_create':
+            return await handleCreateContact(client, args);
+        case 'salesflare_contacts_update':
+            return await handleUpdateContact(client, args);
+        case 'salesflare_contacts_delete':
+            return await handleDeleteContact(client, args);
+        default:
+            throw new SalesflareError({
+                code: ErrorCode.INVALID_INPUT,
+                message: `Unknown contact tool: ${name}`,
+                retryable: false,
+            });
+    }
+}
+/**
+ * Register contact-related tools with the MCP server
+ *
+ * @deprecated Use handleContactsTool instead for unified registration
+ * @param server - MCP Server instance
+ * @param client - Salesflare API client
+ */
+export function registerContactsTools(server, client) {
+    // This function is deprecated - use unified tool registration in server.ts
+    // Kept for backward compatibility
+}
+/**
+ * Handle salesflare_contacts_list tool call
+ */
+async function handleListContacts(client, params) {
+    // Build query parameters from filters
+    const queryParams = {};
+    if (params.email)
+        queryParams.email = params.email;
+    if (params.name)
+        queryParams.name = params.name;
+    if (params.company_id)
+        queryParams.company_id = params.company_id;
+    if (params.tags && params.tags.length > 0)
+        queryParams.tags = params.tags.join(',');
+    if (params.owner)
+        queryParams.owner = params.owner;
+    if (params.domain)
+        queryParams.domain = params.domain;
+    if (params.search)
+        queryParams.search = params.search;
+    // Pagination
+    queryParams.page = Number(params.page) || 1;
+    queryParams.limit = Number(params.limit) || 20;
+    // Call Salesflare API
+    const response = await client.get('/contacts', { params: queryParams });
+    // Handle different response formats
+    const items = response.items || (Array.isArray(response) ? response : []);
+    const total = response.total ?? items.length;
+    const page = (response.page ?? Number(params.page)) || 1;
+    const limit = (response.limit ?? Number(params.limit)) || 20;
+    // Transform to curated response format
+    const contacts = items.map((item) => ({
+        id: item.id,
+        name: item.name,
+        email: item.email,
+        phone: item.phone,
+        company: item.company ? {
+            id: item.company.id,
+            name: item.company.name,
+        } : undefined,
+        job_title: item.job_title,
+        tags: item.tags,
+        owner: item.owner ? {
+            id: item.owner.id,
+            name: item.owner.name,
+        } : undefined,
+        created_at: item.created_at,
+        updated_at: item.updated_at,
+    }));
+    const listResponse = {
+        contacts,
+        total,
+        page,
+        limit,
+        has_more: page * limit < total,
+    };
+    // Generate human-readable summary
+    const summaryText = listResponse.contacts.length === 0
+        ? 'No contacts found matching the criteria.'
+        : `Found ${listResponse.total} contact(s). Showing page ${listResponse.page} with ${listResponse.contacts.length} result(s).` +
+            (listResponse.has_more ? ` More pages available.` : '');
+    return {
+        content: [
+            { type: 'text', text: summaryText },
+            { type: 'text', text: JSON.stringify(listResponse, null, 2) },
+        ],
+    };
+}
+/**
+ * Handle salesflare_contacts_create tool call
+ */
+async function handleCreateContact(client, params) {
+    // Call Salesflare API to create contact
+    const response = await client.post('/contacts', {
+        name: params.name,
+        email: params.email,
+        phone: params.phone,
+        company_id: params.company_id,
+        job_title: params.job_title,
+        tags: params.tags,
+        owner_id: params.owner_id,
+    });
+    // Transform to curated response format
+    const contact = {
+        id: response.id,
+        name: response.name,
+        email: response.email,
+        phone: response.phone,
+        company: response.company ? {
+            id: response.company.id,
+            name: response.company.name,
+        } : undefined,
+        job_title: response.job_title,
+        tags: response.tags,
+        owner: response.owner ? {
+            id: response.owner.id,
+            name: response.owner.name,
+        } : undefined,
+        created_at: response.created_at,
+        updated_at: response.updated_at,
+    };
+    return {
+        content: [
+            { type: 'text', text: `Contact created: ${contact.name || 'Unnamed'} (${contact.email})` },
+            { type: 'text', text: JSON.stringify(contact, null, 2) },
+        ],
+    };
+}
+/**
+ * Handle salesflare_contacts_update tool call
+ */
+async function handleUpdateContact(client, params) {
+    const { contact_id, ...updateData } = params;
+    // Check if at least one field is provided for update
+    const hasUpdateFields = Object.keys(updateData).length > 0;
+    if (!hasUpdateFields) {
+        return {
+            content: [
+                { type: 'text', text: 'Error [INVALID_INPUT]: At least one field must be provided for update.' },
+                { type: 'text', text: '{}' },
+            ],
+        };
+    }
+    // Call Salesflare API to update contact
+    const response = await client.patch(`/contacts/${contact_id}`, updateData);
+    // Transform to curated response format
+    const contact = {
+        id: response.id,
+        name: response.name,
+        email: response.email,
+        phone: response.phone,
+        company: response.company ? {
+            id: response.company.id,
+            name: response.company.name,
+        } : undefined,
+        job_title: response.job_title,
+        tags: response.tags,
+        owner: response.owner ? {
+            id: response.owner.id,
+            name: response.owner.name,
+        } : undefined,
+        created_at: response.created_at,
+        updated_at: response.updated_at,
+    };
+    return {
+        content: [
+            { type: 'text', text: `Contact updated: ${contact.name || 'Unnamed'} (${contact.email})` },
+            { type: 'text', text: JSON.stringify(contact, null, 2) },
+        ],
+    };
+}
+/**
+ * Handle salesflare_contacts_delete tool call
+ */
+async function handleDeleteContact(client, params) {
+    // Call Salesflare API to delete contact
+    await client.delete(`/contacts/${params.contact_id}`);
+    return {
+        content: [
+            { type: 'text', text: 'Contact deleted successfully.' },
+        ],
+    };
+}

package/dist/tools/deals.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Deal tools for Salesflare MCP Server
+ *
+ * Implements CRUD operations for deals:
+ * - salesflare_deals_list: List deals with filtering and pagination
+ * - salesflare_deals_create: Create new deals
+ * - salesflare_deals_update: Update existing deals
+ * - salesflare_deals_delete: Delete deals
+ * - salesflare_deals_move_stage: Move deals between pipeline stages
+ *
+ * @module tools/deals
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { SalesflareClient } from '../client/salesflare-client.js';
+/**
+ * Deal tool definitions with JSON schemas
+ */
+declare const dealTools: Tool[];
+/**
+ * Exported deal tools array for unified registration
+ */
+export { dealTools };
+/**
+ * Handle deal tool calls
+ *
+ * @param client - Salesflare API client
+ * @param name - Tool name
+ * @param args - Tool arguments
+ * @returns Tool response
+ */
+export declare function handleDealsTool(client: SalesflareClient, name: string, args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/**
+ * Register deal-related tools with the MCP server
+ *
+ * @deprecated Use handleDealsTool instead for unified registration
+ * @param server - MCP Server instance
+ * @param client - Salesflare API client
+ */
+export declare function registerDealsTools(server: Server, client: SalesflareClient): void;
+//# sourceMappingURL=deals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deals.d.ts","sourceRoot":"","sources":["../../src/tools/deals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAGL,IAAI,EACL,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AASlE;;GAEG;AACH,QAAA,MAAM,SAAS,EAAE,IAAI,EAgGpB,CAAC;AAEF;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAwB7D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAGjF"}