supporthero-mcp-server 1.0.1 → 1.1.0

package/README.md

@@ -1,9 +1,11 @@
 # 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.
+An MCP server for the SupportHero Help Center API. Enables Claude to search, browse, read, and update your help center articles directly in conversation.
 
 ## Tools
 
+### Read Tools (always available)
+
 | Tool | Description |
 |------|-------------|
 | `supporthero_list_categories` | List top-level or sub-categories |
@@ -12,7 +14,13 @@ A read-only MCP server for the SupportHero Help Center API. Enables Claude to se
 | `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.
+### Write Tools (requires login credentials)
+
+| Tool | Description |
+|------|-------------|
+| `supporthero_update_article` | Update an article's title, content, keywords, publication status, or category |
+
+Write tools are only registered when `SUPPORTHERO_EMAIL` and `SUPPORTHERO_PASSWORD` are provided. Without these, the server operates in read-only mode exactly as before.
 
 ## Setup
 
@@ -40,6 +48,8 @@ Add this to your Claude Desktop config file:
 **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
+Read-only mode (API key only):
+
 ```json
 {
   "mcpServers": {
@@ -55,10 +65,26 @@ Add this to your Claude Desktop config file:
 }
 ```
 
-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
+With write access (add login credentials):
+
+```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",
+        "SUPPORTHERO_EMAIL": "your-login-email",
+        "SUPPORTHERO_PASSWORD": "your-login-password"
+      }
+    }
+  }
+}
+```
+
+Replace the placeholder values with your actual credentials.
 
 ### 5. Restart Claude Desktop
 
@@ -72,6 +98,8 @@ Once connected, you can ask Claude things like:
 - "Show me the full content of our booking policy article"
 - "List all categories in the help center"
 - "Search our help center for instructor qualifications"
+- "Update the booking policy article to mention our new 24-hour cancellation window"
+- "Unpublish the outdated pricing article"
 
 ## Environment Variables
 
@@ -79,3 +107,5 @@ Once connected, you can ask Claude things like:
 |----------|----------|-------------|
 | `SUPPORTHERO_DOMAIN` | Yes | Your Help Center URL (e.g. `https://propel.supporthero.io`) |
 | `SUPPORTHERO_API_KEY` | Yes | API key from SupportHero Settings page |
+| `SUPPORTHERO_EMAIL` | No | Login email for write access |
+| `SUPPORTHERO_PASSWORD` | No | Login password for write access |

package/dist/index.js

@@ -2,10 +2,13 @@
 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";
+import { SessionManager } from "./session.js";
+import { registerTools, registerWriteTools } from "./tools/helpCenter.js";
 // ── Configuration ───────────────────────────────────────────
 const SUPPORTHERO_DOMAIN = process.env.SUPPORTHERO_DOMAIN;
 const SUPPORTHERO_API_KEY = process.env.SUPPORTHERO_API_KEY;
+const SUPPORTHERO_EMAIL = process.env.SUPPORTHERO_EMAIL;
+const SUPPORTHERO_PASSWORD = process.env.SUPPORTHERO_PASSWORD;
 if (!SUPPORTHERO_DOMAIN) {
     console.error("Missing SUPPORTHERO_DOMAIN env var. " +
         "Set it to your Help Center URL, e.g. https://yourcompany.supporthero.io");
@@ -16,18 +19,40 @@ if (!SUPPORTHERO_API_KEY) {
         "Find your API key in SupportHero > Settings (bottom of page).");
     process.exit(1);
 }
+// ── Session (optional, for write access) ────────────────────
+const writeEnabled = !!(SUPPORTHERO_EMAIL && SUPPORTHERO_PASSWORD);
+let session;
+if (writeEnabled) {
+    session = new SessionManager(SUPPORTHERO_EMAIL, SUPPORTHERO_PASSWORD, SUPPORTHERO_DOMAIN);
+}
 // ── Server Setup ────────────────────────────────────────────
 const server = new McpServer({
     name: "supporthero-mcp-server",
-    version: "1.0.0",
+    version: "1.1.0",
 });
-const client = new SupportHeroClient(SUPPORTHERO_DOMAIN, SUPPORTHERO_API_KEY);
+const client = new SupportHeroClient(SUPPORTHERO_DOMAIN, SUPPORTHERO_API_KEY, session);
 registerTools(server, client);
