@nightsquawktech/tacticalrmm-mcp-server 0.1.0

package/dist/tools/read-tools.js

@@ -0,0 +1,51 @@
+import { formatApiError } from "../services/errors.js";
+import { formatResponse, makeToolResponse, paginate, summarizeRecord } from "./format.js";
+export function registerCollectionReadTool(server, client, options) {
+    server.registerTool(options.name, {
+        title: options.title,
+        description: options.description,
+        inputSchema: options.inputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const paging = params;
+            const raw = options.method === "query"
+                ? await client.query(options.path(params), options.body?.(params))
+                : await client.get(options.path(params), options.query?.(params));
+            const items = extractItems(raw);
+            const data = paginate(items, paging.limit, paging.offset);
+            const markdown = [
+                `# ${options.heading}`,
+                "",
+                `Showing ${data.count} of ${data.total} records.`,
+                "",
+                ...data.items.map((item) => `- ${summarizeRecord(item, options.preferredFields)}`)
+            ].join("\n");
+            return makeToolResponse(data, formatResponse(paging.response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+}
+export function extractItems(raw) {
+    if (Array.isArray(raw)) {
+        return raw;
+    }
+    if (raw && typeof raw === "object") {
+        const source = raw;
+        for (const key of ["results", "items", "data", "rows"]) {
+            if (Array.isArray(source[key])) {
+                return source[key];
+            }
+        }
+    }
+    return raw === undefined || raw === null ? [] : [raw];
+}
+//# sourceMappingURL=read-tools.js.map

package/dist/tools/read-tools.js.map

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

package/dist/tools/server.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { TacticalRmmClient } from "../services/tacticalrmm-client.js";
+export declare function registerServerTools(server: McpServer, client: TacticalRmmClient): void;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/tools/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAK3E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAwCtF"}

package/dist/tools/server.js

@@ -0,0 +1,42 @@
+import { formatApiError } from "../services/errors.js";
+import { ServerInfoSchema } from "../schemas/server.js";
+import { formatResponse, makeToolResponse } from "./format.js";
+export function registerServerTools(server, client) {
+    server.registerTool("tacticalrmm_get_server_info", {
+        title: "Get TacticalRMM Server Info",
+        description: "Read TacticalRMM server version and dashboard information from /core/version/ and /core/dashinfo/.",
+        inputSchema: ServerInfoSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ response_format }) => {
+        try {
+            const [version, dashboard] = await Promise.allSettled([
+                client.get("/core/version/"),
+                client.get("/core/dashinfo/")
+            ]);
+            const data = {
+                version: version.status === "fulfilled" ? version.value : { error: formatApiError(version.reason) },
+                dashboard: dashboard.status === "fulfilled" ? dashboard.value : { error: formatApiError(dashboard.reason) }
+            };
+            const markdown = [
+                "# TacticalRMM Server Info",
+                "",
+                `- Version: ${formatInline(data.version)}`,
+                `- Dashboard: ${formatInline(data.dashboard)}`
+            ].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+}
+function formatInline(value) {
+    return typeof value === "string" ? value : JSON.stringify(value);
+}
+//# sourceMappingURL=server.js.map

package/dist/tools/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/tools/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAyB;IAC9E,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,oGAAoG;QACjH,WAAW,EAAE,gBAAgB,CAAC,KAAK;QACnC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,eAAe,EAAmB,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;gBACpD,MAAM,CAAC,GAAG,CAAU,gBAAgB,CAAC;gBACrC,MAAM,CAAC,GAAG,CAAU,iBAAiB,CAAC;aACvC,CAAC,CAAC;YAEH,MAAM,IAAI,GAA4B;gBACpC,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;gBACnG,SAAS,EAAE,SAAS,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aAC5G,CAAC;YAEF,MAAM,QAAQ,GAAG;gBACf,2BAA2B;gBAC3B,EAAE;gBACF,cAAc,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;gBAC1C,gBAAgB,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;aAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,OAAO,gBAAgB,CAAC,IAAI,EAAE,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+export type TacticalRmmMethod = "GET" | "PATCH";
+export type ResponseFormat = "markdown" | "json";
+export interface TacticalRmmConfig {
+    baseUrl: string;
+    apiKey: string;
+    timeoutMs: number;
+}
+export interface PaginatedItems<T> {
+    [key: string]: unknown;
+    total: number;
+    count: number;
+    offset: number;
+    items: T[];
+    has_more: boolean;
+    next_offset?: number;
+}
+export interface ToolResponse<T extends Record<string, unknown>> {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: T;
+    isError?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,OAAO,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,EAAE,CAAC,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@nightsquawktech/tacticalrmm-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for self-hosted TacticalRMM instances.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "COMMERCIAL.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "clean": "rimraf dist"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "axios": "^1.13.2",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0"
+  },
+  "license": "AGPL-3.0-only",
+  "author": "Kevin Reyes (NightSquawk Tech) <hello@nightsquawk.tech>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NightSquawk/tacticalrmm-mcp-server.git"
+  },
+  "homepage": "https://github.com/NightSquawk/tacticalrmm-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/NightSquawk/tacticalrmm-mcp-server/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}