@suzko/mcp-server 0.1.0

package/dist/src/tools/services.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SuzkoClient } from "../client.js";
+export declare function registerServicesTools(server: McpServer, client: SuzkoClient): void;

package/dist/src/tools/services.js

@@ -0,0 +1,181 @@
+import { z } from "zod";
+export function registerServicesTools(server, client) {
+    // 1. List services
+    server.tool("list_services", "List all WHMCS hosting/server services for the authenticated user, including status, product name, and domain.", {
+        page: z
+            .number()
+            .optional()
+            .describe("Page number (each page is 25 services, starting from 1)"),
+    }, async ({ page }) => {
+        const params = {};
+        if (page && page > 1)
+            params.limitstart = String((page - 1) * 25);
+        const res = await client.get("/api/services", params);
+        if (res.error) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const services = res.services ?? [];
+        if (services.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No services found. Visit https://www.suzko.com to browse available products.",
+                    },
+                ],
+            };
+        }
+        const lines = services.map((s) => {
+            const domain = s.domain ? ` | ${s.domain}` : "";
+            const ip = s.dedicatedip ? ` | IP: ${s.dedicatedip}` : "";
+            const price = s.recurringamount ? ` | ${s.recurringamount}/${s.billingcycle}` : "";
+            const due = s.nextduedate ? ` | Next due: ${s.nextduedate}` : "";
+            return `• **${s.name}** (ID: ${s.id}) — ${s.status}${domain}${ip}${price}${due}`;
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Services (${services.length}${res.totalresults ? ` of ${res.totalresults}` : ""}):**\n\n${lines.join("\n")}`,
+                },
+            ],
+        };
+    });
+    // 2. Get service details
+    server.tool("get_service_details", "Get full details for a specific WHMCS service including configuration, billing, assigned IPs, and server info.", {
+        serviceId: z.number().describe("The service ID to look up"),
+    }, async ({ serviceId }) => {
+        const res = await client.get(`/api/services/${serviceId}`);
+        if (res.error || !res.service) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${res.error || "Service not found"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const s = res.service;
+        const header = [
+            `**Service: ${s.name}** (ID: ${s.id})`,
+            `- **Status:** ${s.status}`,
+            s.domain ? `- **Domain:** ${s.domain}` : null,
+            s.groupname ? `- **Category:** ${s.groupname}` : null,
+            `- **Registered:** ${s.regdate}`,
+            `- **Billing:** ${s.recurringamount || s.firstpaymentamount || "N/A"} / ${s.billingcycle}`,
+            s.nextduedate ? `- **Next Due:** ${s.nextduedate}` : null,
+        ].filter(Boolean);
+        const serverInfo = [
+            s.servername ? `- **Server:** ${s.servername}` : null,
+            s.serverip ? `- **Server IP:** ${s.serverip}` : null,
+            s.dedicatedip ? `- **Dedicated IP:** ${s.dedicatedip}` : null,
+            s.assignedips ? `- **Assigned IPs:** ${s.assignedips}` : null,
+            s.username ? `- **Username:** ${s.username}` : null,
+        ].filter(Boolean);
+        const usage = [
+            s.diskusage && s.disklimit
+                ? `- **Disk:** ${s.diskusage} / ${s.disklimit}`
+                : null,
+            s.bwusage && s.bwlimit
+                ? `- **Bandwidth:** ${s.bwusage} / ${s.bwlimit}`
+                : null,
+        ].filter(Boolean);
+        const configOptions = s.configoptions?.configoption ?? [];
+        const customFields = s.customfields?.customfield ?? [];
+        let sections = header.join("\n");
+        if (serverInfo.length > 0) {
+            sections += `\n\n**Server & Network:**\n${serverInfo.join("\n")}`;
+        }
+        if (usage.length > 0) {
+            sections += `\n\n**Usage:**\n${usage.join("\n")}`;
+        }
+        if (configOptions.length > 0) {
+            const coLines = configOptions.map((co) => `  • ${co.option}: ${co.value}`);
+            sections += `\n\n**Config Options (${configOptions.length}):**\n${coLines.join("\n")}`;
+        }
+        if (customFields.length > 0) {
+            const cfLines = customFields.map((cf) => `  • ${cf.name}: ${cf.value}`);
+            sections += `\n\n**Custom Fields (${customFields.length}):**\n${cfLines.join("\n")}`;
+        }
+        return {
+            content: [{ type: "text", text: sections }],
+        };
+    });
+    // 3. Get SSO URL
+    server.tool("get_service_sso_url", "Get a single sign-on URL to access the control panel (Plesk, Pterodactyl, etc.) for a service. Opens directly into the panel without needing credentials.", {
+        serviceId: z.number().describe("The service ID to get an SSO link for"),
+    }, async ({ serviceId }) => {
+        const res = await client.post(`/api/services/${serviceId}/sso`);
+        if (res.error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${res.error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const ssoUrl = res.redirect_url || res.url || res.ssoUrl;
+        if (!ssoUrl) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "SSO is not available for this service. The service may not have a control panel, or the panel doesn't support single sign-on.",
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**SSO Link for Service #${serviceId}:**\n\n${ssoUrl}\n\n⚠️ This link is temporary and single-use. Open it in your browser to access the control panel.`,
+                },
+            ],
+        };
+    });
+    // 4. Upgrade service (redirect to dashboard)
+    server.tool("upgrade_service", "Get information about upgrading or downgrading a service. Upgrades are managed through the dashboard.", {
+        serviceId: z.number().describe("The service ID to upgrade"),
+    }, async ({ serviceId }) => {
+        // First verify the service exists
+        const res = await client.get(`/api/services/${serviceId}`);
+        if (res.error || !res.service) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${res.error || "Service not found"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const s = res.service;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `**Upgrade/Downgrade: ${s.name}** (ID: ${s.id})`,
+                        `- **Current Status:** ${s.status}`,
+                        `- **Current Billing:** ${s.recurringamount || "N/A"} / ${s.billingcycle}`,
+                        ``,
+                        `To manage upgrades and downgrades, visit the service management page:`,
+                        `**https://www.suzko.com/dashboard/services/${serviceId}**`,
+                        ``,
+                        `From there you can change your plan, modify configurable options, and review pricing differences.`,
+                    ].join("\n"),
+                },
+            ],
+        };
+    });
+}

