@goxtechnologies/connectwise-psa-mcp 1.1.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * ConnectWise PSA MCP Server
+ *
+ * Self-contained MCP server providing 18 tools for ConnectWise Manage PSA.
+ * Bundles API discovery, execution (no truncation!), pagination, fast memory,
+ * composite queries, batch updates, and timesheet validation.
+ */
+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":";AAEA;;;;;;GAMG"}

package/dist/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * ConnectWise PSA MCP Server
+ *
+ * Self-contained MCP server providing 18 tools for ConnectWise Manage PSA.
+ * Bundles API discovery, execution (no truncation!), pagination, fast memory,
+ * composite queries, batch updates, and timesheet validation.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { loadEnv } from './services/load-env.js';
+// Import tool definitions and handlers
+import { discoveryTools, handleDiscoveryTool } from './tools/discovery.js';
+import { executionTools, handleExecutionTool } from './tools/execution.js';
+import { paginationTools, handlePaginationTool } from './tools/pagination.js';
+import { memoryTools, handleMemoryTool } from './tools/memory.js';
+import { compositeTools, handleCompositeTool } from './tools/composite.js';
+import { batchTools, handleBatchTool } from './tools/batch.js';
+import { validationTools, handleValidationTool } from './tools/validation.js';
+import { operationsTools, handleOperationsTool } from './tools/operations.js';
+// Aggregate all tools
+const allTools = [
+    ...discoveryTools,
+    ...executionTools,
+    ...paginationTools,
+    ...memoryTools,
+    ...compositeTools,
+    ...batchTools,
+    ...validationTools,
+    ...operationsTools,
+];
+// Map tool names to their handlers
+const toolHandlers = {};
+for (const tool of discoveryTools)
+    toolHandlers[tool.name] = handleDiscoveryTool;
+for (const tool of executionTools)
+    toolHandlers[tool.name] = handleExecutionTool;
+for (const tool of paginationTools)
+    toolHandlers[tool.name] = handlePaginationTool;
+for (const tool of memoryTools)
+    toolHandlers[tool.name] = handleMemoryTool;
+for (const tool of compositeTools)
+    toolHandlers[tool.name] = handleCompositeTool;
+for (const tool of batchTools)
+    toolHandlers[tool.name] = handleBatchTool;
+for (const tool of validationTools)
+    toolHandlers[tool.name] = handleValidationTool;
+for (const tool of operationsTools)
+    toolHandlers[tool.name] = handleOperationsTool;
+// Create MCP server
+const server = new Server({
+    name: 'connectwise-psa',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List all available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: allTools };
+});
+// Handle tool execution
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const handler = toolHandlers[name];
+    if (!handler) {
+        return {
+            content: [{ type: 'text', text: `Unknown tool: ${name}. Available tools: ${allTools.map(t => t.name).join(', ')}` }],
+            isError: true,
+        };
+    }
+    if (!configValid) {
+        return {
+            content: [{ type: 'text', text: `ConnectWise credentials not configured. Run /setup-connectwise to set your API keys.\n\nMissing: Check CW_API_URL, CW_COMPANY_ID, CW_PUBLIC_KEY, CW_PRIVATE_KEY.\nCredentials are stored at <plugin_root>/.env (or ~/.config/connectwise-psa/.env for CLI)` }],
+            isError: true,
+        };
+    }
+    try {
+        return await handler(name, (args || {}));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Error executing ${name}: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// Validate required environment variables — warn but don't crash
+// so the MCP server still registers tools (tools return errors when called)
+let configValid = true;
+function validateConfig() {
+    const required = ['CW_API_URL', 'CW_COMPANY_ID', 'CW_PUBLIC_KEY', 'CW_PRIVATE_KEY'];
+    const missing = required.filter((v) => !process.env[v] || process.env[v].startsWith('${'));
+    if (missing.length > 0) {
+        configValid = false;
+        console.error(`[connectwise-psa] Missing credentials: ${missing.join(', ')}\n` +
+            'Run /setup-connectwise to configure. Tools will return errors until credentials are set.');
+    }
+}
+// Start server
+async function main() {
+    loadEnv();
+    validateConfig();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is reserved for MCP protocol)
+    console.error(`ConnectWise PSA MCP Server v1.0.3 started with ${allTools.length} tools`);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/operations/analytics-extended.d.ts

@@ -0,0 +1,6 @@
+type Params = Record<string, unknown>;
+type Handler = (params: Params) => Promise<string>;
+/** All extended handlers keyed by name. Merged into the main registry by analytics.ts. */
+export declare const extendedHandlers: Record<string, Handler>;
+export {};
+//# sourceMappingURL=analytics-extended.d.ts.map

package/dist/operations/analytics-extended.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-extended.d.ts","sourceRoot":"","sources":["../../src/operations/analytics-extended.ts"],"names":[],"mappings":"AAMA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtC,KAAK,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AASnD,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,CAAC"}