salesflare-mcp-server 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Salesflare MCP Server - Main entry point
+ *
+ * Entry point for the Salesflare MCP Server application.
+ * Reads TRANSPORT environment variable, creates and configures the server,
+ * and starts the appropriate transport.
+ *
+ * Per D-09: Transport selection via TRANSPORT environment variable.
+ * Per D-06: Exits with code 1 on initialization failure.
+ *
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/index.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+/**
+ * Salesflare MCP Server - Main entry point
+ *
+ * Entry point for the Salesflare MCP Server application.
+ * Reads TRANSPORT environment variable, creates and configures the server,
+ * and starts the appropriate transport.
+ *
+ * Per D-09: Transport selection via TRANSPORT environment variable.
+ * Per D-06: Exits with code 1 on initialization failure.
+ *
+ * @module index
+ */
+import { createServer } from './server.js';
+import { startStdioServer } from './transport/stdio-transport.js';
+import { createHttpTransport } from './transport/http-transport.js';
+import { SalesflareError, formatErrorResponse, ErrorCode } from './utils/errors.js';
+/**
+ * Main entry point for the Salesflare MCP Server
+ *
+ * 1. Reads TRANSPORT environment variable (default: stdio)
+ * 2. Creates and configures the MCP server
+ * 3. Starts the appropriate transport
+ * 4. Handles errors gracefully with exit code 1 on failure
+ */
+async function main() {
+    try {
+        // Read TRANSPORT environment variable (default: stdio)
+        const transport = process.env.TRANSPORT || 'stdio';
+        // Log startup messages to stderr (never stdout to avoid protocol corruption)
+        console.error('Starting Salesflare MCP server...');
+        console.error(`Transport: ${transport}`);
+        // Create the MCP server
+        // This will validate auth and crash on startup if SALESFLARE_API_KEY is missing
+        const server = createServer({ transport: transport });
+        // Start the appropriate transport
+        if (transport === 'stdio') {
+            await startStdioServer({ server });
+        }
+        else if (transport === 'http') {
+            // HTTP transport with Express
+            await createHttpTransport({
+                port: parseInt(process.env.PORT || '3000', 10),
+                host: process.env.HOST || 'localhost',
+            });
+        }
+        else {
+            // Unknown transport
+            throw new SalesflareError({
+                code: ErrorCode.CONFIG_ERROR,
+                message: `Unknown transport: ${transport}`,
+                fix: 'Use "stdio" for CLI/inspector mode or "http" for HTTP transport (Phase 2)',
+                retryable: false,
+            });
+        }
+    }
+    catch (error) {
+        // Log full error to stderr
+        if (error instanceof SalesflareError) {
+            console.error(`\nError: ${error.message}`);
+            if (error.fix) {
+                console.error(`Fix: ${error.fix}`);
+            }
+        }
+        else if (error instanceof Error) {
+            console.error(`\nError: ${error.message}`);
+        }
+        else {
+            console.error('\nAn unknown error occurred');
+        }
+        // Format user-friendly error message
+        const errorResponse = formatErrorResponse(error);
+        console.error(`\n[${errorResponse.code}] ${errorResponse.message}`);
+        if (errorResponse.fix) {
+            console.error(`Fix: ${errorResponse.fix}`);
+        }
+        // Exit with code 1 on failure
+        process.exit(1);
+    }
+}
+// Run the main function
+main();

package/dist/server.d.ts

@@ -0,0 +1,39 @@
+/**
+ * MCP server setup for Salesflare MCP Server
+ *
+ * Creates and configures the MCP server with all tool registrations.
+ * Follows the server setup flow per D-19, D-20.
+ *
+ * @module server
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Server configuration options
+ */
+export interface ServerConfig {
+    /** Transport mode for the server (stdio or http) */
+    transport?: 'stdio' | 'http';
+}
+/**
+ * Create and configure the MCP server with all tools
+ *
+ * Initializes the server with:
+ * 1. Auth provider (API key from environment)
+ * 2. Salesflare API client
+ * 3. MCP server instance with tool capabilities
+ * 4. Registration of all entity tools
+ *
+ * Per D-06: Crashes on startup if SALESFLARE_API_KEY is missing.
+ *
+ * @param config - Optional server configuration
+ * @returns Configured MCP Server instance
+ * @throws {SalesflareError} If initialization fails or auth is missing
+ *
+ * @example
+ * ```typescript
+ * const server = createServer({ transport: 'stdio' });
+ * await server.connect(transport);
+ * ```
+ */
+export declare function createServer(config?: ServerConfig): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CA0G1D"}

package/dist/server.js

