supporthero-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,81 @@
+# SupportHero MCP Server
+
+A read-only MCP server for the SupportHero Help Center API. Enables Claude to search, browse, and read your help center articles directly in conversation.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `supporthero_list_categories` | List top-level or sub-categories |
+| `supporthero_get_category` | Get details of a specific category |
+| `supporthero_list_articles` | List articles in a category (summaries only) |
+| `supporthero_get_article` | Get full article content by ID |
+| `supporthero_search_articles` | Full-text search across all articles |
+
+All tools are read-only. No data is modified.
+
+## Setup
+
+### 1. Install dependencies
+
+```bash
+cd supporthero-mcp-server
+npm install
+```
+
+### 2. Build
+
+```bash
+npm run build
+```
+
+### 3. Find your API key
+
+Go to your SupportHero account > Settings (scroll to bottom of page). Copy the API key.
+
+### 4. Configure Claude Desktop
+
+Add this to your Claude Desktop config file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "supporthero": {
+      "command": "node",
+      "args": ["/absolute/path/to/supporthero-mcp-server/dist/index.js"],
+      "env": {
+        "SUPPORTHERO_DOMAIN": "https://yourcompany.supporthero.io",
+        "SUPPORTHERO_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+Replace:
+- `/absolute/path/to/` with the actual path where you cloned this project
+- `yourcompany` with your SupportHero subdomain
+- `your-api-key-here` with your actual API key
+
+### 5. Restart Claude Desktop
+
+The SupportHero tools should now appear in Claude's tool list.
+
+## Usage Examples
+
+Once connected, you can ask Claude things like:
+
+- "What help center articles do we have about cancellations?"
+- "Show me the full content of our booking policy article"
+- "List all categories in the help center"
+- "Search our help center for instructor qualifications"
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `SUPPORTHERO_DOMAIN` | Yes | Your Help Center URL (e.g. `https://propel.supporthero.io`) |
+| `SUPPORTHERO_API_KEY` | Yes | API key from SupportHero Settings page |

package/dist/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const API_VERSION = "v1";
+export declare const DEFAULT_SEARCH_MAX = 10;
+export declare const MAX_SEARCH_RESULTS = 100;
+export declare const CHARACTER_LIMIT = 50000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,OAAO,CAAC;AAChC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,eAAe,QAAS,CAAC"}

package/dist/constants.js

@@ -0,0 +1,6 @@
+// SupportHero API base path (domain comes from env var)
+export const API_VERSION = "v1";
+export const DEFAULT_SEARCH_MAX = 10;
+export const MAX_SEARCH_RESULTS = 100;
+export const CHARACTER_LIMIT = 50_000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+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":""}

package/dist/index.js

@@ -0,0 +1,35 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SupportHeroClient } from "./services/client.js";
+import { registerTools } from "./tools/helpCenter.js";
+// ── Configuration ───────────────────────────────────────────
+const SUPPORTHERO_DOMAIN = process.env.SUPPORTHERO_DOMAIN;
+const SUPPORTHERO_API_KEY = process.env.SUPPORTHERO_API_KEY;
+if (!SUPPORTHERO_DOMAIN) {
+    console.error("Missing SUPPORTHERO_DOMAIN env var. " +
+        "Set it to your Help Center URL, e.g. https://yourcompany.supporthero.io");
+    process.exit(1);
+}
+if (!SUPPORTHERO_API_KEY) {
+    console.error("Missing SUPPORTHERO_API_KEY env var. " +
+        "Find your API key in SupportHero > Settings (bottom of page).");
+    process.exit(1);
+}
+// ── Server Setup ────────────────────────────────────────────
+const server = new McpServer({
+    name: "supporthero-mcp-server",
+    version: "1.0.0",
+});
+const client = new SupportHeroClient(SUPPORTHERO_DOMAIN, SUPPORTHERO_API_KEY);
+registerTools(server, client);
+// ── Transport ───────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("SupportHero MCP server running on stdio");
+}
+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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,+DAA+D;AAE/D,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAC1D,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAE5D,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CACX,sCAAsC;QACtC,yEAAyE,CAC1E,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,CACX,uCAAuC;QACvC,+DAA+D,CAChE,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,+DAA+D;AAE/D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;AAE9E,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9B,+DAA+D;AAE/D,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC3D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/schemas/inputs.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+export declare const ListCategoriesInputSchema: z.ZodObject<{
+    parent_category_id: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    parent_category_id?: string | undefined;
+}, {
+    parent_category_id?: string | undefined;
+}>;
+export type ListCategoriesInput = z.infer<typeof ListCategoriesInputSchema>;
+export declare const GetCategoryInputSchema: z.ZodObject<{
+    category_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    category_id: string;
+}, {
+    category_id: string;
+}>;
+export type GetCategoryInput = z.infer<typeof GetCategoryInputSchema>;
+export declare const ListArticlesInputSchema: z.ZodObject<{
+    category_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    category_id: string;
+}, {
+    category_id: string;
+}>;
+export type ListArticlesInput = z.infer<typeof ListArticlesInputSchema>;
+export declare const GetArticleInputSchema: z.ZodObject<{
+    article_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    article_id: string;
+}, {
+    article_id: string;
+}>;
+export type GetArticleInput = z.infer<typeof GetArticleInputSchema>;
+export declare const SearchArticlesInputSchema: z.ZodObject<{
+    search_text: z.ZodString;
+    max: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    max: number;
+    search_text: string;
+    offset?: string | undefined;
+}, {
+    search_text: string;
+    max?: number | undefined;
+    offset?: string | undefined;
+}>;
+export type SearchArticlesInput = z.infer<typeof SearchArticlesInputSchema>;
+//# sourceMappingURL=inputs.d.ts.map

