@smartbear/mcp 0.9.0 → 0.10.0

package/README.md

@@ -9,7 +9,7 @@
 
   <!-- Badges -->
   <div>
-    <a href="https://github.com/SmartBear/smartbear-mcp/actions/workflows/node-ci.yml"><img src="https://github.com/SmartBear/smartbear-mcp/actions/workflows/node-ci.yml/badge.svg?branch=next" alt="Test Status"></a>
+    <a href="https://github.com/SmartBear/smartbear-mcp/actions/workflows/test.yml"><img src="https://github.com/SmartBear/smartbear-mcp/actions/workflows/test.yml/badge.svg?branch=main" alt="Test Status"></a>
     <a href="https://smartbear.github.io/smartbear-mcp/"><img src="https://img.shields.io/badge/coverage-dynamic-brightgreen" alt="Coverage"></a>
     <a href="https://www.npmjs.com/package/@smartbear/mcp"><img src="https://img.shields.io/npm/v/@smartbear/mcp" alt="npm version"></a>
     <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-Compatible-blue" alt="MCP Compatible"></a>
@@ -18,7 +18,7 @@
 </div>
 <br />
 
-A Model Context Protocol (MCP) server which provides AI assistants with seamless access to SmartBear's suite of testing and monitoring tools, including [BugSnag](https://www.bugsnag.com/), [Reflect](https://reflect.run), [API Hub](https://www.smartbear.com/api-hub), [PactFlow](https://pactflow.io/), [Pact Broker](https://docs.pact.io/), [QMetry](https://www.qmetry.com/), and [Zephyr](https://smartbear.com/test-management/zephyr/).
+A Model Context Protocol (MCP) server which provides AI assistants with seamless access to SmartBear's suite of testing and monitoring tools, including [BugSnag](https://www.bugsnag.com/), [Reflect](https://reflect.run), [API Hub](https://www.smartbear.com/api-hub), [PactFlow](https://pactflow.io/), [Pact Broker](https://docs.pact.io/), [QMetry](https://www.qmetry.com/), [Zephyr](https://smartbear.com/test-management/zephyr/) and [Collaborator](https://smartbear.com/product/collaborator/).
 
 ## What is MCP?
 
@@ -34,6 +34,7 @@ See individual guides for suggested prompts and supported tools and resources:
 - [PactFlow](https://developer.smartbear.com/pactflow/default/getting-started) - Contract testing capabilities
 - [QMetry](https://developer.smartbear.com/smartbear-mcp/docs/qmetry-integration) - QMetry Test Management capabilities
 - [Zephyr](https://developer.smartbear.com/smartbear-mcp/docs/zephyr-integration) - Zephyr Test Management capabilities
+- [Collaborator](https://developer.smartbear.com/smartbear-mcp/docs/collaborator-integration) - Review and Remote System Configuration management capabilities
 
 
 ## Prerequisites
@@ -79,7 +80,10 @@ Alternatively, you can use `npx` (or globally install) the `@smartbear/mcp` pack
         "QMETRY_API_KEY": "${input:qmetry_api_key}",
         "QMETRY_BASE_URL": "${input:qmetry_base_url}",
         "ZEPHYR_API_TOKEN": "${input:zephyr_api_token}",
-        "ZEPHYR_BASE_URL": "${input:zephyr_base_url}"
+        "ZEPHYR_BASE_URL": "${input:zephyr_base_url}",
+        "COLLAB_BASE_URL": "${input:collab_base_url}",
+        "COLLAB_USERNAME": "${input:collab_username}",
+        "COLLAB_LOGIN_TICKET": "${input:collab_login_ticket}"
       }
     }
   },
@@ -155,6 +159,24 @@ Alternatively, you can use `npx` (or globally install) the `@smartbear/mcp` pack
           "type": "promptString",
           "description": "Zephyr API base URL. By default, connects to https://api.zephyrscale.smartbear.com/v2. Change to region-specific endpoint if needed.",
           "password": false
+      },
+      {
+          "id": "collab_base_url",
+          "type": "promptString",
+          "description": "Collab base url",
+          "password": true
+      },
+      {
+          "id": "collab_username",
+          "type": "promptString",
+          "description": "Collab username",
+          "password": true
+      },
+      {
+          "id": "collab_login_ticket",
+          "type": "promptString",
+          "description": "Collab login ticket",
+          "password": true
       }
   ]
 }
