@egain/egain-mcp-server 1.0.26 → 1.1.0

package/esm/src/mcp-server/tools/getAnnouncements.js

@@ -13,9 +13,47 @@ export const tool$getAnnouncements = {
 
 Get Announcements
 
+## How to Use This Tool
+
+**CRITICAL**: This tool requires a \`request\` parameter containing the request object. All parameters must be passed inside a \`request\` object.
+
+**Parameter Format**: 
+- Always wrap parameters in a \`request\` object: \`{"request": {"portalID": "PZ-9999"}}\`
+- Required parameter: \`portalID\` (string) - The portal ID (format: 2-4 letter prefix + dash + 4-15 digits, e.g., "PZ-9999")
+- Optional parameters:
+  - \`Dollar_lang\` (string, default: "en-US") - Language code
+  - \`acceptLanguage\` (string, default: "en-US") - Accept-Language header value
+  - \`dollarFilterTags\` (string) - Comma-separated list of Tag/Tag Group IDs
+  - \`workflowMilestone\` (string) - Workflow milestone filter ("authoring", "staging", "publish")
+  - \`Dollar_pagenum\` (number, default: 1) - Page number for pagination
+  - \`Dollar_pagesize\` (number, default: 10) - Number of results per page
+
+**Example**: To get announcements from portal "PZ-9999", call with:
+\`\`\`json
+{"request": {"portalID": "PZ-9999"}}
+\`\`\`
+
+**Example with optional parameters**:
+\`\`\`json
+{"request": {"portalID": "PZ-9999", "Dollar_lang": "en-US", "Dollar_pagesize": 20}}
+\`\`\`
+
+## Displaying Results (MCP-Specific)
+**CRITICAL**: When this tool returns data successfully, you MUST display the announcement articles to the user in your response. Do not silently process the data - always show the user what was returned.
+
+**What to display:**
+- Display all announcement articles with their names and IDs
+- Show the article content (\`content\` or \`contentText\`) for each announcement
+- Display metadata such as \`createdDate\`, \`modifiedDate\`, \`articleSummary\`
+- Show \`attachments\` if present
+- Include \`paginationInfo\` if pagination is used
+- Format announcements in a clear list format
+
+**Example**: "Here are the announcements for this portal: 1) [Announcement Name] (ID: PROD-123) - [content]..."
+
 ## Prerequisites
 - Requires a valid portal ID. If you don't have the portal ID, first call 'get-portals' to get available portals.
-- Portal ID format: 2-4 letter prefix + dash + 4-15 digits (e.g., "EB-123456789")
+- Portal ID format: 2-4 letter prefix + dash + 4-15 digits (e.g., "PROD-1004")
 
 ## Overview
 The Get Announcements API allows a user to retrieve all announcement articles for a specific portal. Announcements are special articles that are prominently displayed to users and typically contain important updates, news, or notifications.

package/esm/src/mcp-server/tools/getAnnouncements.js.map

@@ -1 +1 @@
-{"version":3,"file":"getAnnouncements.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getAnnouncements.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,wCAAwC,EAAE,MAAM,2CAA2C,CAAC;AACrG,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,wCAAwC;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAgC;IAChE,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;CAYd;IACC,WAAW,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,gBAAgB,CAC9C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
+{"version":3,"file":"getAnnouncements.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getAnnouncements.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,wCAAwC,EAAE,MAAM,2CAA2C,CAAC;AACrG,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,wCAAwC;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAgC;IAChE,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDd;IACC,WAAW,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,gBAAgB,CAC9C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/esm/src/mcp-server/tools/getArticle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getArticle.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getArticle.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,OAAO,IAAI,CA2CvD,CAAC"}
+{"version":3,"file":"getArticle.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getArticle.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,OAAO,IAAI,CAqFvD,CAAC"}

package/esm/src/mcp-server/tools/getArticle.js

@@ -13,6 +13,48 @@ export const tool$getArticle = {
 
 Get Article by ID
 
+## How to Use This Tool
+
+**CRITICAL**: This tool requires a \`request\` parameter containing the request object. All parameters must be passed inside a \`request\` object.
+
+**Parameter Format**: 
+- Always wrap parameters in a \`request\` object: \`{"request": {"portalID": "PZ-9999", "articleID": "PROD-2996"}}\`
+- Required parameters:
+  - \`portalID\` (string) - The portal ID (format: 2-4 letter prefix + dash + 4-15 digits, e.g., "PZ-9999")
+  - \`articleID\` (string) - The article ID (format: 2-4 letter prefix + dash + 4-15 digits, e.g., "PROD-2996")
+- Optional parameters:
+  - \`Dollar_lang\` (string, default: "en-US") - Language code
+  - \`acceptLanguage\` (string, default: "en-US") - Accept-Language header value
+  - \`articleAdditionalAttributes\` (array) - Additional article attributes to return
+  - \`Dollar_customAdditionalAttributes\` (string) - Custom additional attributes
+  - \`accessSource\` (string, default: "article_view") - How the article was accessed
+  - \`publishViewId\` (string) - Publish view ID
+  - \`workflowMilestone\` (string) - Workflow milestone filter
+
+**Example**: To get article "PROD-2996" from portal "PZ-9999", call with:
+\`\`\`json
+{"request": {"portalID": "PZ-9999", "articleID": "PROD-2996"}}
+\`\`\`
+
+**Example with optional parameters**:
+\`\`\`json
+{"request": {"portalID": "PZ-9999", "articleID": "PROD-2996", "Dollar_lang": "en-US", "accessSource": "article_view"}}
+\`\`\`
+
+## Displaying Results (MCP-Specific)
+**CRITICAL**: When this tool returns data successfully, you MUST display the article content to the user in your response. Do not silently process the data - always show the user what was returned.
+
+**What to display:**
+- Display the article \`name\` as the title
+- Show the article \`content\` or \`contentText\` (the full article body)
+- Display article metadata: \`id\`, \`articleType\`, \`createdDate\`, \`modifiedDate\`
+- Show \`attachments\` if present
+- Display \`topicBreadcrumb\` to show where the article is categorized
+- Include any other relevant metadata like \`articleSummary\`, \`description\`, \`articleKeywords\`
+- Format the article content in a readable way for the user
+
+**Example**: "Here's the article '[Article Name]' (ID: PROD-2996): [article content]. This article is categorized under: [topic breadcrumb]..."
+
 ## Prerequisites
 - Requires a valid portal ID. If you don't have the portal ID, first call 'get-portals' to get available portals.
 - Portal ID format: 2-4 letter prefix + dash + 4-15 digits (e.g., "EB-123456789")

package/esm/src/mcp-server/tools/getArticle.js.map

@@ -1 +1 @@
-{"version":3,"file":"getArticle.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getArticle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,+BAA+B;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgC;IAC1D,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;CAed;IACC,WAAW,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,UAAU,CACxC,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
+{"version":3,"file":"getArticle.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getArticle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,+BAA+B;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgC;IAC1D,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDd;IACC,WAAW,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,UAAU,CACxC,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/esm/src/mcp-server/tools/getArticleById.d.ts

@@ -0,0 +1,7 @@
+import { ToolDefinition } from "../tools.js";
+declare const args: {
+    request: import("zod").ZodType<import("../../models/getarticlebyidop.js").GetArticleByIdRequest, unknown, import("zod/v4/core").$ZodTypeInternals<import("../../models/getarticlebyidop.js").GetArticleByIdRequest, unknown>>;
+};
+export declare const tool$getArticleById: ToolDefinition<typeof args>;
+export {};
+//# sourceMappingURL=getArticleById.d.ts.map

package/esm/src/mcp-server/tools/getArticleById.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getArticleById.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getArticleById.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,OAAO,IAAI,CAsF3D,CAAC"}

package/esm/src/mcp-server/tools/getArticleById.js

@@ -0,0 +1,90 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { getArticleById } from "../../funcs/getArticleById.js";
+import { GetArticleByIdRequest$zodSchema } from "../../models/getarticlebyidop.js";
+import { formatResult } from "../tools.js";
+const args = {
+    request: GetArticleByIdRequest$zodSchema,
+};
+export const tool$getArticleById = {
+    name: "get-article-by-id",
+    description: `Get Article by ID
+
+Get Article by ID
+
+## How to Use This Tool
+
+**CRITICAL**: This tool requires a \`request\` parameter containing the request object. All parameters must be passed inside a \`request\` object.
+
+**Parameter Format**: 
+- Always wrap parameters in a \`request\` object: \`{"request": {"portalID": "PZ-9999", "articleID": "PROD-2996"}}\`
+- Required parameters:
+  - \`portalID\` (string) - The portal ID (format: 2-4 letter prefix + dash + 4-15 digits, e.g., "PZ-9999")
+  - \`articleID\` (string) - The article ID (format: 2-4 letter prefix + dash + 4-15 digits, e.g., "PROD-2996")
+  - \`acceptLanguage\` (string, default: "en-US") - Accept-Language header value
+- Optional parameters:
+  - \`Dollar_lang\` (string, default: "en-US") - Language code
+  - \`articleAdditionalAttributes\` (array) - Additional article attributes to return
+  - \`Dollar_customAdditionalAttributes\` (string) - Custom additional attributes
+  - \`accessSource\` (string, default: "article_view") - How the article was accessed
+  - \`publishViewId\` (string) - Publish view ID
+  - \`workflowMilestone\` (string) - Workflow milestone filter
+
+**Example**: To get article "PROD-2996" from portal "PZ-9999", call with:
+\`\`\`json
+{"request": {"portalID": "PZ-9999", "articleID": "PROD-2996"}}
+\`\`\`
+
+**Example with optional parameters**:
+\`\`\`json
+{"request": {"portalID": "PZ-9999", "articleID": "PROD-2996", "Dollar_lang": "en-US", "accessSource": "article_view"}}
+\`\`\`
+
+## Displaying Results (MCP-Specific)
+**CRITICAL**: When this tool returns data successfully, you MUST display the article content to the user in your response. Do not silently process the data - always show the user what was returned.
+
+**What to display:**
+- Display the article \`name\` as the title
+- Show the article \`content\` or \`contentText\` (the full article body)
+- Display article metadata: \`id\`, \`articleType\`, \`createdDate\`, \`modifiedDate\`
+- Show \`attachments\` if present
+- Display \`topicBreadcrumb\` to show where the article is categorized
+- Include any other relevant metadata like \`articleSummary\`, \`description\`, \`articleKeywords\`
+- Format the article content in a readable way for the user
+
+**Example**: "Here's the article '[Article Name]' (ID: PROD-2996): [article content]. This article is categorized under: [topic breadcrumb]..."
+
+## Prerequisites
+- Requires a valid portal ID. If you don't have the portal ID, first call 'get-portals' to get available portals.
+- Portal ID format: 2-4 letter prefix + dash + 4-15 digits (e.g., "EB-123456789")
+- Requires a valid article ID. Article ID format: 2-4 letter prefix + dash + 4-15 digits (e.g., "PROD-2996")
+
+## Overview
+The Get Article by ID API allows a user to retrieve a specific article using its ID. Additional article attributes and contextual views can be specified in the query parameters.
+
+This API returns structured authoring attributes of Issue, Environment, Cause and Confidence Level when the following conditions are met:
+- The "Allow Structured Authoring" setting is enabled at the partition/department level
+- The "Use Structured Authoring" flag is set on the article type
+`,
+    annotations: {
+        "title": "",
+        "destructiveHint": false,
+        "idempotentHint": false,
+        "openWorldHint": false,
+        "readOnlyHint": true,
+    },
+    args,
+    tool: async (client, args, ctx) => {
+        const [result, apiCall] = await getArticleById(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+        if (!result.ok) {
+            return {
+                content: [{ type: "text", text: result.error.message }],
+                isError: true,
+            };
+        }
+        const value = result.value;
+        return formatResult(value, apiCall);
+    },
+};
+//# sourceMappingURL=getArticleById.js.map

package/esm/src/mcp-server/tools/getArticleById.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getArticleById.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getArticleById.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,+BAA+B;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC9D,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDd;IACC,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,cAAc,CAC5C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/esm/src/mcp-server/tools/getBestAnswer.d.ts

@@ -0,0 +1,7 @@
+import { ToolDefinition } from "../tools.js";
+declare const args: {
+    request: import("zod").ZodType<import("../../models/getbestanswerop.js").GetBestAnswerRequest, unknown, import("zod/v4/core").$ZodTypeInternals<import("../../models/getbestanswerop.js").GetBestAnswerRequest, unknown>>;
+};
+export declare const tool$getBestAnswer: ToolDefinition<typeof args>;
+export {};
+//# sourceMappingURL=getBestAnswer.d.ts.map

package/esm/src/mcp-server/tools/getBestAnswer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBestAnswer.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getBestAnswer.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,IAAI,CAiF1D,CAAC"}

package/esm/src/mcp-server/tools/getBestAnswer.js

@@ -0,0 +1,85 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { getBestAnswer } from "../../funcs/getBestAnswer.js";
+import { GetBestAnswerRequest$zodSchema } from "../../models/getbestanswerop.js";
+import { formatResult } from "../tools.js";
+const args = {
+    request: GetBestAnswerRequest$zodSchema,
+};
+export const tool$getBestAnswer = {
+    name: "get-best-answer",
+    description: `Generate an Answer
+
+Get Answers
+
+## How to Use This Tool
+
+**CRITICAL**: This tool requires a \`request\` parameter containing the request object. All parameters must be passed inside a \`request\` object.
+
+**Parameter Format**: 
+- Always wrap parameters in a \`request\` object: \`{"request": {"portalID": "PZ-9999", "q": "loan information", "Dollar_lang": "en-US"}}\`
+- Required parameters:
+  - \`portalID\` (string) - The portal ID (format: 2-4 letter prefix + dash + 4-15 digits, e.g., "PZ-9999")
+  - \`q\` (string) - The search query string
+  - \`Dollar_lang\` (string) - Language code (e.g., "en-US")
+- Optional parameters:
+  - \`dollarFilterUserProfileID\` (string) - User profile ID filter
+  - \`dollarFilterTags\` (object) - Object where keys are Category Tag IDs and values are arrays of Tag IDs
+  - \`dollarFilterTopicIds\` (array) - Array of topic IDs to filter by
+  - \`AnswersRequest\` (object) - Request body parameters:
+    - \`eventId\` (string, **required**) - Event ID
+    - \`sessionId\` (string, **required**) - Session ID
+    - \`channel\` (object, **optional**, recommended to omit) - Channel information. Omit unless specifically needed. If you receive a 400 error with channel, retry without it.
+    - \`context\` (object) - Additional context (companyContext, pageContext, userContext)
+
+**Example**: To get answers for query "loan information" from portal "PZ-9999", call with:
+\`\`\`json
+{"request": {"portalID": "PZ-9999", "q": "loan information", "Dollar_lang": "en-US", "AnswersRequest": {"eventId": "event-123", "sessionId": "session-456"}}}
+\`\`\`
+
+**Note**: The \`channel\` field in \`AnswersRequest\` is optional and recommended to omit unless specifically needed. The API works reliably without it.
+
+## Displaying Results (MCP-Specific)
+**CRITICAL**: When this tool returns data successfully, you MUST display the results to the user in your response. Do not silently process the data - always show the user what was returned.
+
+**What to display:**
+- Display the \`answer.answerValue\` text prominently as the main answer to the user's query
+- Indicate the answer type (\`answerType\`: "certified" or "generative")
+- If \`relevanceScore\` is present, you may mention the confidence level
+- List all \`references\` (article IDs and names) that were used to generate the answer
+- Display \`searchResults\` showing related articles with their names, IDs, snippets, and relevance scores
+- Format the answer in a clear, readable way - this is the primary response the user is seeking
+
+**Example**: "Based on the knowledge base, here's the answer: [answerValue]. This answer was generated using information from: [list references]. Related articles: [list search results]..."
+
+## Prerequisites
+- Requires a valid portal ID. If you don't have the portal ID, first call 'get-portals' to get available portals.
+- Portal ID format: 2-4 letter prefix + dash + 4-15 digits (e.g., "PROD-1004")
+
+## Overview
+The Answers API enables users to get the best answer for a user query. This API can return certified answers or generative answers along with search results, providing users with comprehensive responses to their questions.
+
+The API leverages AI capabilities to provide intelligent answers based on the knowledge base content, making it easier for users to find the information they need quickly and accurately.
+`,
+    annotations: {
+        "title": "",
+        "destructiveHint": false,
+        "idempotentHint": false,
+        "openWorldHint": false,
+        "readOnlyHint": false,
+    },
+    args,
+    tool: async (client, args, ctx) => {
+        const [result, apiCall] = await getBestAnswer(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+        if (!result.ok) {
+            return {
+                content: [{ type: "text", text: result.error.message }],
+                isError: true,
+            };
+        }
+        const value = result.value;
+        return formatResult(value, apiCall);
+    },
+};
+//# sourceMappingURL=getBestAnswer.js.map

package/esm/src/mcp-server/tools/getBestAnswer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBestAnswer.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getBestAnswer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,8BAA8B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDd;IACC,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,aAAa,CAC3C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/esm/src/mcp-server/tools/getMyPortals.d.ts

@@ -0,0 +1,7 @@
+import { ToolDefinition } from "../tools.js";
+declare const args: {
+    request: import("zod").ZodType<import("../../models/getmyportalsop.js").GetMyPortalsRequest, unknown, import("zod/v4/core").$ZodTypeInternals<import("../../models/getmyportalsop.js").GetMyPortalsRequest, unknown>>;
+};
+export declare const tool$getMyPortals: ToolDefinition<typeof args>;
+export {};
+//# sourceMappingURL=getMyPortals.d.ts.map

package/esm/src/mcp-server/tools/getMyPortals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMyPortals.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getMyPortals.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,OAAO,IAAI,CAiHzD,CAAC"}

package/esm/src/mcp-server/tools/getMyPortals.js

@@ -0,0 +1,117 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { getMyPortals } from "../../funcs/getMyPortals.js";
+import { GetMyPortalsRequest$zodSchema } from "../../models/getmyportalsop.js";
+import { formatResult } from "../tools.js";
+const args = {
+    request: GetMyPortalsRequest$zodSchema,
+};
+export const tool$getMyPortals = {
+    name: "get-my-portals",
+    description: `Get All Portals Accessible To User
+
+Get All Portals Accessible to User
+
+## Overview
+Retrieves the list of portals available to the authenticated user or application. Each portal contains a readable portal ID that is required by almost all other Portal Manager APIs.
+
+- If no access tags are specified for a portal, any user can access the portal.
+- If access tags are specified for a portal, users with a user profile that allows access can access the portal. For users with multiple user profiles, the user profile that allows access does not need to be the active user profile.
+- Global users (partition) cannot be assigned user profiles; their access is limited to portals without access restrictions.
+- The only articles returned are associated to an Article type when the parameter “Include in browse on portals” is set to "Yes".
+- When the \`shortUrlTemplate\` query parameter is provided, the API filters accessible portals according to the specified language and template name. A portal short URL specific to the \`shortUrlTemplate\` value is returned in the response when available. If there is no short URL for a language, the portal object returns an empty \`shortURL\` field.
+
+## Prerequisites
+Authentication is required. No portal ID is needed for this call. This is typically the first API you should call before using any other tool.
+
+## How to Use This Tool
+- Call this endpoint to discover which portals you have access to. Use the returned portal IDs as inputs to Retrieve, Answers, Search, Article, and Suggestion APIs.
+
+## Parameter Requirements
+This tool requires **both** a query language parameter **and** an HTTP language header. An empty request object is **invalid** and MUST NOT be used.
+
+### Required (both MUST be provided)
+- \`Dollar_lang\` (string, default: "en-US") - Language code
+- \`Accept-Language\` (string, default: "en-US") - Accept-Language header value
+
+Both parameters **MUST** be present on every invocation.  
+If either parameter is missing, the request is invalid.
+
+#### Optional
+
+- \`Dollar_pagenum\` — Page number to retrieve (defaults to \`1\` if omitted)
+- \`Dollar_pagesize\` — Number of items per page (server default applied if omitted)
+
+**Example**: To get all portals accessible to the user, call with:
+\`\`\`json
+{"request": {"Dollar_lang": "en-US", "Accept-Language": "en-US"}}
+\`\`\`
+
+## Overview
+The Get All Portals Accessible to User API allows a user to fetch all portals accessible to the user across all departments.
+
+## Pagination behavior (CRITICAL for AI assistants)
+
+**IMPORTANT**: This endpoint is paginated. When searching for a portal by name or listing portals, you MUST automatically fetch ALL pages before concluding that a portal doesn't exist.
+
+### Automatic pagination is REQUIRED when:
+- User asks to find a portal by name (e.g., "business portal", "Master portal")
+- User requests to list or see all portals
+- You need to resolve a natural portal name to its ID
+
+### How to detect more pages exist:
+The response includes \`paginationInfo\` with:
+- \`count\`: Total number of items across all pages
+- \`pagenum\`: Current page number
+- \`pagesize\`: Items per page (default: 25)
+
+**Check for more pages if ANY of these are true:**
+1. The number of portals returned equals \`pagesize\` (e.g., exactly 25 portals returned)
+2. \`paginationInfo.count > (pagenum * pagesize)\` - there are more items beyond this page
+3. The response includes a \`link\` array with a \`next\` relation
+
+### Required pagination workflow:
+1. Start with \`$pagenum=1\` and \`$pagesize=25\` (default)
+2. After receiving the response, check \`paginationInfo\`
+3. **If more pages exist** (using the checks above), automatically call this endpoint again with \`$pagenum=2\`, then \`$pagenum=3\`, etc.
+4. Continue incrementing \`$pagenum\` until:
+   - A page returns fewer portals than \`pagesize\` (indicating the last page)
+   - A page returns zero portals
+   - \`pagenum * pagesize >= paginationInfo.count\` (if count represents total items)
+5. Merge all portals from all pages by unique portal ID
+6. Only then search through the complete merged list or report results to the user
+
+### Example scenario:
+If you search for "business portal" and the first page returns 25 portals but none match:
+- DO NOT immediately tell the user the portal doesn't exist
+- Check \`paginationInfo.count\` - if it's > 25, automatically fetch page 2
+- Continue fetching until all pages are retrieved
+- Search the complete merged list before concluding the portal doesn't exist
+
+This ensures reliable portal name-to-ID resolution and prevents false "not found" errors.
+
+## Displaying Results (MCP-Specific)
+Always display the list of portals returned. Show portal name, portal ID, and any descriptive metadata. If multiple portals exist, prompt the user to select one for subsequent calls.
+`,
+    annotations: {
+        "title": "",
+        "destructiveHint": false,
+        "idempotentHint": false,
+        "openWorldHint": false,
+        "readOnlyHint": true,
+    },
+    args,
+    tool: async (client, args, ctx) => {
+        const [result, apiCall] = await getMyPortals(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+        if (!result.ok) {
+            return {
+                content: [{ type: "text", text: result.error.message }],
+                isError: true,
+            };
+        }
+        const value = result.value;
+        return formatResult(value, apiCall);
+    },
+};
+//# sourceMappingURL=getMyPortals.js.map

package/esm/src/mcp-server/tools/getMyPortals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMyPortals.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getMyPortals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,6BAA6B;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAgC;IAC5D,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFd;IACC,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,YAAY,CAC1C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/esm/src/mcp-server/tools/getPopularArticles.d.ts

@@ -1,6 +1,6 @@
 import { ToolDefinition } from "../tools.js";
 declare const args: {
-    request: import("zod").ZodType<import("../../models/getpopulararticlesop.js").GetpopulararticlesRequest, import("zod").ZodTypeDef, unknown>;
+    request: import("zod").ZodType<import("../../models/getpopulararticlesop.js").GetpopulararticlesRequest, unknown, import("zod/v4/core").$ZodTypeInternals<import("../../models/getpopulararticlesop.js").GetpopulararticlesRequest, unknown>>;
 };
 export declare const tool$getPopularArticles: ToolDefinition<typeof args>;
 export {};

package/esm/src/mcp-server/tools/getPopularArticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPopularArticles.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getPopularArticles.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAAC,OAAO,IAAI,CAwC/D,CAAC"}
+{"version":3,"file":"getPopularArticles.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getPopularArticles.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAAC,OAAO,IAAI,CAgF/D,CAAC"}

package/esm/src/mcp-server/tools/getPopularArticles.js

@@ -13,6 +13,45 @@ export const tool$getPopularArticles = {
 
 Get Popular Articles
 
+## How to Use This Tool
+
+**CRITICAL**: This tool requires a \`request\` parameter containing the request object. All parameters must be passed inside a \`request\` object.
+
+**Parameter Format**: 
+- Always wrap parameters in a \`request\` object: \`{"request": {"portalID": "PZ-9999"}}\`
+- Required parameter:
+  - \`portalID\` (string) - The portal ID (format: 2-4 letter prefix + dash + 4-15 digits, e.g., "PZ-9999")
+  - \`acceptLanguage\` (string, default: "en-US") - Accept-Language header value
+- Optional parameters:
+  - \`Dollar_lang\` (string, default: "en-US") - Language code
+  - \`Dollar_pagenum\` (number, default: 1) - Page number for pagination
+  - \`Dollar_pagesize\` (number, default: 10) - Number of results per page
+  - \`dollarFilterTopicId\` (string) - Filter by topic ID
+  - \`dollarFilterTags\` (string) - Comma-separated list of Tag/Tag Group IDs
+
+**Example**: To get popular articles from portal "PZ-9999", call with:
+\`\`\`json
+{"request": {"portalID": "PZ-9999"}}
+\`\`\`
+
+**Example with optional parameters**:
+\`\`\`json
+{"request": {"portalID": "PZ-9999", "Dollar_lang": "en-US", "Dollar_pagesize": 20}}
+\`\`\`
+
+## Displaying Results (MCP-Specific)
+**CRITICAL**: When this tool returns data successfully, you MUST display the popular articles to the user in your response. Do not silently process the data - always show the user what was returned.
+
+**What to display:**
+- Display all popular articles with their names and IDs
+- Show article summaries or descriptions when available
+- Display metadata such as \`articleType\`, \`createdDate\`, \`modifiedDate\`
+- Show \`imageURL\` if available (mention thumbnail availability)
+- Include \`paginationInfo\` if pagination is used
+- Format articles in a numbered or bulleted list
+
+**Example**: "Here are the most popular articles: 1) [Article Name] (ID: PROD-123) - [summary]..."
+
 ## Prerequisites
 - Requires a valid portal ID. If you don't have the portal ID, first call 'get-portals' to get available portals.
 - Portal ID format: 2-4 letter prefix + dash + 4-15 digits (e.g., "EB-123456789")
@@ -23,6 +62,7 @@ The Popular Articles API allows a user to retrieve the most popular articles fro
 This API returns a list of popular articles with their metadata, allowing users to discover the most relevant and frequently accessed content within the portal.
 `,
     annotations: {
+        "title": "",
         "destructiveHint": false,
         "idempotentHint": false,
         "openWorldHint": false,

package/esm/src/mcp-server/tools/getPopularArticles.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPopularArticles.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getPopularArticles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,mCAAmC,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,mCAAmC;CAC7C,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAgC;IAClE,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;;;CAYd;IACC,WAAW,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,kBAAkB,CAChD,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
+{"version":3,"file":"getPopularArticles.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getPopularArticles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,mCAAmC,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,mCAAmC;CAC7C,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAgC;IAClE,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDd;IACC,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,kBAAkB,CAChD,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/esm/src/mcp-server/tools/getPortals.d.ts

@@ -1,6 +1,6 @@
 import { ToolDefinition } from "../tools.js";
 declare const args: {
-    request: import("zod").ZodType<import("../../models/getmyportalsop.js").GetMyPortalsRequest, import("zod").ZodTypeDef, unknown>;
+    request: import("zod").ZodOptional<import("zod").ZodType<import("../../models/getmyportalsop.js").GetMyPortalsRequest, import("zod").ZodTypeDef, unknown>>;
 };
 export declare const tool$getPortals: ToolDefinition<typeof args>;
 export {};

package/esm/src/mcp-server/tools/getPortals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPortals.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getPortals.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,OAAO,IAAI,CA+EvD,CAAC"}
+{"version":3,"file":"getPortals.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getPortals.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,OAAO,IAAI,CAwGvD,CAAC"}

package/esm/src/mcp-server/tools/getPortals.js

@@ -5,7 +5,7 @@ import { getPortals } from "../../funcs/getPortals.js";
 import { GetMyPortalsRequest$zodSchema } from "../../models/getmyportalsop.js";
 import { formatResult } from "../tools.js";
 const args = {
-    request: GetMyPortalsRequest$zodSchema,
+    request: GetMyPortalsRequest$zodSchema.optional(),
 };
 export const tool$getPortals = {
     name: "get-portals",
@@ -13,6 +13,15 @@ export const tool$getPortals = {
 
 Get All Portals Accessible to User
 
+## How to Use This Tool
+
+**Parameter Format**: This tool requires a \`request\` parameter containing the request object.
+- **CRITICAL**: All parameters in this tool are optional. You may pass an empty request object: \`{"request": {}}\`
+- If you want to specify a language, pass: \`{"request": {"Dollar_lang": "en-US"}}\`
+- The \`Dollar_lang\` parameter is **optional** - if omitted, the API defaults to "en-US"
+- **Example with empty request** (recommended if you don't need to specify language): \`{"request": {}}\`
+- **Example with language**: \`{"request": {"Dollar_lang": "en-US"}}\`
+
 ## Overview
 The Get All Portals Accessible to User API allows a user to fetch all portals accessible to the user across all departments.
 - If no access tags are specified for a portal, any user can access the portal.
@@ -60,6 +69,22 @@ If you search for "business portal" and the first page returns 25 portals but no
 - Search the complete merged list before concluding the portal doesn't exist
 
 This ensures reliable portal name-to-ID resolution and prevents false "not found" errors.
+
+## Displaying Results (MCP-Specific)
+**CRITICAL**: When this tool returns data successfully, you MUST display the portal information to the user in your response. Do not silently process the data - always show the user what was returned.
+
+**What to display:**
+- Display all portals with their names and IDs
+- Show portal \`id\` (the portal ID needed for other API calls)
+- Display portal \`name\` (the human-readable portal name)
+- Show \`departmentName\` if available
+- Include \`shortURL\` if available
+- Display \`paginationInfo\` to show total count and current page
+- Format portals in a clear list format (e.g., "Portal Name (ID: PORTAL-123)")
+
+**Example**: "Here are the available portals: 1) Business Portal (ID: PORTAL-123), 2) Customer Portal (ID: PORTAL-456)..."
+
+**Important**: Always display portal IDs clearly, as users will need these IDs to call other tools.
 `,
     annotations: {
         "destructiveHint": false,

package/esm/src/mcp-server/tools/getPortals.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPortals.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getPortals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,6BAA6B;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgC;IAC1D,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDd;IACC,WAAW,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,UAAU,CACxC,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
+{"version":3,"file":"getPortals.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/getPortals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,6BAA6B,CAAC,QAAQ,EAAE;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgC;IAC1D,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Ed;IACC,WAAW,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,UAAU,CACxC,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/esm/src/mcp-server/tools/makeSuggestion.d.ts

@@ -1,6 +1,6 @@
 import { ToolDefinition } from "../tools.js";
 declare const args: {
-    request: import("zod").ZodType<import("../../models/makesuggestionop.js").MakeSuggestionRequest, import("zod").ZodTypeDef, unknown>;
+    request: import("zod").ZodType<import("../../models/makesuggestionop.js").MakeSuggestionRequest, unknown, import("zod/v4/core").$ZodTypeInternals<import("../../models/makesuggestionop.js").MakeSuggestionRequest, unknown>>;
 };
 export declare const tool$makeSuggestion: ToolDefinition<typeof args>;
 export {};

package/esm/src/mcp-server/tools/makeSuggestion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makeSuggestion.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/makeSuggestion.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,OAAO,IAAI,CAwC3D,CAAC"}
+{"version":3,"file":"makeSuggestion.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/makeSuggestion.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,OAAO,IAAI,CAoF3D,CAAC"}