package/dist/schemas/inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/schemas/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,yBAAyB;;;;;;EAU3B,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,sBAAsB;;;;;;EAOxB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,uBAAuB;;;;;;EAUzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,qBAAqB;;;;;;EAOvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAuB3B,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/inputs.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { MAX_SEARCH_RESULTS, DEFAULT_SEARCH_MAX } from "../constants.js";
+// ── Categories ──────────────────────────────────────────────
+export const ListCategoriesInputSchema = z
+    .object({
+    parent_category_id: z
+        .string()
+        .optional()
+        .describe("If provided, returns sub-categories of this category. " +
+        "If omitted, returns all top-level categories."),
+})
+    .strict();
+export const GetCategoryInputSchema = z
+    .object({
+    category_id: z
+        .string()
+        .min(1, "category_id is required")
+        .describe("The ID of the category to retrieve."),
+})
+    .strict();
+// ── Articles ────────────────────────────────────────────────
+export const ListArticlesInputSchema = z
+    .object({
+    category_id: z
+        .string()
+        .min(1, "category_id is required")
+        .describe("The ID of the category whose articles to list. " +
+        "Use supporthero_list_categories first to find category IDs."),
+})
+    .strict();
+export const GetArticleInputSchema = z
+    .object({
+    article_id: z
+        .string()
+        .min(1, "article_id is required")
+        .describe("The ID of the article to retrieve. Returns full content."),
+})
+    .strict();
+// ── Search ──────────────────────────────────────────────────
+export const SearchArticlesInputSchema = z
+    .object({
+    search_text: z
+        .string()
+        .min(1, "search_text is required")
+        .describe("The search query. Matches against article titles and content."),
+    max: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_SEARCH_RESULTS)
+        .default(DEFAULT_SEARCH_MAX)
+        .describe(`Maximum number of results to return per page (1 to ${MAX_SEARCH_RESULTS}, default ${DEFAULT_SEARCH_MAX}).`),
+    offset: z
+        .string()
+        .optional()
+        .describe("Pagination cursor from a previous search response. " +
+        "Pass the offset value from the prior result to get the next page."),
+})
+    .strict();
+//# sourceMappingURL=inputs.js.map

package/dist/schemas/inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../../src/schemas/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,+DAA+D;AAE/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,wDAAwD;QACxD,+CAA+C,CAChD;CACJ,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;SACjC,QAAQ,CAAC,qCAAqC,CAAC;CACnD,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,+DAA+D;AAE/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;SACjC,QAAQ,CACP,iDAAiD;QACjD,6DAA6D,CAC9D;CACJ,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;SAChC,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,+DAA+D;AAE/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;SACjC,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,kBAAkB,CAAC;SACvB,OAAO,CAAC,kBAAkB,CAAC;SAC3B,QAAQ,CACP,sDAAsD,kBAAkB,aAAa,kBAAkB,IAAI,CAC5G;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qDAAqD;QACrD,mEAAmE,CACpE;CACJ,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/services/client.d.ts