@@ -186,7 +208,10 @@ Add the following configuration to your `claude_desktop_config.json` to launch t
         "QMETRY_API_KEY": "your_qmetry_api_key",
         "QMETRY_BASE_URL": "https://testmanagement.qmetry.com",
         "ZEPHYR_API_TOKEN": "your_zephyr_api_token",
-        "ZEPHYR_BASE_URL": "https://api.zephyrscale.smartbear.com/v2"
+        "ZEPHYR_BASE_URL": "https://api.zephyrscale.smartbear.com/v2",
+        "COLLAB_BASE_URL": "your collab base url",
+        "COLLAB_USERNAME": "your collab user name",
+        "COLLAB_LOGIN_TICKET": "your collab login ticket"
       }
     }
   }

package/dist/api-hub/client/api.js

@@ -83,6 +83,34 @@ export class ApiHubAPI {
         const result = await this.handleResponse(response, []);
         return result;
     }
+    async getOrganizations(params) {
+        // Build query string if parameters are provided
+        const searchParams = new URLSearchParams();
+        if (params?.q)
+            searchParams.append("q", params.q);
+        if (params?.sortBy)
+            searchParams.append("sortBy", params.sortBy);
+        if (params?.order)
+            searchParams.append("order", params.order);
+        if (params?.page !== undefined)
+            searchParams.append("page", params.page.toString());
+        if (params?.pageSize)
+            searchParams.append("pageSize", params.pageSize.toString());
+        const queryString = searchParams.toString();
+        const url = `${this.config.userManagementBasePath}/orgs${queryString ? `?${queryString}` : ""}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        const defaultResponse = {
+            items: [],
+            totalCount: 0,
+            pageSize: 50,
+            page: 0,
+        };
+        const result = await this.handleResponse(response, defaultResponse);
+        return result;
+    }
     async createPortal(body) {
         const response = await fetch(`${this.config.portalBasePath}/portals`, {
             method: "POST",
@@ -172,6 +200,166 @@ export class ApiHubAPI {
             success: true,
         });
     }
+    async publishPortalProduct(productId, preview = false) {
+        const response = await fetch(`${this.config.portalBasePath}/products/${productId}/published-content?preview=${preview}`, {
+            method: "PUT",
+            headers: this.headers,
+        });
+        return this.handleResponse(response, {
+            success: true,
+        });
+    }
+    async getPortalProductSections(productId, params) {
+        const queryParameters = new URLSearchParams();
+        if (params.embed) {
+            for (const item of params.embed) {
+                queryParameters.append("embed", item);
+            }
+        }
+        if (params.page !== undefined) {
+            queryParameters.append("page", params.page.toString());
+        }
+        if (params.size !== undefined) {
+            queryParameters.append("size", params.size.toString());
+        }
+        const url = `${this.config.portalBasePath}/products/${productId}/sections${queryParameters.toString() ? `?${queryParameters.toString()}` : ""}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        const result = await this.handleResponse(response, []);
+        return result;
+    }
+    /**
+     * Create a new table of contents item in a portal product section
+     * @param sectionId - Section ID where the table of contents item will be created
+     * @param body - Table of contents creation parameters
+     * @returns Created table of contents item with metadata
+     */
+    async createTableOfContents(sectionId, body) {
+        const url = `${this.config.portalBasePath}/sections/${sectionId}/table-of-contents`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API Hub createTableOfContents failed - status: ${response.status} ${response.statusText}. Response: ${errorText}`);
+        }
+        const result = await response.json();
+        return result;
+    }
+    /**
+     * Get table of contents for a section
+     * @param args - Parameters for retrieving table of contents
+     * @returns List of table of contents items
+     */
+    async getTableOfContents(args) {
+        const { sectionId, embed, page, size } = args;
+        const searchParams = new URLSearchParams();
+        if (embed) {
+            for (const item of embed) {
+                searchParams.append("embed", item);
+            }
+        }
+        if (page !== undefined) {
+            searchParams.set("page", page.toString());
+        }
+        if (size !== undefined) {
+            searchParams.set("size", size.toString());
+        }
+        const url = `${this.config.portalBasePath}/sections/${sectionId}/table-of-contents${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API Hub getTableOfContents failed - status: ${response.status} ${response.statusText}. Response: ${errorText}`);
+        }
+        const result = await response.json();
+        // The API returns a paginated response, so we extract the items array
+        return result.items;
+    }
+    /**
+     * Get document content and metadata
+     * @param args - Parameters for retrieving document
+     * @returns Document with content and metadata
+     */
+    async getDocument(args) {
+        const { documentId } = args;
+        const url = `${this.config.portalBasePath}/documents/${documentId}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API Hub getDocument failed - status: ${response.status} ${response.statusText}. Response: ${errorText}`);
+        }
+        const result = await response.json();
+        return result;
+    }
+    /**
+     * Update document content
+     * @param args - Parameters for updating document
+     * @returns Success response
+     */
+    async updateDocument(args) {
+        const { documentId, ...body } = args;
+        const url = `${this.config.portalBasePath}/documents/${documentId}`;
+        const response = await fetch(url, {
+            method: "PATCH",
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API Hub updateDocument failed - status: ${response.status} ${response.statusText}. Response: ${errorText}`);
+        }
+        return { success: true };
+    }
+    /**
+     * Delete document
+     * @param args - Parameters for deleting document
+     * @returns Success response
+     */
+    async deleteDocument(args) {
+        const { documentId } = args;
+        const url = `${this.config.portalBasePath}/documents/${documentId}`;
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API Hub deleteDocument failed - status: ${response.status} ${response.statusText}. Response: ${errorText}`);
+        }
+        return { success: true };
+    }
+    /**
+     * Delete table of contents entry
+     * @param args - Parameters for deleting table of contents entry
+     * @returns Success response
+     */
+    async deleteTableOfContents(args) {
+        const { tableOfContentsId, recursive } = args;
+        const searchParams = new URLSearchParams();
+        if (recursive !== undefined) {
+            searchParams.set("recursive", recursive.toString());
+        }
+        const url = `${this.config.portalBasePath}/table-of-contents/${tableOfContentsId}${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API Hub deleteTableOfContents failed - status: ${response.status} ${response.statusText}. Response: ${errorText}`);
+        }
+        return { success: true };
+    }
     /**
      * Helper method for handling responses when error checking is already done.
      * Delegates to parseResponse for the actual parsing logic.

package/dist/api-hub/client/configuration.js

@@ -2,6 +2,7 @@ export class ApiHubConfiguration {
     token;
     portalBasePath;
     registryBasePath;
+    userManagementBasePath;
     headers;
     constructor(param) {
         this.token = param.token;
@@ -9,6 +10,10 @@ export class ApiHubConfiguration {
             param.portalBasePath || "https://api.portal.swaggerhub.com/v1";
         this.registryBasePath =
             param.registryBasePath || "https://api.swaggerhub.com";
+        this.userManagementBasePath =
+            param.userManagementBasePath ||
+                "https://api.swaggerhub.com/user-management/v1";
+        // Use Bearer token format consistently across all APIs
         this.headers = {
             Authorization: `Bearer ${this.token}`,
             "Content-Type": "application/json",

package/dist/api-hub/client/index.js

@@ -3,3 +3,4 @@ export { ApiHubConfiguration, } from "./configuration.js";
 export * from "./portal-types.js";
 export * from "./registry-types.js";
 export { TOOLS } from "./tools.js";
+export * from "./user-management-types.js";

package/dist/api-hub/client/portal-types.js

@@ -10,6 +10,93 @@ export const ProductArgsSchema = z.object({
         .string()
         .describe("Product UUID or identifier in the format 'portal-subdomain:product-slug' - unique identifier for the product"),
 });
+export const GetProductSectionsArgsSchema = z.object({
+    productId: z
+        .string()
+        .describe("Product UUID or identifier in the format 'portal-subdomain:product-slug' - unique identifier for the product"),
+    embed: z
+        .array(z.string())
+        .optional()
+        .describe("List of related entities to embed in the response - e.g., ['tableOfContents', 'tableOfContents.swaggerhubApi'] to include table of contents and SwaggerHub API details"),
+    page: z
+        .number()
+        .optional()
+        .describe("Page number for paginated results - specifies which page of results to retrieve (default is 1)"),
+    size: z
+        .number()
+        .optional()
+        .describe("Number of items per page for pagination - controls how many results are returned per page (default is 20)"),
+});
+export const GetTableOfContentsArgsSchema = z.object({
+    sectionId: z
+        .string()
+        .describe("Section ID - unique identifier for the section within the product"),
+    embed: z
+        .array(z.string())
+        .optional()
+        .describe("List of related entities to embed in the response - e.g., ['swaggerhubApi'] to include SwaggerHub API details"),
+    page: z
+        .number()
+        .optional()
+        .describe("Page number for paginated results - specifies which page of results to retrieve (default is 1)"),
+    size: z
+        .number()
+        .optional()
+        .describe("Number of items per page for pagination - controls how many results are returned per page (default is 20)"),
+});
+export const CreateTableOfContentsArgsSchema = z.object({
+    sectionId: z
+        .string()
+        .describe("Section ID - unique identifier for the section within the product"),
+    type: z
+        .enum(["new", "copy"])
+        .describe("Type of table of contents creation - 'new' to create from scratch or 'copy' to duplicate an existing one"),
+    title: z
+        .string()
+        .describe("Title of the table of contents item - will be displayed in navigation (3-40 characters)"),
+    slug: z
+        .string()
+        .describe("URL-friendly identifier for the table of contents item - must be unique within the section (3-22 characters, lowercase, alphanumeric with hyphens/underscores/dots)"),
+    order: z
+        .number()
+        .describe("Order position of the table of contents item within its parent section or item"),
+    parentId: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("Parent table of contents item ID - null for top-level items, or ID of parent item for nested structure"),
+    content: z
+        .object({
+        type: z
+            .enum(["apiUrl", "html", "markdown"])
+            .describe("Content type - 'apiUrl' for API references, 'html' for HTML content, or 'markdown' for Markdown content"),
+        url: z
+            .string()
+            .optional()
+            .describe("URL for API reference content (required when type is 'apiUrl')"),
+        apiSpec: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("API specification format for API URL content"),
+        documentId: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Document ID for HTML or Markdown content"),
+    })
+        .optional()
+        .describe("Content configuration for the table of contents item")
+        .refine((content) => {
+        if (content?.type === "apiUrl") {
+            return content.url?.endsWith("/swagger.json");
+        }
+        return true;
+    }, {
+        message: "URL must end with '/swagger.json' when content type is 'apiUrl'",
+        path: ["url"],
+    }),
+});
 export const CreatePortalArgsSchema = z.object({
     name: z
         .string()
@@ -129,3 +216,42 @@ export const UpdateProductArgsSchema = ProductArgsSchema.extend({
         .optional()
         .describe("Change navigation visibility - true hides from portal landing page menus while keeping the product accessible via direct links"),
 });
+export const PublishProductArgsSchema = ProductArgsSchema.extend({
+    preview: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Whether to publish as preview (true) or live (false). Preview allows testing before going live. Defaults to false (live publication)"),
+});
+// Document management schemas
+export const GetDocumentArgsSchema = z.object({
+    documentId: z
+        .string()
+        .describe("Document UUID - unique identifier for the document"),
+});
+export const UpdateDocumentArgsSchema = z.object({
+    documentId: z
+        .string()
+        .describe("Document UUID - unique identifier for the document"),
+    content: z
+        .string()
+        .describe("The document content to update (HTML or Markdown based on document type)"),
+    type: z
+        .enum(["html", "markdown"])
+        .optional()
+        .describe("Content type - 'html' for HTML content or 'markdown' for Markdown content"),
+});
+export const DeleteDocumentArgsSchema = z.object({
+    documentId: z
+        .string()
+        .describe("Document UUID - unique identifier for the document to delete"),
+});
+export const DeleteTableOfContentsArgsSchema = z.object({
+    tableOfContentsId: z
+        .string()
+        .describe("The table of contents UUID, or identifier in the format 'portal-subdomain:product-slug:section-slug:table-of-contents-slug'"),
+    recursive: z
+        .boolean()
+        .optional()
+        .describe("Flag to include all the nested tables of contents (default: false)"),
+});

package/dist/api-hub/client/tools.js

@@ -5,8 +5,9 @@
  * Each tool includes parameters, descriptions, and handler method names.
  * This follows the pattern established in the pactflow module.
  */
-import { CreatePortalArgsSchema, CreateProductArgsSchema, PortalArgsSchema, ProductArgsSchema, UpdatePortalArgsSchema, UpdateProductArgsSchema, } from "./portal-types.js";
+import { CreatePortalArgsSchema, CreateProductArgsSchema, CreateTableOfContentsArgsSchema, DeleteDocumentArgsSchema, DeleteTableOfContentsArgsSchema, GetDocumentArgsSchema, GetProductSectionsArgsSchema, GetTableOfContentsArgsSchema, PortalArgsSchema, ProductArgsSchema, PublishProductArgsSchema, UpdateDocumentArgsSchema, UpdatePortalArgsSchema, UpdateProductArgsSchema, } from "./portal-types.js";
 import { ApiDefinitionParamsSchema, ApiSearchParamsSchema, CreateApiFromTemplateParamsSchema, CreateApiParamsSchema, ScanStandardizationParamsSchema, } from "./registry-types.js";
+import { OrganizationsQuerySchema } from "./user-management-types.js";
 export const TOOLS = [
     {
         title: "List Portals",
@@ -17,88 +18,144 @@ export const TOOLS = [
     {
         title: "Create Portal",
         summary: "Create a new portal within API Hub.",
-        zodSchema: CreatePortalArgsSchema,
+        inputSchema: CreatePortalArgsSchema,
         handler: "createPortal",
     },
     {
         title: "Get Portal",
         summary: "Retrieve information about a specific portal.",
-        zodSchema: PortalArgsSchema,
+        inputSchema: PortalArgsSchema,
         handler: "getPortal",
     },
     {
         title: "Delete Portal",
         summary: "Delete a specific portal.",
-        zodSchema: PortalArgsSchema,
+        inputSchema: PortalArgsSchema,
         handler: "deletePortal",
         formatResponse: () => "Portal deleted successfully.",
     },
     {
         title: "Update Portal",
         summary: "Update a specific portal's configuration.",
-        zodSchema: UpdatePortalArgsSchema,
+        inputSchema: UpdatePortalArgsSchema,
         handler: "updatePortal",
     },
     {
         title: "List Portal Products",
         summary: "Get products for a specific portal that match your criteria.",
-        zodSchema: PortalArgsSchema,
+        inputSchema: PortalArgsSchema,
         handler: "getPortalProducts",
     },
     {
         title: "Create Portal Product",
         summary: "Create a new product for a specific portal.",
-        zodSchema: CreateProductArgsSchema,
+        inputSchema: CreateProductArgsSchema,
         handler: "createPortalProduct",
     },
     {
         title: "Get Portal Product",
         summary: "Retrieve information about a specific product resource.",
-        zodSchema: ProductArgsSchema,
+        inputSchema: ProductArgsSchema,
         handler: "getPortalProduct",
     },
     {
         title: "Delete Portal Product",
         summary: "Delete a product from a specific portal",
-        zodSchema: ProductArgsSchema,
+        inputSchema: ProductArgsSchema,
         handler: "deletePortalProduct",
         formatResponse: () => "Product deleted successfully.",
     },
     {
         title: "Update Portal Product",
         summary: "Update a product's settings within a specific portal.",
-        zodSchema: UpdateProductArgsSchema,
+        inputSchema: UpdateProductArgsSchema,
         handler: "updatePortalProduct",
     },
+    {
+        title: "Publish Portal Product",
+        summary: "Publish a product's content to make it live or as preview. This endpoint publishes the current content of a product, making it visible to portal visitors. Use preview mode to test before going live.",
+        inputSchema: PublishProductArgsSchema,
+        handler: "publishPortalProduct",
+    },
+    {
+        title: "List Portal Product Sections",
+        summary: "Get sections for a specific product within a portal.",
+        inputSchema: GetProductSectionsArgsSchema,
+        handler: "getPortalProductSections",
+    },
+    {
+        title: "Create Table Of Contents",
+        summary: "Create a new table of contents item in a portal product section. Supports API references, HTML content, and Markdown content types.",
+        inputSchema: CreateTableOfContentsArgsSchema,
+        handler: "createTableOfContents",
+    },
+    {
+        title: "List Table Of Contents",
+        summary: "Get table of contents for a section of a product within a portal.",
+        inputSchema: GetTableOfContentsArgsSchema,
+        handler: "getTableOfContents",
+    },
+    {
+        title: "Delete Table Of Contents",
+        summary: "Delete table of contents entry. Performs a soft-delete of an entry from the table of contents. Supports recursive deletion of nested items.",
+        inputSchema: DeleteTableOfContentsArgsSchema,
+        handler: "deleteTableOfContents",
+    },
+    // Document management tools
+    {
+        title: "Get Document",
+        summary: "Get document content and metadata by document ID. Useful for retrieving HTML or Markdown content from table of contents items.",
+        inputSchema: GetDocumentArgsSchema,
+        handler: "getDocument",
+    },
+    {
+        title: "Update Document",
+        summary: "Update the content of an existing document. Supports both HTML and Markdown content types.",
+        inputSchema: UpdateDocumentArgsSchema,
+        handler: "updateDocument",
+    },
+    {
+        title: "Delete Document",
+        summary: "Delete a document by its ID. This will permanently remove the document content.",
+        inputSchema: DeleteDocumentArgsSchema,
+        handler: "deleteDocument",
+    },
     // Registry API tools for SwaggerHub Design functionality
     {
         title: "Search APIs and Domains",
         summary: "Search for APIs and Domains in SwaggerHub Registry using the comprehensive /specs endpoint and retrieve metadata including owner, name, description, summary, version, and specification.",
-        zodSchema: ApiSearchParamsSchema,
+        inputSchema: ApiSearchParamsSchema,
         handler: "searchApis",
     },
     {
         title: "Get API Definition",
         summary: "Fetch resolved API definition from SwaggerHub Registry based on owner, API name, and version.",
-        zodSchema: ApiDefinitionParamsSchema,
+        inputSchema: ApiDefinitionParamsSchema,
         handler: "getApiDefinition",
     },
     {
         title: "Create or Update API",
         summary: "Create a new API or update an existing API in SwaggerHub Registry for API Hub for Design. The API specification type (OpenAPI, AsyncAPI) is automatically detected from the definition content. APIs are always created with fixed values: version 1.0.0, private visibility, and automock disabled (these values cannot be changed). Returns HTTP 201 for creation, HTTP 200 for update. Response includes 'operation' field indicating whether it was a 'create' or 'update' operation along with API details and SwaggerHub URL.",
-        zodSchema: CreateApiParamsSchema,
+        inputSchema: CreateApiParamsSchema,
         handler: "createOrUpdateApi",
     },
     {
         title: "Create API from Template",
         summary: "Create a new API in SwaggerHub Registry using a predefined template. This endpoint creates APIs based on existing templates without requiring manual definition content. APIs are always created with fixed values: private visibility, no project assignment, and reconciliation enabled (these values cannot be changed). Returns HTTP 201 for creation, HTTP 200 for update. Response includes 'operation' field and API details with SwaggerHub URL.",
-        zodSchema: CreateApiFromTemplateParamsSchema,
+        inputSchema: CreateApiFromTemplateParamsSchema,
         handler: "createApiFromTemplate",
     },
+    // User Management API tools for organization management functionality
+    {
+        title: "List Organizations",
+        summary: "Get organizations for a user. Returns a list of organizations that the authenticating user is a member of. On-Premise admin gets a list of all organizations in the system.",
+        inputSchema: OrganizationsQuerySchema,
+        handler: "getOrganizations",
+    },
     {
         title: "Scan API Standardization",
         summary: "Run a standardization scan against an API definition using the organization's standardization configuration. Accepts a YAML or JSON OpenAPI/AsyncAPI definition and returns a list of standardization errors and validation issues.",
-        zodSchema: ScanStandardizationParamsSchema,
+        inputSchema: ScanStandardizationParamsSchema,
         handler: "scanStandardization",
     },
 ];

package/dist/api-hub/client/user-management-types.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+// Query parameters for getting organizations
+export const OrganizationsQuerySchema = z.object({
+    q: z
+        .string()
+        .optional()
+        .describe("Search organizations by partial or full name (case-insensitive)"),
+    sortBy: z
+        .enum(["NAME", "EMAIL"])
+        .optional()
+        .describe("The property to sort the results by"),
+    order: z.enum(["ASC", "DESC"]).optional().describe("Sort order"),
+    page: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("0-based index of the page to return"),
+    pageSize: z
+        .number()
+        .min(1)
+        .max(1000)
+        .optional()
+        .describe("Number of results per page to return"),
+});