syncromsp-mcp 0.1.0

package/dist/utils/pagination.js

@@ -0,0 +1,18 @@
+export function addPaginationParams(params, pagination) {
+    if (pagination?.page !== undefined) {
+        params.set("page", String(pagination.page));
+    }
+}
+export function formatPaginationInfo(meta) {
+    if (!meta)
+        return "";
+    const parts = [];
+    if (meta.page !== undefined)
+        parts.push(`Page ${meta.page}`);
+    if (meta.total_pages !== undefined)
+        parts.push(`of ${meta.total_pages}`);
+    if (meta.total_entries !== undefined)
+        parts.push(`(${meta.total_entries} total)`);
+    return parts.length > 0 ? `\n---\n${parts.join(" ")}` : "";
+}
+//# sourceMappingURL=pagination.js.map

package/dist/utils/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,mBAAmB,CACjC,MAAuB,EACvB,UAA6B;IAE7B,IAAI,UAAU,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AASD,MAAM,UAAU,oBAAoB,CAAC,IAAgC;IACnE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACzE,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,SAAS,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,15 @@
+export declare class RateLimiter {
+    private readonly timeoutMs;
+    private tokens;
+    private lastRefill;
+    private readonly maxTokens;
+    private readonly refillRate;
+    private readonly queue;
+    constructor(maxPerMinute?: number, timeoutMs?: number);
+    private refill;
+    acquire(): Promise<void>;
+    private processTimeout;
+    private scheduleProcess;
+    private processQueue;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IAWkB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAVlE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAId;gBAEI,YAAY,GAAE,MAAY,EAAmB,SAAS,GAAE,MAAc;IAOlF,OAAO,CAAC,MAAM;IAQR,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB9B,OAAO,CAAC,cAAc,CAA8C;IAEpE,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,YAAY;CAYrB"}

package/dist/utils/rate-limiter.js

@@ -0,0 +1,63 @@
+export class RateLimiter {
+    timeoutMs;
+    tokens;
+    lastRefill;
+    maxTokens;
+    refillRate; // tokens per ms
+    queue = [];
+    constructor(maxPerMinute = 180, timeoutMs = 30000) {
+        this.timeoutMs = timeoutMs;
+        this.maxTokens = maxPerMinute;
+        this.tokens = maxPerMinute;
+        this.refillRate = maxPerMinute / 60000;
+        this.lastRefill = Date.now();
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const newTokens = elapsed * this.refillRate;
+        this.tokens = Math.min(this.maxTokens, this.tokens + newTokens);
+        this.lastRefill = now;
+    }
+    async acquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                const idx = this.queue.findIndex((item) => item.resolve === resolve);
+                if (idx !== -1) {
+                    this.queue.splice(idx, 1);
+                }
+                reject(new Error("Rate limit timeout: request queued for too long"));
+            }, this.timeoutMs);
+            this.queue.push({ resolve, reject, timer });
+            this.scheduleProcess();
+        });
+    }
+    processTimeout = null;
+    scheduleProcess() {
+        if (this.processTimeout !== null)
+            return;
+        const waitMs = Math.ceil(1 / this.refillRate);
+        this.processTimeout = setTimeout(() => {
+            this.processTimeout = null;
+            this.processQueue();
+        }, waitMs);
+    }
+    processQueue() {
+        this.refill();
+        while (this.queue.length > 0 && this.tokens >= 1) {
+            const item = this.queue.shift();
+            clearTimeout(item.timer);
+            this.tokens -= 1;
+            item.resolve();
+        }
+        if (this.queue.length > 0) {
+            this.scheduleProcess();
+        }
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

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

package/dist/utils/validators.d.ts

@@ -0,0 +1,9 @@
+export declare function requireNumber(value: unknown, name: string): number;
+export declare function requireString(value: unknown, name: string): string;
+export declare function requireId(value: unknown, name?: string): number;
+export declare function optionalString(value: unknown): string | undefined;
+export declare function optionalNumber(value: unknown): number | undefined;
+export declare function optionalBoolean(value: unknown): boolean | undefined;
+export declare function optionalId(value: unknown): number | undefined;
+export declare function pickDefined(obj: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=validators.d.ts.map

package/dist/utils/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAa,GAAG,MAAM,CAMrE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKjE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIjE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAInE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK7D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQjF"}

package/dist/utils/validators.js

@@ -0,0 +1,59 @@
+export function requireNumber(value, name) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new Error(`${name} must be a valid number`);
+    }
+    return value;
+}
+export function requireString(value, name) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${name} must be a non-empty string`);
+    }
+    return value.trim();
+}
+export function requireId(value, name = "id") {
+    const num = requireNumber(value, name);
+    if (!Number.isInteger(num) || num <= 0) {
+        throw new Error(`${name} must be a positive integer`);
+    }
+    return num;
+}
+export function optionalString(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+export function optionalNumber(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return undefined;
+    return value;
+}
+export function optionalBoolean(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "boolean")
+        return undefined;
+    return value;
+}
+export function optionalId(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    const num = optionalNumber(value);
+    if (num !== undefined && Number.isInteger(num) && num > 0)
+        return num;
+    return undefined;
+}
+export function pickDefined(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=validators.js.map

package/dist/utils/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,IAAY;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,yBAAyB,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,IAAY;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6BAA6B,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,OAAe,IAAI;IAC3D,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6BAA6B,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACtE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAA4B;IACtD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/version-check.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Non-blocking version check on startup. Logs a warning to stderr
+ * if a newer version is available. Never throws — silently fails
+ * on network errors, timeouts, etc.
+ */
+export declare function checkForUpdates(): void;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/utils/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/utils/version-check.ts"],"names":[],"mappings":"AA+BA;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,IAAI,CA+BtC"}

package/dist/utils/version-check.js

@@ -0,0 +1,59 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+function getCurrentVersion() {
+    try {
+        // Try reading from package.json relative to this file
+        const dir = dirname(fileURLToPath(import.meta.url));
+        const pkgPath = join(dir, "..", "..", "package.json");
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function compareVersions(current, latest) {
+    const c = current.replace(/^v/, "").split(".").map(Number);
+    const l = latest.replace(/^v/, "").split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((c[i] || 0) < (l[i] || 0))
+            return -1;
+        if ((c[i] || 0) > (l[i] || 0))
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Non-blocking version check on startup. Logs a warning to stderr
+ * if a newer version is available. Never throws — silently fails
+ * on network errors, timeouts, etc.
+ */
+export function checkForUpdates() {
+    const currentVersion = getCurrentVersion();
+    if (currentVersion === "0.0.0")
+        return;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    fetch("https://api.github.com/repos/advenimus/syncromsp-mcp/releases/latest", {
+        headers: { Accept: "application/vnd.github+json" },
+        signal: controller.signal,
+    })
+        .then((res) => (res.ok ? res.json() : null))
+        .then((release) => {
+        if (!release)
+            return;
+        const latestVersion = release.tag_name.replace(/^v/, "");
+        if (compareVersions(currentVersion, latestVersion) < 0) {
+            console.error(`\n⚠ SyncroMSP MCP v${latestVersion} is available (you have v${currentVersion}).` +
+                `\n  Update: ${release.html_url}` +
+                `\n  npx: npx syncromsp-mcp@latest` +
+                `\n  Docker: docker compose pull && docker compose up -d\n`);
+        }
+    })
+        .catch(() => {
+        // Silently ignore — network errors, rate limits, etc.
+    })
+        .finally(() => clearTimeout(timeout));
+}
+//# sourceMappingURL=version-check.js.map

package/dist/utils/version-check.js.map

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

package/manifest.json

@@ -0,0 +1,64 @@
+{
+  "manifest_version": "0.3",
+  "name": "syncromsp-mcp",
+  "display_name": "SyncroMSP MCP Server",
+  "version": "0.1.0",
+  "description": "MCP server for SyncroMSP — tickets, customers, assets, invoices, and 30+ resource types for AI assistants",
+  "long_description": "A fully-featured Model Context Protocol server for the SyncroMSP IT/MSP platform. Provides AI assistants with access to 170 API endpoints across 15 domains using a lazy-loaded navigation pattern that keeps token usage efficient. Supports full CRUD for tickets, customers, invoices, estimates, appointments, products, RMM alerts, and more.",
+  "author": {
+    "name": "Advenimus",
+    "url": "https://github.com/advenimus"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/advenimus/syncromsp-mcp"
+  },
+  "homepage": "https://github.com/advenimus/syncromsp-mcp",
+  "license": "MIT",
+  "keywords": [
+    "syncro",
+    "syncromsp",
+    "msp",
+    "rmm",
+    "psa",
+    "it-management",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/dist/index.js"],
+      "env": {
+        "SYNCRO_API_KEY": "${user_config.syncro_api_key}",
+        "SYNCRO_SUBDOMAIN": "${user_config.syncro_subdomain}"
+      }
+    }
+  },
+  "tools_generated": true,
+  "user_config": {
+    "syncro_api_key": {
+      "type": "string",
+      "title": "Syncro API Key",
+      "description": "Your Syncro API key (found in Admin > API Tokens)",
+      "sensitive": true,
+      "required": true
+    },
+    "syncro_subdomain": {
+      "type": "string",
+      "title": "Syncro Subdomain",
+      "description": "Your Syncro subdomain (e.g., 'mycompany' from mycompany.syncromsp.com)",
+      "sensitive": false,
+      "required": true
+    }
+  },
+  "compatibility": {
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "node": ">=20.0.0"
+    },
+    "claude_desktop": ">=0.10.0"
+  }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "syncromsp-mcp",
+  "version": "0.1.0",
+    "description": "MCP server for SyncroMSP — full API coverage for tickets, customers, assets, invoices, and 30+ resource types",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "syncromsp-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "manifest.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build",
+    "validate:mcpb": "mcpb validate manifest.json"
+  },
+  "keywords": [
+    "mcp",
+    "syncro",
+    "syncromsp",
+    "msp",
+    "rmm",
+    "psa",
+    "it-management",
+    "model-context-protocol"
+  ],
+  "author": "Advenimus",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/advenimus/syncromsp-mcp.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "express": "^5.2.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.15.2",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.2"
+  }
+}