package/dist/src/tools/support.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SuzkoClient } from "../client.js";
+export declare function registerSupportTools(server: McpServer, client: SuzkoClient): void;

package/dist/src/tools/support.js

@@ -0,0 +1,259 @@
+import { z } from "zod";
+export function registerSupportTools(server, client) {
+    // 1. List tickets
+    server.tool("list_tickets", "List support tickets for the authenticated user. Optionally filter by status (Open, Answered, Customer-Reply, Closed, On Hold).", {
+        status: z
+            .string()
+            .optional()
+            .describe("Filter by ticket status: Open, Answered, Customer-Reply, Closed, On Hold"),
+        page: z
+            .number()
+            .optional()
+            .describe("Page number (each page is 25 tickets, starting from 1)"),
+    }, async ({ status, page }) => {
+        const params = {};
+        if (status)
+            params.status = status;
+        if (page && page > 1)
+            params.limitstart = String((page - 1) * 25);
+        const res = await client.get("/api/tickets", params);
+        if (res.error) {
+            return {
+                content: [{ type: "text", text: `Error: ${res.error}` }],
+                isError: true,
+            };
+        }
+        const tickets = res.tickets ?? [];
+        if (tickets.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: status
+                            ? `No tickets found with status "${status}".`
+                            : "No support tickets found.",
+                    },
+                ],
+            };
+        }
+        const lines = tickets.map((t) => {
+            const dept = t.deptname ? ` [${t.deptname}]` : "";
+            return `• **#${t.tid}** — ${t.subject}\n  Status: ${t.status} | Priority: ${t.priority}${dept} | Last reply: ${t.lastreply}`;
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Support Tickets (${tickets.length}${res.totalresults ? ` of ${res.totalresults}` : ""}):**\n\n${lines.join("\n\n")}`,
+                },
+            ],
+        };
+    });
+    // 2. Get ticket details
+    server.tool("get_ticket", "Get full details of a support ticket including all replies and messages.", {
+        ticketId: z.number().describe("The ticket ID (numeric ID, not the ticket mask/tid)"),
+    }, async ({ ticketId }) => {
+        const res = await client.get(`/api/tickets/${ticketId}`);
+        if (res.error || !res.ticket) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${res.error || "Ticket not found"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const t = res.ticket;
+        const header = [
+            `**Ticket #${t.tid}** — ${t.subject}`,
+            `- **Status:** ${t.status}`,
+            `- **Priority:** ${t.priority}`,
+            t.deptname ? `- **Department:** ${t.deptname}` : null,
+            `- **Opened:** ${t.date}`,
+            t.name ? `- **From:** ${t.name}` : null,
+        ].filter(Boolean);
+        // Original message
+        const originalMsg = `\n\n**Original Message:**\n${stripHtml(t.message)}`;
+        // Replies
+        const replies = t.replies ?? [];
+        let repliesText = "";
+        if (replies.length > 0) {
+            const replyLines = replies.map((r, i) => {
+                const author = r.admin
+                    ? `Staff (${r.admin})`
+                    : r.name || r.email || "You";
+                return `\n**Reply #${i + 1}** by ${author} — ${r.date}\n${stripHtml(r.message)}`;
+            });
+            repliesText = `\n\n**Replies (${replies.length}):**${replyLines.join("\n")}`;
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: header.join("\n") + originalMsg + repliesText,
+                },
+            ],
+        };
+    });
+    // 3. Open support ticket
+    server.tool("open_support_ticket", "Open a new support ticket. Requires a department ID, subject, and message. Use list_departments resource to find department IDs.", {
+        deptid: z
+            .number()
+            .describe("Department ID (use the support departments list to find valid IDs)"),
+        subject: z.string().describe("Ticket subject line"),
+        message: z.string().describe("Ticket message body"),
+        priority: z
+            .enum(["Low", "Medium", "High"])
+            .optional()
+            .describe("Ticket priority (default: Medium)"),
+        serviceId: z
+            .number()
+            .optional()
+            .describe("Related service ID (optional, links ticket to a service)"),
+    }, async ({ deptid, subject, message, priority, serviceId }) => {
+        const body = {
+            deptid,
+            subject,
+            message,
+            priority: priority || "Medium",
+        };
+        if (serviceId)
+            body.serviceid = serviceId;
+        const res = await client.post("/api/tickets", body);
+        if (res.error || !res.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${res.error || "Failed to create ticket"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `**Ticket Created Successfully!**`,
+                        `- **Ticket #${res.tid}** (ID: ${res.id})`,
+                        `- **Subject:** ${subject}`,
+                        `- **Priority:** ${priority || "Medium"}`,
+                        ``,
+                        `View your ticket at: https://www.suzko.com/dashboard/tickets/${res.id}`,
+                    ].join("\n"),
+                },
+            ],
+        };
+    });
+    // 4. Reply to ticket
+    server.tool("reply_to_ticket", "Add a reply to an existing support ticket.", {
+        ticketId: z.number().describe("The ticket ID to reply to"),
+        message: z.string().describe("Reply message body"),
+    }, async ({ ticketId, message }) => {
+        const res = await client.post(`/api/tickets/${ticketId}/reply`, { message });
+        if (res.error || !res.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${res.error || "Failed to add reply"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Reply added** to ticket #${ticketId}.\n\nView the ticket at: https://www.suzko.com/dashboard/tickets/${ticketId}`,
+                },
+            ],
+        };
+    });
+    // 5. Close ticket
+    server.tool("close_ticket", "Close a support ticket by replying with a close request. Adds a closing message and updates the status.", {
+        ticketId: z.number().describe("The ticket ID to close"),
+        message: z
+            .string()
+            .optional()
+            .describe("Optional closing message (default: 'Closing this ticket. Thank you for your help.')"),
+    }, async ({ ticketId, message }) => {
+        // First check the ticket exists and get its current status
+        const ticketRes = await client.get(`/api/tickets/${ticketId}`);
+        if (ticketRes.error || !ticketRes.ticket) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${ticketRes.error || "Ticket not found"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const ticket = ticketRes.ticket;
+        if (ticket.status === "Closed") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Ticket #${ticket.tid} is already closed.`,
+                    },
+                ],
+            };
+        }
+        // Add a closing reply
+        const closingMessage = message || "Closing this ticket. Thank you for your help.";
+        const replyRes = await client.post(`/api/tickets/${ticketId}/reply`, {
+            message: closingMessage,
+        });
+        if (replyRes.error || !replyRes.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error adding closing reply: ${replyRes.error || "Failed"}. You can close the ticket manually at https://www.suzko.com/dashboard/tickets/${ticketId}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Note: WHMCS client API doesn't allow clients to directly change ticket status.
+        // The reply has been added; the ticket will be marked as "Customer-Reply".
+        // Staff or auto-close rules will handle the actual close.
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `**Closing reply added** to ticket #${ticket.tid} (${ticket.subject}).`,
+                        ``,
+                        `The ticket status is now "Customer-Reply". If you need it formally closed, a staff member will update the status, or it may auto-close after the inactivity period.`,
+                        ``,
+                        `View at: https://www.suzko.com/dashboard/tickets/${ticketId}`,
+                    ].join("\n"),
+                },
+            ],
+        };
+    });
+}
+/** Strip basic HTML tags from WHMCS ticket messages for cleaner display */
+function stripHtml(html) {
+    return html
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/p>/gi, "\n")
+        .replace(/<[^>]*>/g, "")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#039;/g, "'")
+        .replace(/&nbsp;/g, " ")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@suzko/mcp-server",
+  "version": "0.1.0",
+  "description": "Suzko MCP Server — AI-powered infrastructure management for VS Code, Claude, and Cursor",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "bin": {
+    "suzko-mcp": "dist/bin/mcp-server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/src/index.js",
+    "auth": "node dist/bin/mcp-server.js auth login",
+    "prepublishOnly": "tsc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "GUIDE.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "mcp",
+    "ai",
+    "deploy",
+    "infrastructure",
+    "domains",
+    "hosting",
+    "suzko",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/suzko-ops/mcp-server#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/suzko-ops/mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/suzko-ops/mcp-server/issues"
+  }
+}