@@ -0,0 +1,25 @@
+import type { SHCategory, SHArticle, SHSearchResponse } from "../types.js";
+/**
+ * SupportHero API client.
+ * All methods are read-only GET requests against the Help Center API.
+ */
+export declare class SupportHeroClient {
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    /**
+     * Core fetch wrapper. Appends apiKey and handles errors uniformly.
+     */
+    private request;
+    /** List top-level categories, or sub-categories of a given parent. */
+    listCategories(parentCategoryId?: string): Promise<SHCategory[]>;
+    /** Get a single category by ID. */
+    getCategory(categoryId: string): Promise<SHCategory>;
+    /** List all articles in a given category. */
+    listArticles(categoryId: string): Promise<SHArticle[]>;
+    /** Get a single article by ID. */
+    getArticle(articleId: string): Promise<SHArticle>;
+    /** Full-text search across all articles. Returns paginated results. */
+    searchArticles(searchText: string, max?: number, offset?: string): Promise<SHSearchResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/services/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/services/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAEV,SAAS,EAET,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM3C;;OAEG;YACW,OAAO;IA0BrB,sEAAsE;IAChE,cAAc,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAStE,mCAAmC;IAC7B,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAM1D,6CAA6C;IACvC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAO5D,kCAAkC;IAC5B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAMvD,uEAAuE;IACjE,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC;CAM7B"}

package/dist/services/client.js

@@ -0,0 +1,72 @@
+import { API_VERSION } from "../constants.js";
+/**
+ * SupportHero API client.
+ * All methods are read-only GET requests against the Help Center API.
+ */
+export class SupportHeroClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        // Normalize: strip trailing slash
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.apiKey = apiKey;
+    }
+    /**
+     * Core fetch wrapper. Appends apiKey and handles errors uniformly.
+     */
+    async request(path, params = {}) {
+        const url = new URL(`/api/${API_VERSION}/${path}`, this.baseUrl);
+        url.searchParams.set("apiKey", this.apiKey);
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== "") {
+                url.searchParams.set(key, value);
+            }
+        }
+        const response = await fetch(url.toString(), {
+            method: "GET",
+            headers: { "Accept": "application/json" },
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`SupportHero API error ${response.status}: ${response.statusText}. ${body}`);
+        }
+        return response.json();
+    }
+    // ── Categories ──────────────────────────────────────────────
+    /** List top-level categories, or sub-categories of a given parent. */
+    async listCategories(parentCategoryId) {
+        const params = {};
+        if (parentCategoryId) {
+            params.categoryId = parentCategoryId;
+        }
+        const data = await this.request("category", params);
+        return data.categories;
+    }
+    /** Get a single category by ID. */
+    async getCategory(categoryId) {
+        return this.request(`category/${categoryId}`);
+    }
+    // ── Articles ────────────────────────────────────────────────
+    /** List all articles in a given category. */
+    async listArticles(categoryId) {
+        const data = await this.request("article", {
+            categoryId,
+        });
+        return data.articles;
+    }
+    /** Get a single article by ID. */
+    async getArticle(articleId) {
+        return this.request(`article/${articleId}`);
+    }
+    // ── Search ──────────────────────────────────────────────────
+    /** Full-text search across all articles. Returns paginated results. */
+    async searchArticles(searchText, max, offset) {
+        const params = { searchText };
+        if (max !== undefined)
+            params.max = String(max);
+        if (offset)
+            params.offset = offset;
+        return this.request("search", params);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/services/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/services/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAS9C;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACpB,OAAO,CAAS;IAChB,MAAM,CAAS;IAEvB,YAAY,OAAe,EAAE,MAAc;QACzC,kCAAkC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,SAAiC,EAAE;QACxE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,WAAW,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBACxC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC3C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SAC1C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,yBAAyB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,KAAK,IAAI,EAAE,CAC5E,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;IACvC,CAAC;IAED,+DAA+D;IAE/D,sEAAsE;IACtE,KAAK,CAAC,cAAc,CAAC,gBAAyB;QAC5C,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,CAAC,UAAU,GAAG,gBAAgB,CAAC;QACvC,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAyB,UAAU,EAAE,MAAM,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,OAAO,IAAI,CAAC,OAAO,CAAa,YAAY,UAAU,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,+DAA+D;IAE/D,6CAA6C;IAC7C,KAAK,CAAC,YAAY,CAAC,UAAkB;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAwB,SAAS,EAAE;YAChE,UAAU;SACX,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAY,WAAW,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,+DAA+D;IAE/D,uEAAuE;IACvE,KAAK,CAAC,cAAc,CAClB,UAAkB,EAClB,GAAY,EACZ,MAAe;QAEf,MAAM,MAAM,GAA2B,EAAE,UAAU,EAAE,CAAC;QACtD,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAmB,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/services/formatting.d.ts

@@ -0,0 +1,13 @@
+import type { SHCategory, SHArticle } from "../types.js";
+/**
+ * Strip HTML tags from article body to produce plain text.
+ * Keeps it simple since we just need readable content for the LLM.
+ */
+export declare function stripHtml(html: string): string;
+/** Format a single category for display. */
+export declare function formatCategory(cat: SHCategory): string;
+/** Format a single article for display. Optionally include body content. */
+export declare function formatArticle(article: SHArticle, includeBody?: boolean): string;
+/** Truncate text if it exceeds the character limit, with a warning. */
+export declare function truncateIfNeeded(text: string): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/services/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/services/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGzD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAe9C;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAYtD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,GAAE,OAAe,GAAG,MAAM,CA0BtF;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/services/formatting.js

@@ -0,0 +1,68 @@
+import { CHARACTER_LIMIT } from "../constants.js";
+/**
+ * Strip HTML tags from article body to produce plain text.
+ * Keeps it simple since we just need readable content for the LLM.
+ */
+export function stripHtml(html) {
+    return html
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/p>/gi, "\n\n")
+        .replace(/<\/li>/gi, "\n")
+        .replace(/<\/h[1-6]>/gi, "\n\n")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, " ")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+/** Format a single category for display. */
+export function formatCategory(cat) {
+    return [
+        `Category: ${cat.name} (ID: ${cat.id})`,
+        `  Level: ${cat.level}`,
+        `  Published articles: ${cat.articlePublishedCount}`,
+        `  Total articles: ${cat.articleCount}`,
+        `  Sub-categories: ${cat.categoriesCount}`,
+        cat.parentId !== "0" ? `  Parent ID: ${cat.parentId}` : null,
+        `  Slug: ${cat.slug}`,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+/** Format a single article for display. Optionally include body content. */
+export function formatArticle(article, includeBody = false) {
+    const lines = [
+        `Title: ${article.title} (ID: ${article.id})`,
+        `  Category ID: ${article.categoryId}`,
+        `  Type: ${article.type}`,
+        `  Published: ${article.published ? "yes" : "no"}`,
+        `  Created: ${article.dateCreated}`,
+        `  Updated: ${article.lastUpdated}`,
+    ];
+    if (article.keywords) {
+        lines.push(`  Keywords: ${article.keywords}`);
+    }
+    if (article.slug) {
+        lines.push(`  Slug: ${article.slug}`);
+    }
+    if (includeBody && article.description) {
+        const body = stripHtml(article.description);
+        lines.push("");
+        lines.push("--- Content ---");
+        lines.push(body);
+        lines.push("--- End Content ---");
+    }
+    return lines.join("\n");
+}
+/** Truncate text if it exceeds the character limit, with a warning. */
+export function truncateIfNeeded(text) {
+    if (text.length <= CHARACTER_LIMIT)
+        return text;
+    const truncated = text.slice(0, CHARACTER_LIMIT);
+    return truncated + "\n\n[Response truncated. Use more specific queries or pagination to get remaining results.]";
+}
+//# sourceMappingURL=formatting.js.map

package/dist/services/formatting.js.map

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

package/dist/tools/helpCenter.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SupportHeroClient } from "../services/client.js";
+/**
+ * Register all SupportHero tools on the given MCP server.
+ */
+export declare function registerTools(server: McpServer, client: SupportHeroClient): void;
+//# sourceMappingURL=helpCenter.d.ts.map

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

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