@@ -0,0 +1,140 @@
+/**
+ * MCP server setup for Salesflare MCP Server
+ *
+ * Creates and configures the MCP server with all tool registrations.
+ * Follows the server setup flow per D-19, D-20.
+ *
+ * @module server
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { createApiKeyAuth } from './auth/api-key-auth.js';
+import { createSalesflareClient } from './client/salesflare-client.js';
+import { contactTools, handleContactsTool } from './tools/contacts.js';
+import { companyTools, handleCompaniesTool } from './tools/companies.js';
+import { dealTools, handleDealsTool } from './tools/deals.js';
+import { taskTools, handleTasksTool } from './tools/tasks.js';
+import { pipelineTools, handlePipelineTool } from './tools/pipeline.js';
+import { SalesflareError, formatErrorResponse, ErrorCode } from './utils/errors.js';
+/**
+ * Create and configure the MCP server with all tools
+ *
+ * Initializes the server with:
+ * 1. Auth provider (API key from environment)
+ * 2. Salesflare API client
+ * 3. MCP server instance with tool capabilities
+ * 4. Registration of all entity tools
+ *
+ * Per D-06: Crashes on startup if SALESFLARE_API_KEY is missing.
+ *
+ * @param config - Optional server configuration
+ * @returns Configured MCP Server instance
+ * @throws {SalesflareError} If initialization fails or auth is missing
+ *
+ * @example
+ * ```typescript
+ * const server = createServer({ transport: 'stdio' });
+ * await server.connect(transport);
+ * ```
+ */
+export function createServer(config) {
+    try {
+        // Step 1: Create auth provider (reads SALESFLARE_API_KEY from env)
+        // Per D-06: This will throw if API key is missing
+        const auth = createApiKeyAuth();
+        // Step 2: Create API client with auth provider
+        const client = createSalesflareClient({ authProvider: auth });
+        // Step 3: Create MCP server instance
+        const server = new Server({
+            name: 'salesflare-mcp',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Step 4: Combine all tools
+        const allTools = [
+            ...contactTools,
+            ...companyTools,
+            ...dealTools,
+            ...taskTools,
+            ...pipelineTools,
+        ];
+        // Step 5: Register unified tool list handler
+        server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return { tools: allTools };
+        });
+        // Step 6: Register unified tool call handler
+        server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                // Dispatch to appropriate handler based on tool name prefix
+                if (name.startsWith('salesflare_contacts_')) {
+                    return await handleContactsTool(client, name, args);
+                }
+                else if (name.startsWith('salesflare_companies_')) {
+                    return await handleCompaniesTool(client, name, args);
+                }
+                else if (name.startsWith('salesflare_deals_')) {
+                    return await handleDealsTool(client, name, args);
+                }
+                else if (name.startsWith('salesflare_tasks_')) {
+                    return await handleTasksTool(client, name, args);
+                }
+                else if (name.startsWith('salesflare_pipeline_')) {
+                    return await handlePipelineTool(client, name, args);
+                }
+                else {
+                    throw new SalesflareError({
+                        code: ErrorCode.INVALID_INPUT,
+                        message: `Unknown tool: ${name}`,
+                        retryable: false,
+                    });
+                }
+            }
+            catch (error) {
+                if (error instanceof SalesflareError) {
+                    return { content: [{ type: 'text', text: error.toToolResponse() }] };
+                }
+                const formattedError = formatErrorResponse(error);
+                return { content: [{ type: 'text', text: formattedError.message }] };
+            }
+        });
+        // Step 7: Set up error handler
+        server.onerror = (error) => {
+            console.error('MCP Server error:', error);
+        };
+        return server;
+    }
+    catch (error) {
+        // Handle SalesflareError - re-throw with context
+        if (error instanceof SalesflareError) {
+            console.error(`Server initialization failed: ${error.message}`);
+            if (error.fix) {
+                console.error(`Fix: ${error.fix}`);
+            }
+            throw error;
+        }
+        // Handle generic errors - wrap in SalesflareError
+        if (error instanceof Error) {
+            const wrappedError = new SalesflareError({
+                code: ErrorCode.SERVER_ERROR,
+                message: `Failed to initialize MCP server: ${error.message}`,
+                fix: 'Check server configuration and ensure all dependencies are properly set up',
+                retryable: false,
+            });
+            console.error(wrappedError.message);
+            throw wrappedError;
+        }
+        // Handle unknown errors
+        const unknownError = new SalesflareError({
+            code: ErrorCode.SERVER_ERROR,
+            message: 'Failed to initialize MCP server: Unknown error occurred',
+            fix: 'Check server logs for details',
+            retryable: false,
+        });
+        console.error(unknownError.message);
+        throw unknownError;
+    }
+}

package/dist/tools/companies.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Company tools for Salesflare MCP Server
+ *
+ * Implements CRUD operations for companies:
+ * - salesflare_companies_list: List companies with filtering and pagination
+ * - salesflare_companies_create: Create new companies
+ * - salesflare_companies_update: Update existing companies
+ * - salesflare_companies_delete: Delete companies
+ *
+ * @module tools/companies
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { SalesflareClient } from '../client/salesflare-client.js';
+/**
+ * Company tool definitions with JSON schemas
+ */
+declare const companyTools: Tool[];
+/**
+ * Exported company tools array for unified registration
+ */
+export { companyTools };
+/**
+ * Handle company tool calls
+ *
+ * @param client - Salesflare API client
+ * @param name - Tool name
+ * @param args - Tool arguments
+ * @returns Tool response
+ */
+export declare function handleCompaniesTool(client: SalesflareClient, name: string, args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/**
+ * Register company-related tools with the MCP server
+ *
+ * @deprecated Use handleCompaniesTool instead for unified registration
+ * @param server - MCP Server instance
+ * @param client - Salesflare API client
+ */
+export declare function registerCompaniesTools(server: Server, client: SalesflareClient): void;
+//# sourceMappingURL=companies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"companies.d.ts","sourceRoot":"","sources":["../../src/tools/companies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;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,YAAY,EAAE,IAAI,EA6GvB,CAAC;AAEF;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,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,CAqB7D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAGrF"}