@nightsquawktech/tacticalrmm-mcp-server 0.1.0

package/dist/tools/agents.js

@@ -0,0 +1,97 @@
+import { AgentIdSchema, ListAgentsSchema } from "../schemas/agents.js";
+import { formatApiError } from "../services/errors.js";
+import { formatResponse, makeToolResponse, paginate, summarizeRecord } from "./format.js";
+export function registerAgentTools(server, client) {
+    server.registerTool("tacticalrmm_list_agents", {
+        title: "List TacticalRMM Agents",
+        description: "List agents visible to the TacticalRMM API key from /agents/ with optional client, site, monitoring_type, and detail filters.",
+        inputSchema: ListAgentsSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const agents = await client.get("/agents/", {
+                detail: params.detail ? "true" : "false",
+                ...(params.client ? { client: params.client } : {}),
+                ...(params.site ? { site: params.site } : {}),
+                ...(params.monitoring_type ? { monitoring_type: params.monitoring_type } : {})
+            });
+            const data = paginate(agents, params.limit, params.offset);
+            const markdown = [
+                "# TacticalRMM Agents",
+                "",
+                `Showing ${data.count} of ${data.total} agents.`,
+                "",
+                ...data.items.map((item) => `- ${summarizeRecord(item, ["agent_id", "hostname", "client_name", "site_name", "status", "plat"])}`)
+            ].join("\n");
+            return makeToolResponse(data, formatResponse(params.response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    server.registerTool("tacticalrmm_get_agent", {
+        title: "Get TacticalRMM Agent",
+        description: "Get one TacticalRMM agent record by agent_id from /agents/<agent_id>/. This tool is read-only.",
+        inputSchema: AgentIdSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ agent_id, response_format }) => {
+        try {
+            const agent = await client.get(`/agents/${encodeURIComponent(agent_id)}/`);
+            const data = { agent };
+            const markdown = [
+                "# TacticalRMM Agent",
+                "",
+                summarizeRecord(agent, ["agent_id", "hostname", "client_name", "site_name", "status", "plat"])
+            ].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    server.registerTool("tacticalrmm_list_agent_software", {
+        title: "List TacticalRMM Agent Software",
+        description: "List software inventory for a TacticalRMM agent from /software/<agent_id>/. This tool is read-only.",
+        inputSchema: AgentIdSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ agent_id, response_format }) => {
+        try {
+            const software = await client.get(`/software/${encodeURIComponent(agent_id)}/`);
+            const data = {
+                agent_id,
+                total: software.length,
+                software
+            };
+            const markdown = [
+                "# TacticalRMM Agent Software",
+                "",
+                `Found ${software.length} software records for ${agent_id}.`,
+                "",
+                ...software.slice(0, 100).map((item) => `- ${summarizeRecord(item, ["name", "version", "publisher", "install_date"])}`)
+            ].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+}
+//# sourceMappingURL=agents.js.map

package/dist/tools/agents.js.map

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

package/dist/tools/automation.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 registerAutomationTools(server: McpServer, client: TacticalRmmClient): void;
+//# sourceMappingURL=automation.d.ts.map

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

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

package/dist/tools/automation.js

@@ -0,0 +1,41 @@
+import { AgentResourceSchema, ListResourcesSchema } from "../schemas/resources.js";
+import { registerCollectionReadTool } from "./read-tools.js";
+export function registerAutomationTools(server, client) {
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_tasks",
+        title: "List TacticalRMM Tasks",
+        description: "List TacticalRMM automated tasks from /tasks/. This tool is read-only and does not run tasks.",
+        inputSchema: ListResourcesSchema.shape,
+        path: () => "/tasks/",
+        preferredFields: ["id", "name", "agent", "agent_hostname", "enabled", "last_run"],
+        heading: "TacticalRMM Tasks"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_agent_tasks",
+        title: "List TacticalRMM Agent Tasks",
+        description: "List automated tasks assigned to one TacticalRMM agent from /agents/<agent_id>/tasks/. This tool is read-only.",
+        inputSchema: AgentResourceSchema.shape,
+        path: (params) => `/agents/${encodeURIComponent(String(params.agent_id))}/tasks/`,
+        preferredFields: ["id", "name", "enabled", "last_run", "task_result"],
+        heading: "TacticalRMM Agent Tasks"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_scripts",
+        title: "List TacticalRMM Scripts",
+        description: "List scripts from the TacticalRMM script library at /scripts/. This tool is read-only and does not run scripts.",
+        inputSchema: ListResourcesSchema.shape,
+        path: () => "/scripts/",
+        preferredFields: ["id", "name", "shell", "script_type", "category", "description"],
+        heading: "TacticalRMM Scripts"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_policies",
+        title: "List TacticalRMM Policies",
+        description: "List automation policies from /automation/policies/. This tool is read-only.",
+        inputSchema: ListResourcesSchema.shape,
+        path: () => "/automation/policies/",
+        preferredFields: ["id", "name", "desc", "enabled"],
+        heading: "TacticalRMM Policies"
+    });
+}
+//# sourceMappingURL=automation.js.map

package/dist/tools/automation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.js","sourceRoot":"","sources":["../../src/tools/automation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAyB;IAClF,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,+FAA+F;QAC5G,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;QACrB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,CAAC;QACjF,OAAO,EAAE,mBAAmB;KAC7B,CAAC,CAAC;IAEH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,8BAA8B;QACpC,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,gHAAgH;QAC7H,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS;QACjF,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,CAAC;QACrE,OAAO,EAAE,yBAAyB;KACnC,CAAC,CAAC;IAEH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,iHAAiH;QAC9H,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,GAAG,EAAE,CAAC,WAAW;QACvB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,CAAC;QAClF,OAAO,EAAE,qBAAqB;KAC/B,CAAC,CAAC;IAEH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,GAAG,EAAE,CAAC,uBAAuB;QACnC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;QAClD,OAAO,EAAE,sBAAsB;KAChC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/clients.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 registerClientTools(server: McpServer, client: TacticalRmmClient): void;
+//# sourceMappingURL=clients.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/tools/clients.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,CAiCtF"}

package/dist/tools/clients.js

@@ -0,0 +1,34 @@
+import { formatApiError } from "../services/errors.js";
+import { ListClientsSchema } from "../schemas/clients.js";
+import { formatResponse, makeToolResponse, paginate, summarizeRecord } from "./format.js";
+export function registerClientTools(server, client) {
+    server.registerTool("tacticalrmm_list_clients", {
+        title: "List TacticalRMM Clients",
+        description: "List clients visible to the TacticalRMM API key from /clients/. This tool is read-only.",
+        inputSchema: ListClientsSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ limit, offset, response_format }) => {
+        try {
+            const clients = await client.get("/clients/");
+            const data = paginate(clients, limit, offset);
+            const markdown = [
+                "# TacticalRMM Clients",
+                "",
+                `Showing ${data.count} of ${data.total} clients.`,
+                "",
+                ...data.items.map((item) => `- ${summarizeRecord(item, ["id", "name"])}`)
+            ].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+}
+//# sourceMappingURL=clients.js.map

package/dist/tools/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/tools/clients.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAyB,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1F,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAyB;IAC9E,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,yFAAyF;QACtG,WAAW,EAAE,iBAAiB,CAAC,KAAK;QACpC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAoB,EAAE,EAAE;QAC7D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAY,WAAW,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG;gBACf,uBAAuB;gBACvB,EAAE;gBACF,WAAW,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,WAAW;gBACjD,EAAE;gBACF,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;aAC1E,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"}

package/dist/tools/format.d.ts

@@ -0,0 +1,6 @@
+import type { PaginatedItems, ResponseFormat, ToolResponse } from "../types.js";
+export declare function paginate<T>(items: T[], limit: number, offset: number): PaginatedItems<T>;
+export declare function makeToolResponse<T extends Record<string, unknown>>(data: T, text: string, isError?: boolean): ToolResponse<T>;
+export declare function formatResponse<T>(format: ResponseFormat, data: T, markdown: string): string;
+export declare function summarizeRecord(record: unknown, preferredFields: string[]): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/tools/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAYxF;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAU3H;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,CAWlF"}

package/dist/tools/format.js

@@ -0,0 +1,37 @@
+import { RESPONSE_CHARACTER_LIMIT } from "../constants.js";
+export function paginate(items, limit, offset) {
+    const pageItems = items.slice(offset, offset + limit);
+    const hasMore = offset + pageItems.length < items.length;
+    return {
+        total: items.length,
+        count: pageItems.length,
+        offset,
+        items: pageItems,
+        has_more: hasMore,
+        ...(hasMore ? { next_offset: offset + pageItems.length } : {})
+    };
+}
+export function makeToolResponse(data, text, isError = false) {
+    const responseText = text.length > RESPONSE_CHARACTER_LIMIT
+        ? `${text.slice(0, RESPONSE_CHARACTER_LIMIT)}\n\nResponse truncated at ${RESPONSE_CHARACTER_LIMIT} characters. Use filters or a smaller limit.`
+        : text;
+    return {
+        content: [{ type: "text", text: responseText }],
+        structuredContent: data,
+        ...(isError ? { isError: true } : {})
+    };
+}
+export function formatResponse(format, data, markdown) {
+    return format === "json" ? JSON.stringify(data, null, 2) : markdown;
+}
+export function summarizeRecord(record, preferredFields) {
+    if (!record || typeof record !== "object") {
+        return String(record);
+    }
+    const source = record;
+    const fields = preferredFields
+        .filter((field) => source[field] !== undefined && source[field] !== null && source[field] !== "")
+        .map((field) => `${field}: ${String(source[field])}`);
+    return fields.length > 0 ? fields.join(", ") : JSON.stringify(record);
+}
+//# sourceMappingURL=format.js.map

package/dist/tools/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/tools/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,MAAM,UAAU,QAAQ,CAAI,KAAU,EAAE,KAAa,EAAE,MAAc;IACnE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAEzD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,KAAK,EAAE,SAAS,CAAC,MAAM;QACvB,MAAM;QACN,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,OAAO;QACjB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAoC,IAAO,EAAE,IAAY,EAAE,OAAO,GAAG,KAAK;IACxG,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,GAAG,wBAAwB;QACzD,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,CAAC,6BAA6B,wBAAwB,8CAA8C;QAC/I,CAAC,CAAC,IAAI,CAAC;IAET,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAC/C,iBAAiB,EAAE,IAAI;QACvB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAI,MAAsB,EAAE,IAAO,EAAE,QAAgB;IACjF,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAe,EAAE,eAAyB;IACxE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,MAAM,MAAM,GAAG,eAAe;SAC3B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;SAChG,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAExD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC"}

package/dist/tools/index.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 registerTools(server: McpServer, client: TacticalRmmClient): void;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/tools/index.js

@@ -0,0 +1,17 @@
+import { registerAgentTools } from "./agents.js";
+import { registerAutomationTools } from "./automation.js";
+import { registerClientTools } from "./clients.js";
+import { registerInventoryTools } from "./inventory.js";
+import { registerLogTools } from "./logs.js";
+import { registerMonitoringTools } from "./monitoring.js";
+import { registerServerTools } from "./server.js";
+export function registerTools(server, client) {
+    registerServerTools(server, client);
+    registerClientTools(server, client);
+    registerAgentTools(server, client);
+    registerInventoryTools(server, client);
+    registerMonitoringTools(server, client);
+    registerAutomationTools(server, client);
+    registerLogTools(server, client);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,MAAyB;IACxE,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/tools/inventory.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 registerInventoryTools(server: McpServer, client: TacticalRmmClient): void;
+//# sourceMappingURL=inventory.d.ts.map

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

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

package/dist/tools/inventory.js

@@ -0,0 +1,32 @@
+import { AgentResourceSchema, ListResourcesSchema } from "../schemas/resources.js";
+import { registerCollectionReadTool } from "./read-tools.js";
+export function registerInventoryTools(server, client) {
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_sites",
+        title: "List TacticalRMM Sites",
+        description: "List TacticalRMM sites from /clients/sites/. This tool is read-only.",
+        inputSchema: ListResourcesSchema.shape,
+        path: () => "/clients/sites/",
+        preferredFields: ["id", "name", "client", "client_name"],
+        heading: "TacticalRMM Sites"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_agent_services",
+        title: "List TacticalRMM Agent Services",
+        description: "List Windows service inventory for an agent from /services/<agent_id>/. This tool is read-only.",
+        inputSchema: AgentResourceSchema.shape,
+        path: (params) => `/services/${encodeURIComponent(String(params.agent_id))}/`,
+        preferredFields: ["name", "display_name", "status", "start_type", "username"],
+        heading: "TacticalRMM Agent Services"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_win_updates",
+        title: "List TacticalRMM Windows Updates",
+        description: "List Windows Update inventory for an agent from /winupdate/<agent_id>/. This tool is read-only and does not scan or install updates.",
+        inputSchema: AgentResourceSchema.shape,
+        path: (params) => `/winupdate/${encodeURIComponent(String(params.agent_id))}/`,
+        preferredFields: ["title", "kb", "severity", "installed", "approved", "status"],
+        heading: "TacticalRMM Windows Updates"
+    });
+}
+//# sourceMappingURL=inventory.js.map

package/dist/tools/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../../src/tools/inventory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAyB;IACjF,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,sEAAsE;QACnF,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,GAAG,EAAE,CAAC,iBAAiB;QAC7B,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC;QACxD,OAAO,EAAE,mBAAmB;KAC7B,CAAC,CAAC;IAEH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,iCAAiC;QACvC,KAAK,EAAE,iCAAiC;QACxC,WAAW,EAAE,iGAAiG;QAC9G,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG;QAC7E,eAAe,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC;QAC7E,OAAO,EAAE,4BAA4B;KACtC,CAAC,CAAC;IAEH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,8BAA8B;QACpC,KAAK,EAAE,kCAAkC;QACzC,WAAW,EAAE,sIAAsI;QACnJ,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG;QAC9E,eAAe,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC;QAC/E,OAAO,EAAE,6BAA6B;KACvC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/logs.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 registerLogTools(server: McpServer, client: TacticalRmmClient): void;
+//# sourceMappingURL=logs.d.ts.map

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

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

package/dist/tools/logs.js

@@ -0,0 +1,91 @@
+import { AgentResourceSchema, AuditLogsSchema, ListResourcesSchema } from "../schemas/resources.js";
+import { formatApiError } from "../services/errors.js";
+import { formatResponse, makeToolResponse, summarizeRecord } from "./format.js";
+import { registerCollectionReadTool } from "./read-tools.js";
+export function registerLogTools(server, client) {
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_agent_history",
+        title: "List TacticalRMM Agent History",
+        description: "List history for one TacticalRMM agent from /agents/<agent_id>/history/. This tool is read-only.",
+        inputSchema: AgentResourceSchema.shape,
+        path: (params) => `/agents/${encodeURIComponent(String(params.agent_id))}/history/`,
+        preferredFields: ["id", "entry_time", "event_type", "message", "description"],
+        heading: "TacticalRMM Agent History"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_agent_notes",
+        title: "List TacticalRMM Agent Notes",
+        description: "List notes for one TacticalRMM agent from /agents/<agent_id>/notes/. This tool is read-only.",
+        inputSchema: AgentResourceSchema.shape,
+        path: (params) => `/agents/${encodeURIComponent(String(params.agent_id))}/notes/`,
+        preferredFields: ["id", "title", "note", "created_by", "entry_time"],
+        heading: "TacticalRMM Agent Notes"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_pending_actions",
+        title: "List TacticalRMM Pending Actions",
+        description: "List global pending actions from /logs/pendingactions/. This tool is read-only.",
+        inputSchema: ListResourcesSchema.shape,
+        path: () => "/logs/pendingactions/",
+        preferredFields: ["id", "agent", "hostname", "action_type", "status", "entry_time"],
+        heading: "TacticalRMM Pending Actions"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_agent_pending_actions",
+        title: "List TacticalRMM Agent Pending Actions",
+        description: "List pending actions for one TacticalRMM agent from /agents/<agent_id>/pendingactions/. This tool is read-only.",
+        inputSchema: AgentResourceSchema.shape,
+        path: (params) => `/agents/${encodeURIComponent(String(params.agent_id))}/pendingactions/`,
+        preferredFields: ["id", "action_type", "status", "entry_time", "result"],
+        heading: "TacticalRMM Agent Pending Actions"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_get_custom_fields",
+        title: "Get TacticalRMM Custom Fields",
+        description: "List TacticalRMM custom fields from /core/customfields/. This tool is read-only.",
+        inputSchema: ListResourcesSchema.shape,
+        path: () => "/core/customfields/",
+        preferredFields: ["id", "name", "model", "field_type", "required"],
+        heading: "TacticalRMM Custom Fields"
+    });
+    server.registerTool("tacticalrmm_get_audit_logs", {
+        title: "Get TacticalRMM Audit Logs",
+        description: "Query TacticalRMM audit logs from /logs/audit/. This is a read-only audit-log query; TacticalRMM examples use a PATCH request body for filters.",
+        inputSchema: AuditLogsSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const payload = {
+                pagination: {
+                    sortBy: params.sort_by,
+                    descending: params.descending,
+                    page: params.page,
+                    rowsPerPage: params.rows_per_page,
+                    rowsNumber: 0
+                },
+                agentFilter: params.agent_ids,
+                actionFilter: params.actions
+            };
+            const data = await client.query("/logs/audit/", payload);
+            const rows = Array.isArray(data.data) ? data.data : Array.isArray(data.rows) ? data.rows : [];
+            const markdown = [
+                "# TacticalRMM Audit Logs",
+                "",
+                `Returned ${rows.length} audit log records.`,
+                "",
+                ...rows.slice(0, params.rows_per_page).map((item) => `- ${summarizeRecord(item, ["id", "entry_time", "agent", "action", "object_repr", "user"])}`)
+            ].join("\n");
+            return makeToolResponse(data, formatResponse(params.response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+}
+//# sourceMappingURL=logs.js.map

package/dist/tools/logs.js.map

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

package/dist/tools/monitoring.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 registerMonitoringTools(server: McpServer, client: TacticalRmmClient): void;
+//# sourceMappingURL=monitoring.d.ts.map

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

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

package/dist/tools/monitoring.js

@@ -0,0 +1,70 @@
+import { AgentResourceSchema, CheckHistorySchema, ListResourcesSchema } from "../schemas/resources.js";
+import { formatApiError } from "../services/errors.js";
+import { formatResponse, makeToolResponse, paginate, summarizeRecord } from "./format.js";
+import { extractItems, registerCollectionReadTool } from "./read-tools.js";
+export function registerMonitoringTools(server, client) {
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_alerts",
+        title: "List TacticalRMM Alerts",
+        description: "List TacticalRMM alerts from /alerts/. This tool is read-only; TacticalRMM expects a PATCH query for alert filters.",
+        inputSchema: ListResourcesSchema.shape,
+        path: () => "/alerts/",
+        method: "query",
+        body: () => ({}),
+        preferredFields: ["id", "alert_type", "severity", "hostname", "agent_hostname", "message", "status"],
+        heading: "TacticalRMM Alerts"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_checks",
+        title: "List TacticalRMM Checks",
+        description: "List TacticalRMM checks from /checks/. This tool is read-only.",
+        inputSchema: ListResourcesSchema.shape,
+        path: () => "/checks/",
+        preferredFields: ["id", "name", "check_type", "status", "agent", "agent_hostname"],
+        heading: "TacticalRMM Checks"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "tacticalrmm_list_agent_checks",
+        title: "List TacticalRMM Agent Checks",
+        description: "List checks assigned to one TacticalRMM agent from /agents/<agent_id>/checks/. This tool is read-only.",
+        inputSchema: AgentResourceSchema.shape,
+        path: (params) => `/agents/${encodeURIComponent(String(params.agent_id))}/checks/`,
+        preferredFields: ["id", "name", "check_type", "status", "last_run"],
+        heading: "TacticalRMM Agent Checks"
+    });
+    server.registerTool("tacticalrmm_get_check_history", {
+        title: "Get TacticalRMM Check History",
+        description: "Read history for one TacticalRMM check from /checks/<check_id>/history/. This tool is read-only.",
+        inputSchema: CheckHistorySchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ check_id, limit, offset, response_format }) => {
+        try {
+            const raw = await client.query(`/checks/${encodeURIComponent(String(check_id))}/history/`, {
+                timeFilter: 0
+            });
+            const history = extractItems(raw);
+            const data = {
+                check_id,
+                ...paginate(history, limit, offset)
+            };
+            const markdown = [
+                "# TacticalRMM Check History",
+                "",
+                `Showing ${data.count} of ${data.total} history records for check ${check_id}.`,
+                "",
+                ...data.items.map((item) => `- ${summarizeRecord(item, ["id", "status", "output", "created", "entry_time", "timestamp"])}`)
+            ].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+}
+//# sourceMappingURL=monitoring.js.map

package/dist/tools/monitoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.js","sourceRoot":"","sources":["../../src/tools/monitoring.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAA0B,MAAM,yBAAyB,CAAC;AAC/H,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE3E,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAyB;IAClF,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,qHAAqH;QAClI,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU;QACtB,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QAChB,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,CAAC;QACpG,OAAO,EAAE,oBAAoB;KAC9B,CAAC,CAAC;IAEH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,gEAAgE;QAC7E,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU;QACtB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC;QAClF,OAAO,EAAE,oBAAoB;KAC9B,CAAC,CAAC;IAEH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,+BAA+B;QACrC,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,wGAAwG;QACrH,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU;QAClF,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,CAAC;QACnE,OAAO,EAAE,0BAA0B;KACpC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CACjB,+BAA+B,EAC/B;QACE,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,kGAAkG;QAC/G,WAAW,EAAE,kBAAkB,CAAC,KAAK;QACrC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAqB,EAAE,EAAE;QACxE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAU,WAAW,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;gBAClG,UAAU,EAAE,CAAC;aACd,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,IAAI,GAAG;gBACX,QAAQ;gBACR,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC;aACpC,CAAC;YACF,MAAM,QAAQ,GAAG;gBACf,6BAA6B;gBAC7B,EAAE;gBACF,WAAW,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,8BAA8B,QAAQ,GAAG;gBAC/E,EAAE;gBACF,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;aAC5H,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"}

package/dist/tools/read-tools.d.ts

@@ -0,0 +1,20 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { z } from "zod";
+import type { TacticalRmmClient } from "../services/tacticalrmm-client.js";
+type ToolParams = Record<string, unknown>;
+type CollectionReadOptions = {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, z.ZodTypeAny>;
+    path: (params: ToolParams) => string;
+    query?: (params: ToolParams) => Record<string, unknown> | undefined;
+    body?: (params: ToolParams) => Record<string, unknown> | undefined;
+    method?: "get" | "query";
+    preferredFields: string[];
+    heading: string;
+};
+export declare function registerCollectionReadTool(server: McpServer, client: TacticalRmmClient, options: CollectionReadOptions): void;
+export declare function extractItems(raw: unknown): unknown[];
+export {};
+//# sourceMappingURL=read-tools.d.ts.map

package/dist/tools/read-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tools.d.ts","sourceRoot":"","sources":["../../src/tools/read-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAK3E,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,KAAK,qBAAqB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC;IACrC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACpE,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnE,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAQF,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAqCN;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,EAAE,CAepD"}