@ibm/ibmi-mcp-server 0.3.1 → 0.4.0

package/dist/ibmi-mcp-server/tools/index.d.ts

@@ -2,6 +2,8 @@
  * Tool Definitions Barrel Export
  *
  * Centralized export of all factory pattern tool definitions.
+ * Includes the default text-to-SQL toolset (controlled by IBMI_ENABLE_DEFAULT_TOOLS)
+ * alongside always-available tools.
  *
  * @module tools/definitions
  */
@@ -81,5 +83,178 @@ export declare const allToolDefinitions: (import("../../mcp-server/tools/utils/t
         message: string;
         details?: Record<string, unknown> | undefined;
     }>>;
+}> | import("../../mcp-server/tools/utils/types.js").ToolDefinition<{
+    filter: import("zod").ZodOptional<import("zod").ZodString>;
+    include_system: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, {
+    success: import("zod").ZodBoolean;
+    data: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>, "many">>;
+    rowCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    hasMore: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    executionTime: import("zod").ZodOptional<import("zod").ZodNumber>;
+    error: import("zod").ZodOptional<import("zod").ZodObject<{
+        code: import("zod").ZodString;
+        message: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}> | import("../../mcp-server/tools/utils/types.js").ToolDefinition<{
+    schema_name: import("zod").ZodString;
+    table_filter: import("zod").ZodDefault<import("zod").ZodString>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    offset: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, {
+    success: import("zod").ZodBoolean;
+    data: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>, "many">>;
+    rowCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    hasMore: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    executionTime: import("zod").ZodOptional<import("zod").ZodNumber>;
+    error: import("zod").ZodOptional<import("zod").ZodObject<{
+        code: import("zod").ZodString;
+        message: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}> | import("../../mcp-server/tools/utils/types.js").ToolDefinition<{
+    schema_name: import("zod").ZodString;
+    table_name: import("zod").ZodString;
+}, {
+    success: import("zod").ZodBoolean;
+    data: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>, "many">>;
+    rowCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    executionTime: import("zod").ZodOptional<import("zod").ZodNumber>;
+    error: import("zod").ZodOptional<import("zod").ZodObject<{
+        code: import("zod").ZodString;
+        message: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}> | import("../../mcp-server/tools/utils/types.js").ToolDefinition<{
+    sql_statement: import("zod").ZodString;
+}, {
+    success: import("zod").ZodBoolean;
+    data: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>, "many">>;
+    rowCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    executionTime: import("zod").ZodOptional<import("zod").ZodNumber>;
+    objectValidation: import("zod").ZodOptional<import("zod").ZodObject<{
+        tables: import("zod").ZodObject<{
+            valid: import("zod").ZodArray<import("zod").ZodString, "many">;
+            invalid: import("zod").ZodArray<import("zod").ZodString, "many">;
+        }, "strip", import("zod").ZodTypeAny, {
+            valid: string[];
+            invalid: string[];
+        }, {
+            valid: string[];
+            invalid: string[];
+        }>;
+        columns: import("zod").ZodObject<{
+            valid: import("zod").ZodArray<import("zod").ZodString, "many">;
+            invalid: import("zod").ZodArray<import("zod").ZodString, "many">;
+        }, "strip", import("zod").ZodTypeAny, {
+            valid: string[];
+            invalid: string[];
+        }, {
+            valid: string[];
+            invalid: string[];
+        }>;
+        routines: import("zod").ZodObject<{
+            valid: import("zod").ZodArray<import("zod").ZodString, "many">;
+            invalid: import("zod").ZodArray<import("zod").ZodString, "many">;
+        }, "strip", import("zod").ZodTypeAny, {
+            valid: string[];
+            invalid: string[];
+        }, {
+            valid: string[];
+            invalid: string[];
+        }>;
+    }, "strip", import("zod").ZodTypeAny, {
+        columns: {
+            valid: string[];
+            invalid: string[];
+        };
+        tables: {
+            valid: string[];
+            invalid: string[];
+        };
+        routines: {
+            valid: string[];
+            invalid: string[];
+        };
+    }, {
+        columns: {
+            valid: string[];
+            invalid: string[];
+        };
+        tables: {
+            valid: string[];
+            invalid: string[];
+        };
+        routines: {
+            valid: string[];
+            invalid: string[];
+        };
+    }>>;
+    error: import("zod").ZodOptional<import("zod").ZodObject<{
+        code: import("zod").ZodString;
+        message: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}> | import("../../mcp-server/tools/utils/types.js").ToolDefinition<{
+    library_name: import("zod").ZodString;
+    file_name: import("zod").ZodString;
+    object_type_filter: import("zod").ZodOptional<import("zod").ZodEnum<["ALIAS", "FOREIGN KEY", "FUNCTION", "HISTORY TABLE", "INDEX", "KEYED LOGICAL FILE", "LOGICAL FILE", "MASK", "MATERIALIZED QUERY TABLE", "PERMISSION", "PROCEDURE", "TEXT INDEX", "TRIGGER", "VARIABLE", "VIEW", "XML SCHEMA"]>>;
+}, {
+    success: import("zod").ZodBoolean;
+    data: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>, "many">>;
+    rowCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    executionTime: import("zod").ZodOptional<import("zod").ZodNumber>;
+    error: import("zod").ZodOptional<import("zod").ZodObject<{
+        code: import("zod").ZodString;
+        message: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
 }>)[];
 //# sourceMappingURL=index.d.ts.map

package/dist/ibmi-mcp-server/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ibmi-mcp-server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ibmi-mcp-server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAI9B,CAAC"}

package/dist/ibmi-mcp-server/tools/index.js

@@ -2,11 +2,33 @@
  * Tool Definitions Barrel Export
  *
  * Centralized export of all factory pattern tool definitions.
+ * Includes the default text-to-SQL toolset (controlled by IBMI_ENABLE_DEFAULT_TOOLS)
+ * alongside always-available tools.
  *
  * @module tools/definitions
  */
+import { config } from "../../config/index.js";
 import { executeSqlTool } from "./executeSql.tool.js";
 import { generateSqlTool } from "./generateSql.tool.js";
+import { listSchemasTool } from "./listSchemas.tool.js";
+import { listTablesInSchemaTool } from "./listTablesInSchema.tool.js";
+import { getTableColumnsTool } from "./getTableColumns.tool.js";
+import { validateQueryTool } from "./validateQuery.tool.js";
+import { getRelatedObjectsTool } from "./getRelatedObjects.tool.js";
+/**
+ * Default text-to-SQL toolset, enabled via IBMI_ENABLE_DEFAULT_TOOLS (default: true).
+ * These tools provide schema discovery and query validation for LLM workflows:
+ *   list_schemas → list_tables_in_schema → get_table_columns → get_related_objects → validate_query → execute_sql
+ */
+const defaultTools = config.ibmi_enableDefaultTools
+    ? [
+        listSchemasTool,
+        listTablesInSchemaTool,
+        getTableColumnsTool,
+        getRelatedObjectsTool,
+        validateQueryTool,
+    ]
+    : [];
 /**
  * Array of all tool definitions for automated registration.
  *
@@ -17,5 +39,9 @@ import { generateSqlTool } from "./generateSql.tool.js";
  *
  * The ToolRegistry will automatically register all tools in this array.
  */
-export const allToolDefinitions = [executeSqlTool, generateSqlTool];
+export const allToolDefinitions = [
+    executeSqlTool, // Controlled by IBMI_ENABLE_EXECUTE_SQL or IBMI_ENABLE_DEFAULT_TOOLS
+    generateSqlTool, // Always available (describe_sql_object)
+    ...defaultTools, // Conditionally included default toolset
+];
 //# sourceMappingURL=index.js.map

package/dist/ibmi-mcp-server/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ibmi-mcp-server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ibmi-mcp-server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE;;;;GAIG;AACH,MAAM,YAAY,GAAG,MAAM,CAAC,uBAAuB;IACjD,CAAC,CAAC;QACE,eAAe;QACf,sBAAsB;QACtB,mBAAmB;QACnB,qBAAqB;QACrB,iBAAiB;KAClB;IACH,CAAC,CAAC,EAAE,CAAC;AAEP;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,cAAc,EAAE,qEAAqE;IACrF,eAAe,EAAE,yCAAyC;IAC1D,GAAG,YAAY,EAAE,yCAAyC;CAC3D,CAAC"}

package/dist/ibmi-mcp-server/tools/listSchemas.tool.d.ts

@@ -0,0 +1,107 @@
+/**
+ * List Schemas Tool
+ *
+ * Lists available schemas/libraries on the IBM i system.
+ * Part of the default text-to-SQL toolset.
+ *
+ * @module listSchemas.tool
+ */
+import { z } from "zod";
+import type { RequestContext } from "../../utils/index.js";
+import type { SdkContext } from "../../mcp-server/tools/utils/types.js";
+declare const ListSchemasInputSchema: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodString>;
+    include_system: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    include_system: boolean;
+    offset: number;
+    filter?: string | undefined;
+}, {
+    filter?: string | undefined;
+    limit?: number | undefined;
+    include_system?: boolean | undefined;
+    offset?: number | undefined;
+}>;
+declare const ListSchemasOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    rowCount: z.ZodOptional<z.ZodNumber>;
+    hasMore: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    executionTime: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+    limit?: number | undefined;
+    data?: Record<string, unknown>[] | undefined;
+    executionTime?: number | undefined;
+    rowCount?: number | undefined;
+    offset?: number | undefined;
+    hasMore?: boolean | undefined;
+}, {
+    success: boolean;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+    limit?: number | undefined;
+    data?: Record<string, unknown>[] | undefined;
+    executionTime?: number | undefined;
+    rowCount?: number | undefined;
+    offset?: number | undefined;
+    hasMore?: boolean | undefined;
+}>;
+type ListSchemasInput = z.infer<typeof ListSchemasInputSchema>;
+type ListSchemasOutput = z.infer<typeof ListSchemasOutputSchema>;
+export declare function listSchemasLogic(params: ListSchemasInput, appContext: RequestContext, _sdkContext: SdkContext): Promise<ListSchemasOutput>;
+export declare const listSchemasTool: import("../../mcp-server/tools/utils/types.js").ToolDefinition<{
+    filter: z.ZodOptional<z.ZodString>;
+    include_system: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, {
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    rowCount: z.ZodOptional<z.ZodNumber>;
+    hasMore: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    executionTime: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}>;
+export {};
+//# sourceMappingURL=listSchemas.tool.d.ts.map

package/dist/ibmi-mcp-server/tools/listSchemas.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listSchemas.tool.d.ts","sourceRoot":"","sources":["../../../src/ibmi-mcp-server/tools/listSchemas.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAMxE,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;EAyB1B,CAAC;AAEH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2B3B,CAAC;AAEH,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC/D,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMjE,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,cAAc,EAC1B,WAAW,EAAE,UAAU,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAgH5B;AAmCD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;EAc1B,CAAC"}

package/dist/ibmi-mcp-server/tools/listSchemas.tool.js

@@ -0,0 +1,195 @@
+/**
+ * List Schemas Tool
+ *
+ * Lists available schemas/libraries on the IBM i system.
+ * Part of the default text-to-SQL toolset.
+ *
+ * @module listSchemas.tool
+ */
+import { z } from "zod";
+import { JsonRpcErrorCode, McpError } from "../../types-global/errors.js";
+import { logger } from "../../utils/internal/logger.js";
+import { IBMiConnectionPool } from "../services/connectionPool.js";
+import { defineTool } from "../../mcp-server/tools/utils/tool-factory.js";
+// =============================================================================
+// Schemas
+// =============================================================================
+const ListSchemasInputSchema = z.object({
+    filter: z
+        .string()
+        .max(128, "Filter pattern cannot exceed 128 characters.")
+        .optional()
+        .describe("Optional schema name pattern to filter results (e.g., 'MY%', 'LIB%'). Uses SQL LIKE syntax."),
+    include_system: z
+        .boolean()
+        .default(false)
+        .describe("Include system schemas (Q* and SYS* prefixed). Default: false."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(50)
+        .describe("Maximum number of rows to return per page (1-500, default 50)."),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe("Number of rows to skip for pagination (default 0)."),
+});
+const ListSchemasOutputSchema = z.object({
+    success: z.boolean().describe("Whether the query executed successfully."),
+    data: z
+        .array(z.record(z.unknown()))
+        .optional()
+        .describe("Array of schema records. Each record contains: SCHEMA_NAME, SCHEMA_TEXT, SYSTEM_SCHEMA_NAME, SCHEMA_SIZE."),
+    rowCount: z.number().optional().describe("Number of schemas returned."),
+    hasMore: z
+        .boolean()
+        .optional()
+        .describe("Whether more results exist beyond this page."),
+    limit: z.number().optional().describe("Page size used for this request."),
+    offset: z.number().optional().describe("Offset used for this request."),
+    executionTime: z
+        .number()
+        .optional()
+        .describe("Query execution time in milliseconds."),
+    error: z
+        .object({
+        code: z.string().describe("Error code"),
+        message: z.string().describe("Error message"),
+        details: z.record(z.unknown()).optional().describe("Error details"),
+    })
+        .optional()
+        .describe("Error information if the query failed."),
+});
+// =============================================================================
+// Business Logic
+// =============================================================================
+export async function listSchemasLogic(params, appContext, _sdkContext) {
+    logger.debug({ ...appContext, toolInput: params }, "Processing list schemas logic.");
+    const startTime = Date.now();
+    // Build WHERE conditions dynamically
+    const conditions = [];
+    const bindParams = [];
+    if (!params.include_system) {
+        conditions.push("SCHEMA_NAME NOT LIKE 'Q%' AND SCHEMA_NAME NOT LIKE 'SYS%'");
+    }
+    if (params.filter) {
+        conditions.push("SCHEMA_NAME LIKE UPPER(?)");
+        bindParams.push(params.filter);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const sql = `
+    SELECT SCHEMA_NAME,
+           SCHEMA_TEXT,
+           SYSTEM_SCHEMA_NAME,
+           SCHEMA_SIZE
+    FROM QSYS2.SYSSCHEMAS
+    ${whereClause}
+    ORDER BY SCHEMA_NAME
+    OFFSET ? ROWS FETCH FIRST ? ROWS ONLY
+  `.trim();
+    // Fetch limit+1 to detect if more rows exist beyond this page
+    const fetchLimit = params.limit + 1;
+    bindParams.push(params.offset, fetchLimit);
+    try {
+        const result = await IBMiConnectionPool.executeQuery(sql, bindParams, appContext);
+        const executionTime = Date.now() - startTime;
+        if (!result.data) {
+            return {
+                success: true,
+                data: [],
+                rowCount: 0,
+                hasMore: false,
+                limit: params.limit,
+                offset: params.offset,
+                executionTime,
+            };
+        }
+        const typedData = result.data;
+        // Detect if more rows exist beyond this page
+        const hasMore = (typedData?.length ?? 0) > params.limit;
+        if (hasMore && typedData) {
+            typedData.pop(); // Remove the extra detection row
+        }
+        return {
+            success: true,
+            data: typedData,
+            rowCount: typedData?.length ?? 0,
+            hasMore,
+            limit: params.limit,
+            offset: params.offset,
+            executionTime,
+        };
+    }
+    catch (error) {
+        const executionTime = Date.now() - startTime;
+        logger.error({
+            ...appContext,
+            error: error instanceof Error ? error.message : String(error),
+            executionTime,
+        }, "List schemas query failed.");
+        if (error instanceof McpError) {
+            return {
+                success: false,
+                executionTime,
+                error: {
+                    code: String(error.code),
+                    message: error.message,
+                    details: error.details,
+                },
+            };
+        }
+        return {
+            success: false,
+            executionTime,
+            error: {
+                code: String(JsonRpcErrorCode.DatabaseError),
+                message: `Failed to list schemas: ${error instanceof Error ? error.message : String(error)}`,
+            },
+        };
+    }
+}
+// =============================================================================
+// Response Formatter
+// =============================================================================
+const listSchemasResponseFormatter = (result) => {
+    if (!result.success) {
+        const errorMessage = result.error?.message || "Failed to list schemas";
+        const errorDetails = result.error?.details
+            ? `\n\nDetails:\n${JSON.stringify(result.error.details, null, 2)}`
+            : "";
+        return [{ type: "text", text: `Error: ${errorMessage}${errorDetails}` }];
+    }
+    let paginationInfo = "";
+    if (result.hasMore !== undefined) {
+        paginationInfo = ` (offset ${result.offset}, limit ${result.limit}, hasMore: ${result.hasMore})`;
+    }
+    const resultJson = JSON.stringify(result.data, null, 2);
+    return [
+        {
+            type: "text",
+            text: `Found ${result.rowCount} schemas${paginationInfo}.\nExecution time: ${result.executionTime}ms\n\nSchemas:\n${resultJson}`,
+        },
+    ];
+};
+// =============================================================================
+// Tool Definition
+// =============================================================================
+export const listSchemasTool = defineTool({
+    name: "list_schemas",
+    title: "List Schemas",
+    description: "List available schemas/libraries on the IBM i system. Use this as the first step in schema discovery to find which schemas contain relevant tables.",
+    inputSchema: ListSchemasInputSchema,
+    outputSchema: ListSchemasOutputSchema,
+    logic: listSchemasLogic,
+    responseFormatter: listSchemasResponseFormatter,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false,
+    },
+});
+//# sourceMappingURL=listSchemas.tool.js.map

package/dist/ibmi-mcp-server/tools/listSchemas.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listSchemas.tool.js","sourceRoot":"","sources":["../../../src/ibmi-mcp-server/tools/listSchemas.tool.ts"],"names":[],"mappings":"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"}

package/dist/ibmi-mcp-server/tools/listTablesInSchema.tool.d.ts

@@ -0,0 +1,107 @@
+/**
+ * List Tables in Schema Tool
+ *
+ * Lists tables, views, and physical files in a specific schema with metadata
+ * including row counts. Promoted from YAML tool definition.
+ *
+ * @module listTablesInSchema.tool
+ */
+import { z } from "zod";
+import type { RequestContext } from "../../utils/index.js";
+import type { SdkContext } from "../../mcp-server/tools/utils/types.js";
+declare const ListTablesInputSchema: z.ZodObject<{
+    schema_name: z.ZodString;
+    table_filter: z.ZodDefault<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    schema_name: string;
+    table_filter: string;
+}, {
+    schema_name: string;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    table_filter?: string | undefined;
+}>;
+declare const ListTablesOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    rowCount: z.ZodOptional<z.ZodNumber>;
+    hasMore: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    executionTime: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+    limit?: number | undefined;
+    data?: Record<string, unknown>[] | undefined;
+    executionTime?: number | undefined;
+    rowCount?: number | undefined;
+    offset?: number | undefined;
+    hasMore?: boolean | undefined;
+}, {
+    success: boolean;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+    limit?: number | undefined;
+    data?: Record<string, unknown>[] | undefined;
+    executionTime?: number | undefined;
+    rowCount?: number | undefined;
+    offset?: number | undefined;
+    hasMore?: boolean | undefined;
+}>;
+type ListTablesInput = z.infer<typeof ListTablesInputSchema>;
+type ListTablesOutput = z.infer<typeof ListTablesOutputSchema>;
+export declare function listTablesLogic(params: ListTablesInput, appContext: RequestContext, _sdkContext: SdkContext): Promise<ListTablesOutput>;
+export declare const listTablesInSchemaTool: import("../../mcp-server/tools/utils/types.js").ToolDefinition<{
+    schema_name: z.ZodString;
+    table_filter: z.ZodDefault<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, {
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    rowCount: z.ZodOptional<z.ZodNumber>;
+    hasMore: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    executionTime: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}>;
+export {};
+//# sourceMappingURL=listTablesInSchema.tool.d.ts.map