+if (writeEnabled) {
+    registerWriteTools(server, client);
+}
 // ── Transport ───────────────────────────────────────────────
 async function main() {
+    // Verify write credentials at startup so bad config fails fast
+    // rather than silently succeeding until the first write attempt.
+    if (session) {
+        try {
+            await session.login();
+        }
+        catch (error) {
+            console.error("Failed to authenticate with SupportHero for write access. " +
+                "Check SUPPORTHERO_EMAIL and SUPPORTHERO_PASSWORD.\n" +
+                `Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    }
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("SupportHero MCP server running on stdio");
+    console.error(`SupportHero MCP server running on stdio (write tools: ${writeEnabled ? "enabled" : "disabled"})`);
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/dist/index.js.map

@@ -1 +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"}
+{"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,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE1E,+DAA+D;AAE/D,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAC1D,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAC5D,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AACxD,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;AAE9D,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,YAAY,GAAG,CAAC,CAAC,CAAC,iBAAiB,IAAI,oBAAoB,CAAC,CAAC;AACnE,IAAI,OAAmC,CAAC;AAExC,IAAI,YAAY,EAAE,CAAC;IACjB,OAAO,GAAG,IAAI,cAAc,CAAC,iBAAkB,EAAE,oBAAqB,EAAE,kBAAkB,CAAC,CAAC;AAC9F,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,EAAE,OAAO,CAAC,CAAC;AAEvF,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9B,IAAI,YAAY,EAAE,CAAC;IACjB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,+DAA+D;AAE/D,KAAK,UAAU,IAAI;IACjB,+DAA+D;IAC/D,iEAAiE;IACjE,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,4DAA4D;gBAC5D,qDAAqD;gBACrD,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CACX,yDAAyD,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,CAClG,CAAC;AACJ,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

@@ -45,4 +45,33 @@ export declare const SearchArticlesInputSchema: z.ZodObject<{
     offset?: string | undefined;
 }>;
 export type SearchArticlesInput = z.infer<typeof SearchArticlesInputSchema>;
+export declare const UpdateArticleInputSchema: z.ZodObject<{
+    article_id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodString>;
+    meta_keywords: z.ZodOptional<z.ZodString>;
+    published: z.ZodOptional<z.ZodBoolean>;
+    container_id: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["article", "question"]>>;
+}, "strict", z.ZodTypeAny, {
+    article_id: string;
+    title?: string | undefined;
+    description?: string | undefined;
+    keywords?: string | undefined;
+    published?: boolean | undefined;
+    type?: "article" | "question" | undefined;
+    meta_keywords?: string | undefined;
+    container_id?: string | undefined;
+}, {
+    article_id: string;
+    title?: string | undefined;
+    description?: string | undefined;
+    keywords?: string | undefined;
+    published?: boolean | undefined;
+    type?: "article" | "question" | undefined;
+    meta_keywords?: string | undefined;
+    container_id?: string | undefined;
+}>;
+export type UpdateArticleInput = z.infer<typeof UpdateArticleInputSchema>;
 //# sourceMappingURL=inputs.d.ts.map

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

@@ -1 +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"}
+{"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;AAI5E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyC1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/inputs.js

@@ -57,4 +57,43 @@ export const SearchArticlesInputSchema = z
         "Pass the offset value from the prior result to get the next page."),
 })
     .strict();
+// ── Write Operations ───────────────────────────────────────
+export const UpdateArticleInputSchema = z
+    .object({
+    article_id: z
+        .string()
+        .min(1, "article_id is required")
+        .describe("The ID of the article to update."),
+    title: z
+        .string()
+        .optional()
+        .describe("New title for the article."),
+    description: z
+        .string()
+        .optional()
+        .describe("New HTML body content for the article. " +
+        "Use standard HTML tags (p, h1-h6, ul, ol, li, a, strong, em, etc.)."),
+    keywords: z
+        .string()
+        .optional()
+        .describe("Newline-separated keywords for the article."),
+    meta_keywords: z
+        .string()
+        .optional()
+        .describe("Comma-separated meta keywords for SEO."),
+    published: z
+        .boolean()
+        .optional()
+        .describe("Set to true to publish, false to unpublish."),
+    container_id: z
+        .string()
+        .optional()
+        .describe("Category ID to move the article to. " +
+        "Use supporthero_list_categories to find valid category IDs."),
+    type: z
+        .enum(["article", "question"])
+        .optional()
+        .describe('Article type: "article" or "question".'),
+})
+    .strict();
 //# sourceMappingURL=inputs.js.map

package/dist/schemas/inputs.js.map

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

package/dist/services/client.d.ts

@@ -1,12 +1,17 @@
-import type { SHCategory, SHArticle, SHSearchResponse } from "../types.js";
+import type { SHCategory, SHArticle, SHSearchResponse, SHArticleUpdatePayload, SHArticleUpdateFields } from "../types.js";
+import type { SessionManager } from "../session.js";
 /**
  * SupportHero API client.
- * All methods are read-only GET requests against the Help Center API.
+ * Read methods use the public API key. Write methods require a SessionManager
+ * with authenticated session cookies.
  */
 export declare class SupportHeroClient {
     private baseUrl;
     private apiKey;
-    constructor(baseUrl: string, apiKey: string);
+    private session;
+    constructor(baseUrl: string, apiKey: string, session?: SessionManager);
+    /** Whether this client has write capability (session credentials provided). */
+    get hasWriteAccess(): boolean;
     /**
      * Core fetch wrapper. Appends apiKey and handles errors uniformly.
      */
@@ -21,5 +26,22 @@ export declare class SupportHeroClient {
     getArticle(articleId: string): Promise<SHArticle>;
     /** Full-text search across all articles. Returns paginated results. */
     searchArticles(searchText: string, max?: number, offset?: string): Promise<SHSearchResponse>;
+    /**
+     * Ensure we have a session before attempting write operations.
+     */
+    private requireSession;
+    /**
+     * GET an article via the authenticated session endpoint.
+     * Uses /api/article/{id} (no v1 prefix) which may return additional
+     * fields needed for the PUT payload.
+     */
+    getArticleForUpdate(articleId: string): Promise<SHArticleUpdatePayload>;
+    /**
+     * Update an article by merging provided fields into the existing article
+     * and PUTting the full payload.
+     *
+     * Flow: GET current article -> merge updates -> PUT full object
+     */
+    updateArticle(articleId: string, updates: SHArticleUpdateFields): Promise<SHArticleUpdatePayload>;
 }
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/services/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAEV,SAAS,EAET,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAwB;gBAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;IAOrE,+EAA+E;IAC/E,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;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;IAS5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAiB7E;;;;;OAKG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;CAmCnC"}

package/dist/services/client.js

@@ -1,15 +1,22 @@
 import { API_VERSION } from "../constants.js";
 /**
  * SupportHero API client.
- * All methods are read-only GET requests against the Help Center API.
+ * Read methods use the public API key. Write methods require a SessionManager
+ * with authenticated session cookies.
  */
 export class SupportHeroClient {
     baseUrl;
     apiKey;
-    constructor(baseUrl, apiKey) {
+    session;
+    constructor(baseUrl, apiKey, session) {
         // Normalize: strip trailing slash
         this.baseUrl = baseUrl.replace(/\/+$/, "");
         this.apiKey = apiKey;
+        this.session = session ?? null;
+    }
+    /** Whether this client has write capability (session credentials provided). */
+    get hasWriteAccess() {
+        return this.session !== null;
     }
     /**
      * Core fetch wrapper. Appends apiKey and handles errors uniformly.
@@ -68,5 +75,80 @@ export class SupportHeroClient {
             params.offset = offset;
         return this.request("search", params);
     }
+    // ── Write Operations ──────────────────────────────────────
+    /**
+     * Ensure we have a session before attempting write operations.
+     */
+    requireSession() {
+        if (!this.session) {
+            throw new Error("Write operations require session authentication. " +
+                "Provide SUPPORTHERO_EMAIL and SUPPORTHERO_PASSWORD env vars.");
+        }
+        return this.session;
+    }
+    /**
+     * GET an article via the authenticated session endpoint.
+     * Uses /api/article/{id} (no v1 prefix) which may return additional
+     * fields needed for the PUT payload.
+     */
+    async getArticleForUpdate(articleId) {
+        const session = this.requireSession();
+        const url = `${this.baseUrl}/api/article/${articleId}`;
+        const response = await session.authenticatedFetch(url, {
+            headers: { "Accept": "application/json" },
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`Failed to fetch article ${articleId} for update: ${response.status} ${response.statusText}. ${body}`);
+        }
+        return response.json();
+    }
+    /**
+     * Update an article by merging provided fields into the existing article
+     * and PUTting the full payload.
+     *
+     * Flow: GET current article -> merge updates -> PUT full object
+     */
+    async updateArticle(articleId, updates) {
+        const session = this.requireSession();
+        // Fetch the current state of the article
+        const current = await this.getArticleForUpdate(articleId);
+        // Merge user-provided updates into the full payload
+        const cleaned = stripUndefined(updates);
+        const payload = {
+            ...current,
+            ...cleaned,
+        };
+        // Ensure the id matches
+        payload.id = articleId;
+        const url = `${this.baseUrl}/api/article/${articleId}`;
+        const response = await session.authenticatedFetch(url, {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`Failed to update article ${articleId}: ${response.status} ${response.statusText}. ${body}`);
+        }
+        return response.json();
+    }
+}
+/**
+ * Remove undefined values from an object so they don't overwrite
+ * existing fields during the spread merge.
+ */
+function stripUndefined(obj) {
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        if (obj[key] !== undefined) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            result[key] = obj[key];
+        }
+    }
+    return result;
 }
 //# sourceMappingURL=client.js.map

package/dist/services/client.js.map

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

package/dist/services/formatting.d.ts

@@ -1,4 +1,4 @@
-import type { SHCategory, SHArticle } from "../types.js";
+import type { SHCategory, SHArticle, SHArticleUpdatePayload } 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.
@@ -8,6 +8,8 @@ export declare function stripHtml(html: string): string;
 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;
+/** Format the result of an article update, highlighting which fields were changed. */
+export declare function formatArticleUpdate(article: SHArticleUpdatePayload, changedFields: string[]): 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

@@ -1 +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"}
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/services/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGjF;;;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,sFAAsF;AACtF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,sBAAsB,EAC/B,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,CAqBR;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/services/formatting.js

@@ -58,6 +58,26 @@ export function formatArticle(article, includeBody = false) {
     }
     return lines.join("\n");
 }
+/** Format the result of an article update, highlighting which fields were changed. */
+export function formatArticleUpdate(article, changedFields) {
+    const lines = [
+        `Article updated successfully.`,
+        ``,
+        `Title: ${article.title} (ID: ${article.id})`,
+        `  Category ID: ${article.containerId}`,
+        `  Type: ${article.type}`,
+        `  Published: ${article.published ? "yes" : "no"}`,
+    ];
+    if (article.keywords) {
+        lines.push(`  Keywords: ${article.keywords}`);
+    }
+    if (article.metaKeywords) {
+        lines.push(`  Meta Keywords: ${article.metaKeywords}`);
+    }
+    lines.push("");
+    lines.push(`Fields changed: ${changedFields.join(", ")}`);
+    return lines.join("\n");
+}
 /** Truncate text if it exceeds the character limit, with a warning. */
 export function truncateIfNeeded(text) {
     if (text.length <= CHARACTER_LIMIT)

package/dist/services/formatting.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Session management for SupportHero write operations.
+ *
+ * SupportHero's write API requires session-based authentication via cookies
+ * (JSESSIONID and X-Session-Token), obtained by logging in through their
+ * HTML form at signin.supporthero.io.
+ *
+ * This module handles:
+ *  - Logging in via the signin form
+ *  - Extracting and caching session cookies across redirect hops
+ *  - Making authenticated requests with automatic session renewal
+ */
+export declare class SessionManager {
+    private email;
+    private password;
+    private subdomain;
+    private baseUrl;
+    private cookies;
+    private isAuthenticated;
+    constructor(email: string, password: string, domain: string);
+    /**
+     * Parse Set-Cookie headers and merge into our cookie jar.
+     * Handles both single and multiple Set-Cookie values.
+     */
+    private collectCookies;
+    /**
+     * Build a Cookie header string from our stored cookies.
+     */
+    private getCookieHeader;
+    /**
+     * Log in to SupportHero via the signin form.
+     *
+     * Flow:
+     *  1. GET signin.supporthero.io to discover the form action and hidden fields
+     *  2. POST credentials to the form action URL
+     *  3. Manually follow redirects, collecting cookies at each hop
+     *  4. Verify we got the required session cookies
+     */
+    login(): Promise<void>;
+    /**
+     * Make an authenticated HTTP request. Automatically logs in if needed
+     * and retries once on session expiry.
+     */
+    authenticatedFetch(url: string, options?: RequestInit): Promise<Response>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,eAAe,CAAS;gBAEpB,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAS3D;;;OAGG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoF5B;;;OAGG;IACG,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;CA+CpF"}