@smartbear/mcp 0.12.1 → 0.13.1

package/dist/swagger/client/registry-types.js

@@ -1,103 +1,69 @@
 import { z } from "zod";
-// Zod schemas for SwaggerHub Registry API validation
-export const ApiSearchParamsSchema = z.object({
-    query: z
-        .string()
-        .optional()
-        .describe("Search query to filter APIs by name, description, or content"),
-    state: z
-        .enum(["ALL", "PUBLISHED", "UNPUBLISHED"])
-        .optional()
-        .describe("Filter APIs by publication state - ALL (default), PUBLISHED, or UNPUBLISHED"),
-    tag: z.string().optional().describe("Filter APIs by tag"),
-    offset: z
-        .number()
-        .min(0)
-        .optional()
-        .describe("Offset for pagination (0-based, default 0)"),
-    limit: z
-        .number()
-        .min(1)
-        .max(100)
-        .optional()
-        .describe("Number of results per page (1-100, default 20)"),
-    sort: z
-        .enum(["NAME", "UPDATED", "CREATED"])
-        .optional()
-        .describe("Sort field - NAME, UPDATED, or CREATED (default NAME)"),
-    order: z
-        .enum(["ASC", "DESC"])
-        .optional()
-        .describe("Sort order - ASC or DESC (default ASC)"),
-    owner: z
-        .string()
-        .optional()
-        .describe("Filter APIs by owner (organization or user)"),
-    specType: z
-        .enum(["API", "DOMAIN"])
-        .optional()
-        .describe("Filter by specification type - API or DOMAIN (default all types)"),
+const ApiSearchParamsSchema = z.object({
+  query: z.string().optional().describe("Search query to filter APIs by name, description, or content"),
+  state: z.enum(["ALL", "PUBLISHED", "UNPUBLISHED"]).optional().describe(
+    "Filter APIs by publication state - ALL (default), PUBLISHED, or UNPUBLISHED"
+  ),
+  tag: z.string().optional().describe("Filter APIs by tag"),
+  offset: z.number().min(0).optional().describe("Offset for pagination (0-based, default 0)"),
+  limit: z.number().min(1).max(100).optional().describe("Number of results per page (1-100, default 20)"),
+  sort: z.enum(["NAME", "UPDATED", "CREATED"]).optional().describe("Sort field - NAME, UPDATED, or CREATED (default NAME)"),
+  order: z.enum(["ASC", "DESC"]).optional().describe("Sort order - ASC or DESC (default ASC)"),
+  owner: z.string().optional().describe("Filter APIs by owner (organization or user)"),
+  specType: z.enum(["API", "DOMAIN"]).optional().describe(
+    "Filter by specification type - API or DOMAIN (default all types)"
+  )
 });
-export const ApiDefinitionParamsSchema = z.object({
-    owner: z
-        .string()
-        .describe("API owner (organization or user, case-sensitive)"),
-    api: z.string().describe("API name (case-sensitive)"),
-    version: z.string().describe("Version identifier"),
-    resolved: z
-        .boolean()
-        .optional()
-        .describe("Set to true to get the resolved version with all external $refs included (default false)"),
-    flatten: z
-        .boolean()
-        .optional()
-        .describe("Set to true to create models from inline schemas in OpenAPI definition (default false)"),
+const ApiDefinitionParamsSchema = z.object({
+  owner: z.string().describe("API owner (organization or user, case-sensitive)"),
+  api: z.string().describe("API name (case-sensitive)"),
+  version: z.string().describe("Version identifier"),
+  resolved: z.boolean().optional().describe(
+    "Set to true to get the resolved version with all external $refs included (default false)"
+  ),
+  flatten: z.boolean().optional().describe(
+    "Set to true to create models from inline schemas in OpenAPI definition (default false)"
+  )
 });
-export const CreateApiParamsSchema = z.object({
-    owner: z.string().describe("Organization name (owner of the API)"),
-    apiName: z.string().describe("API name"),
-    definition: z
-        .string()
-        .describe("API definition content (OpenAPI/AsyncAPI specification in JSON or YAML format). Format is automatically detected. API is created with fixed values: version 1.0.0, private visibility, automock disabled, and no project assignment."),
+const CreateApiParamsSchema = z.object({
+  owner: z.string().describe("Organization name (owner of the API)"),
+  apiName: z.string().describe("API name"),
+  definition: z.string().describe(
+    "API definition content (OpenAPI/AsyncAPI specification in JSON or YAML format). Format is automatically detected. API is created with fixed values: version 1.0.0, private visibility, automock disabled, and no project assignment."
+  )
 });
-export const CreateApiFromTemplateParamsSchema = z.object({
-    owner: z.string().describe("Organization name (owner of the API)"),
-    apiName: z.string().describe("API name"),
-    template: z
-        .string()
-        .describe("Template name to use for creating the API. Format: owner/template-name/version (e.g., 'swagger-hub/petstore-template/1.0.0'). API is created with fixed values: private visibility, no project assignment, and reconciliation enabled."),
+const ScanStandardizationParamsSchema = z.object({
+  orgName: z.string().describe("The organization name to use for standardization rules"),
+  definition: z.string().describe(
+    "API definition content (OpenAPI/AsyncAPI specification in JSON or YAML format) to scan for standardization errors"
+  )
 });
-export const ScanStandardizationParamsSchema = z.object({
-    orgName: z
-        .string()
-        .describe("The organization name to use for standardization rules"),
-    definition: z
-        .string()
-        .describe("API definition content (OpenAPI/AsyncAPI specification in JSON or YAML format) to scan for standardization errors"),
+const CreateApiFromPromptParamsSchema = z.object({
+  owner: z.string().describe("API owner (organization or user, case-sensitive)"),
+  apiName: z.string().describe("API name"),
+  prompt: z.string().describe(
+    "The prompt describing the desired API functionality (e.g., 'Create a RESTful API for managing a pet store with endpoints for pets, orders, and inventory')"
+  ),
+  specType: z.enum([
+    "openapi20",
+    "openapi30x",
+    "openapi31x",
+    "asyncapi2xx",
+    "asyncapi30x"
+  ]).default("openapi30x").describe(
+    "Specification type for the generated API definition. Use: 'openapi20' for OpenAPI 2.0, 'openapi30x' for OpenAPI 3.0.x (default), 'openapi31x' for OpenAPI 3.1.x, 'asyncapi2xx' for AsyncAPI 2.x, 'asyncapi30x' for AsyncAPI 3.0.x"
+  )
 });
-export const CreateApiFromPromptParamsSchema = z.object({
-    owner: z
-        .string()
-        .describe("API owner (organization or user, case-sensitive)"),
-    apiName: z.string().describe("API name"),
-    prompt: z
-        .string()
-        .describe("The prompt describing the desired API functionality (e.g., 'Create a RESTful API for managing a pet store with endpoints for pets, orders, and inventory')"),
-    specType: z
-        .enum([
-        "openapi20",
-        "openapi30x",
-        "openapi31x",
-        "asyncapi2xx",
-        "asyncapi30x",
-    ])
-        .default("openapi30x")
-        .describe("Specification type for the generated API definition. Use: 'openapi20' for OpenAPI 2.0, 'openapi30x' for OpenAPI 3.0.x (default), 'openapi31x' for OpenAPI 3.1.x, 'asyncapi2xx' for AsyncAPI 2.x, 'asyncapi30x' for AsyncAPI 3.0.x"),
-});
-export const StandardizeApiParamsSchema = z.object({
-    owner: z
-        .string()
-        .describe("API owner (organization or user, case-sensitive)"),
-    api: z.string().describe("API name (case-sensitive)"),
-    version: z.string().describe("Version identifier"),
+const StandardizeApiParamsSchema = z.object({
+  owner: z.string().describe("API owner (organization or user, case-sensitive)"),
+  api: z.string().describe("API name (case-sensitive)"),
+  version: z.string().describe("Version identifier")
 });
+export {
+  ApiDefinitionParamsSchema,
+  ApiSearchParamsSchema,
+  CreateApiFromPromptParamsSchema,
+  CreateApiParamsSchema,
+  ScanStandardizationParamsSchema,
+  StandardizeApiParamsSchema
+};

package/dist/swagger/client/tools.js

@@ -1,160 +1,150 @@
-/**
- * TOOLS
- *
- * Defines tool configurations for Swagger operations.
- * Each tool includes parameters, descriptions, and handler method names.
- * This follows the pattern established in the pactflow module.
- */
-import { CreatePortalArgsSchema, CreateProductArgsSchema, CreateTableOfContentsArgsSchema, DeleteTableOfContentsArgsSchema, GetDocumentArgsSchema, GetProductSectionsArgsSchema, GetTableOfContentsArgsSchema, PortalArgsSchema, ProductArgsSchema, PublishProductArgsSchema, UpdateDocumentArgsSchema, UpdatePortalArgsSchema, UpdateProductArgsSchema, } from "./portal-types.js";
-import { ApiDefinitionParamsSchema, ApiSearchParamsSchema, CreateApiFromPromptParamsSchema, CreateApiFromTemplateParamsSchema, CreateApiParamsSchema, ScanStandardizationParamsSchema, StandardizeApiParamsSchema, } from "./registry-types.js";
+import { CreatePortalArgsSchema, PortalArgsSchema, UpdatePortalArgsSchema, CreateProductArgsSchema, ProductArgsSchema, UpdateProductArgsSchema, PublishProductArgsSchema, GetProductSectionsArgsSchema, CreateTableOfContentsArgsSchema, GetTableOfContentsArgsSchema, DeleteTableOfContentsArgsSchema, GetDocumentArgsSchema, UpdateDocumentArgsSchema } from "./portal-types.js";
+import { ApiSearchParamsSchema, ApiDefinitionParamsSchema, CreateApiParamsSchema, ScanStandardizationParamsSchema, CreateApiFromPromptParamsSchema, StandardizeApiParamsSchema } from "./registry-types.js";
 import { OrganizationsQuerySchema } from "./user-management-types.js";
-export const TOOLS = [
-    {
-        title: "List Portals",
-        summary: "Search for available portals within Swagger. Only portals where you have at least a designer role, either at the product level or organization level, are returned.",
-        parameters: [],
-        handler: "getPortals",
-    },
-    {
-        title: "Create Portal",
-        summary: "Create a new portal within Swagger.",
-        inputSchema: CreatePortalArgsSchema,
-        handler: "createPortal",
-    },
-    {
-        title: "Get Portal",
-        summary: "Retrieve information about a specific portal.",
-        inputSchema: PortalArgsSchema,
-        handler: "getPortal",
-    },
-    {
-        title: "Update Portal",
-        summary: "Update a specific portal's configuration.",
-        inputSchema: UpdatePortalArgsSchema,
-        handler: "updatePortal",
-    },
-    {
-        title: "List Portal Products",
-        summary: "Get products for a specific portal that match your criteria.",
-        inputSchema: PortalArgsSchema,
-        handler: "getPortalProducts",
-    },
-    {
-        title: "Create Portal Product",
-        summary: "Create a new product for a specific portal.",
-        inputSchema: CreateProductArgsSchema,
-        handler: "createPortalProduct",
-    },
-    {
-        title: "Get Portal Product",
-        summary: "Retrieve information about a specific product resource.",
-        inputSchema: ProductArgsSchema,
-        handler: "getPortalProduct",
-    },
-    {
-        title: "Delete Portal Product",
-        summary: "Delete a product from a specific portal",
-        inputSchema: ProductArgsSchema,
-        handler: "deletePortalProduct",
-        formatResponse: () => "Product deleted successfully.",
-    },
-    {
-        title: "Update Portal Product",
-        summary: "Update a product's settings within a specific portal.",
-        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",
-    },
-    // 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.",
-        inputSchema: ApiSearchParamsSchema,
-        handler: "searchApis",
-    },
-    {
-        title: "Get API Definition",
-        summary: "Fetch resolved API definition from SwaggerHub Registry based on owner, API name, and version.",
-        inputSchema: ApiDefinitionParamsSchema,
-        handler: "getApiDefinition",
-    },
-    {
-        title: "Create or Update API",
-        summary: "Create a new API or update an existing API in SwaggerHub Registry for Swagger Studio. 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.",
-        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.",
-        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 governance and standardization rules. Accepts a YAML or JSON OpenAPI/AsyncAPI definition and returns a list of standardization errors and validation issues. Use this tool when users ask to validate, scan, or check API governance or standardization.",
-        inputSchema: ScanStandardizationParamsSchema,
-        handler: "scanStandardization",
-    },
-    {
-        title: "Create API from Prompt using SmartBear AI",
-        summary: "Generate and save an API definition based on a prompt using SmartBear AI. This tool automatically applies organization governance and standardization rules during API generation. The specType parameter determines the format of the generated definition. Use: 'openapi20' for OpenAPI 2.0, 'openapi30x' for OpenAPI 3.0.x, 'openapi31x' for OpenAPI 3.1.x, 'asyncapi2xx' for AsyncAPI 2.x, 'asyncapi30x' for AsyncAPI 3.0.x. Use this tool when creating APIs that comply with governance policies or when generating APIs from natural language descriptions. Use this tool when users ask to create, generate, or design APIs with governance or standardization requirements. 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.",
-        inputSchema: CreateApiFromPromptParamsSchema,
-        handler: "createApiFromPrompt",
-    },
-    {
-        title: "Standardize API",
-        summary: "Standardize and fix an API definition using AI to ensure compliance with governance policies. Scans the API definition for standardization errors and automatically fixes them using SmartBear AI. If errors are found, they will be sent to SmartBear AI to generate a corrected definition, which is then saved back to the registry. Returns the number of errors found and the fixed definition if successful. Use this tool when users ask to standardize, fix, govern, or ensure governance compliance of APIs.",
-        inputSchema: StandardizeApiParamsSchema,
-        handler: "standardizeApi",
-    },
+const TOOLS = [
+  {
+    title: "List Portals",
+    summary: "Search for available portals within Swagger. Only portals where you have at least a designer role, either at the product level or organization level, are returned.",
+    parameters: [],
+    handler: "getPortals"
+  },
+  {
+    title: "Create Portal",
+    summary: "Create a new portal within Swagger.",
+    inputSchema: CreatePortalArgsSchema,
+    handler: "createPortal"
+  },
+  {
+    title: "Get Portal",
+    summary: "Retrieve information about a specific portal.",
+    inputSchema: PortalArgsSchema,
+    handler: "getPortal"
+  },
+  {
+    title: "Update Portal",
+    summary: "Update a specific portal's configuration.",
+    inputSchema: UpdatePortalArgsSchema,
+    handler: "updatePortal"
+  },
+  {
+    title: "List Portal Products",
+    summary: "Get products for a specific portal that match your criteria.",
+    inputSchema: PortalArgsSchema,
+    handler: "getPortalProducts"
+  },
+  {
+    title: "Create Portal Product",
+    summary: "Create a new product for a specific portal.",
+    inputSchema: CreateProductArgsSchema,
+    handler: "createPortalProduct"
+  },
+  {
+    title: "Get Portal Product",
+    summary: "Retrieve information about a specific product resource.",
+    inputSchema: ProductArgsSchema,
+    handler: "getPortalProduct"
+  },
+  {
+    title: "Delete Portal Product",
+    summary: "Delete a product from a specific portal",
+    inputSchema: ProductArgsSchema,
+    handler: "deletePortalProduct",
+    formatResponse: () => "Product deleted successfully."
+  },
+  {
+    title: "Update Portal Product",
+    summary: "Update a product's settings within a specific portal.",
+    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"
+  },
+  // 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.",
+    inputSchema: ApiSearchParamsSchema,
+    handler: "searchApis"
+  },
+  {
+    title: "Get API Definition",
+    summary: "Fetch resolved API definition from SwaggerHub Registry based on owner, API name, and version.",
+    inputSchema: ApiDefinitionParamsSchema,
+    handler: "getApiDefinition"
+  },
+  {
+    title: "Create or Update API",
+    summary: "Create a new API or update an existing API in SwaggerHub Registry for Swagger Studio. 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.",
+    inputSchema: CreateApiParamsSchema,
+    handler: "createOrUpdateApi"
+  },
+  // 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 governance and standardization rules. Accepts a YAML or JSON OpenAPI/AsyncAPI definition and returns a list of standardization errors and validation issues. Use this tool when users ask to validate, scan, or check API governance or standardization.",
+    inputSchema: ScanStandardizationParamsSchema,
+    handler: "scanStandardization"
+  },
+  {
+    title: "Create API from Prompt using SmartBear AI",
+    summary: "Generate and save an API definition based on a prompt using SmartBear AI. This tool automatically applies organization governance and standardization rules during API generation. The specType parameter determines the format of the generated definition. Use: 'openapi20' for OpenAPI 2.0, 'openapi30x' for OpenAPI 3.0.x, 'openapi31x' for OpenAPI 3.1.x, 'asyncapi2xx' for AsyncAPI 2.x, 'asyncapi30x' for AsyncAPI 3.0.x. Use this tool when creating APIs that comply with governance policies or when generating APIs from natural language descriptions. Use this tool when users ask to create, generate, or design APIs with governance or standardization requirements. 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.",
+    inputSchema: CreateApiFromPromptParamsSchema,
+    handler: "createApiFromPrompt"
+  },
+  {
+    title: "Standardize API",
+    summary: "Standardize and fix an API definition using AI to ensure compliance with governance policies. Scans the API definition for standardization errors and automatically fixes them using SmartBear AI. If errors are found, they will be sent to SmartBear AI to generate a corrected definition, which is then saved back to the registry. Returns the number of errors found and the fixed definition if successful. Use this tool when users ask to standardize, fix, govern, or ensure governance compliance of APIs.",
+    inputSchema: StandardizeApiParamsSchema,
+    handler: "standardizeApi"
+  }
 ];
+export {
+  TOOLS
+};

package/dist/swagger/client/user-management-types.js

@@ -1,24 +1,13 @@
 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"),
+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(1e3).optional().describe("Number of results per page to return")
 });
+export {
+  OrganizationsQuerySchema
+};