@neverinfamous/mysql-mcp 2.3.0 → 3.0.0

package/src/adapters/mysql/types.ts

@@ -323,7 +323,7 @@ export const DropTableSchemaBase = z.object({
   ifExists: z
     .boolean()
     .optional()
-    .default(true)
+    .default(false)
     .describe("Add IF EXISTS clause"),
 });
 
@@ -397,6 +397,12 @@ export const GetIndexesSchema = z
 
 // --- TransactionBegin ---
 
+// Base schema for MCP visibility
+export const TransactionBeginSchemaBase = z.object({
+  isolationLevel: z.string().optional().describe("Transaction isolation level"),
+});
+
+// Transformed schema for handler parsing
 export const TransactionBeginSchema = z.preprocess(
   defaultToEmpty,
   z.object({
@@ -467,24 +473,31 @@ export const TransactionExecuteSchemaBase = z.object({
     .optional()
     .describe("SQL statements to execute atomically"),
   queries: z.array(z.string()).optional().describe("Alias for statements"),
-  isolationLevel: z
-    .enum([
-      "READ UNCOMMITTED",
-      "READ COMMITTED",
-      "REPEATABLE READ",
-      "SERIALIZABLE",
-    ])
-    .optional()
-    .describe("Transaction isolation level"),
+  isolationLevel: z.string().optional().describe("Transaction isolation level"),
 });
 
-// Transformed schema for handler parsing
 export const TransactionExecuteSchema = z
   .preprocess(preprocessTransactionExecuteParams, TransactionExecuteSchemaBase)
   .transform((data) => ({
     statements: data.statements ?? data.queries ?? [],
     isolationLevel: data.isolationLevel,
-  }));
+  }))
+  .refine(
+    (data) => {
+      if (!data.isolationLevel) return true;
+      const validLevels = [
+        "READ UNCOMMITTED",
+        "READ COMMITTED",
+        "REPEATABLE READ",
+        "SERIALIZABLE",
+      ];
+      return validLevels.includes(data.isolationLevel);
+    },
+    {
+      message:
+        "Invalid isolationLevel. Expected one of: READ UNCOMMITTED, READ COMMITTED, REPEATABLE READ, SERIALIZABLE",
+    },
+  );
 
 // =============================================================================
 // Preprocess: JSON/Text column params (table, column, where aliases)
@@ -710,6 +723,378 @@ export const JsonSearchSchema = z
     message: "column (or col alias) is required",
   });
 
+// --- JsonInsert ---
+export const JsonInsertSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  column: z.string().optional().describe("JSON column name"),
+  col: z.string().optional().describe("Alias for column"),
+  path: z.string().describe("JSON path to insert at"),
+  value: z.unknown().describe("Value to insert"),
+  where: z.string().optional().describe("WHERE clause to identify rows"),
+  filter: z.string().optional().describe("Alias for where"),
+});
+
+export const JsonInsertSchema = z
+  .preprocess(
+    preprocessJsonColumnParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      column: z.string().optional(),
+      col: z.string().optional(),
+      path: z.string(),
+      value: z.unknown(),
+      where: z.string().optional(),
+      filter: z.string().optional(),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    value: data.value,
+    where: data.where ?? data.filter ?? "",
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+  })
+  .refine((data) => data.where !== "", {
+    message: "where (or filter alias) is required",
+  });
+
+// --- JsonReplace ---
+export const JsonReplaceSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  column: z.string().optional().describe("JSON column name"),
+  col: z.string().optional().describe("Alias for column"),
+  path: z.string().describe("JSON path to replace"),
+  value: z.unknown().describe("Replacement value"),
+  where: z.string().optional().describe("WHERE clause to identify rows"),
+  filter: z.string().optional().describe("Alias for where"),
+});
+
+export const JsonReplaceSchema = z
+  .preprocess(
+    preprocessJsonColumnParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      column: z.string().optional(),
+      col: z.string().optional(),
+      path: z.string(),
+      value: z.unknown(),
+      where: z.string().optional(),
+      filter: z.string().optional(),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    value: data.value,
+    where: data.where ?? data.filter ?? "",
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+  })
+  .refine((data) => data.where !== "", {
+    message: "where (or filter alias) is required",
+  });
+
+// --- JsonRemove ---
+export const JsonRemoveSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  column: z.string().optional().describe("JSON column name"),
+  col: z.string().optional().describe("Alias for column"),
+  paths: z.array(z.string()).describe("JSON paths to remove"),
+  where: z.string().optional().describe("WHERE clause to identify rows"),
+  filter: z.string().optional().describe("Alias for where"),
+});
+
+export const JsonRemoveSchema = z
+  .preprocess(
+    preprocessJsonColumnParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      column: z.string().optional(),
+      col: z.string().optional(),
+      paths: z.array(z.string()),
+      where: z.string().optional(),
+      filter: z.string().optional(),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    paths: data.paths,
+    where: data.where ?? data.filter ?? "",
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+  })
+  .refine((data) => data.where !== "", {
+    message: "where (or filter alias) is required",
+  });
+
+// --- JsonArrayAppend ---
+export const JsonArrayAppendSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  column: z.string().optional().describe("JSON column name"),
+  col: z.string().optional().describe("Alias for column"),
+  path: z.string().describe("JSON path to array"),
+  value: z.unknown().describe("Value to append"),
+  where: z.string().optional().describe("WHERE clause to identify rows"),
+  filter: z.string().optional().describe("Alias for where"),
+});
+
+export const JsonArrayAppendSchema = z
+  .preprocess(
+    preprocessJsonColumnParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      column: z.string().optional(),
+      col: z.string().optional(),
+      path: z.string(),
+      value: z.unknown(),
+      where: z.string().optional(),
+      filter: z.string().optional(),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    value: data.value,
+    where: data.where ?? data.filter ?? "",
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+  })
+  .refine((data) => data.where !== "", {
+    message: "where (or filter alias) is required",
+  });
+
+// --- JsonGet ---
+export const JsonGetSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  column: z.string().optional().describe("JSON column name"),
+  col: z.string().optional().describe("Alias for column"),
+  path: z.string().describe("JSON path to extract"),
+  id: z.union([z.string(), z.number()]).describe("Row ID"),
+  idColumn: z.string().default("id").describe("ID column name"),
+});
+
+export const JsonGetSchema = z
+  .preprocess(
+    preprocessJsonColumnParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      column: z.string().optional(),
+      col: z.string().optional(),
+      path: z.string(),
+      id: z.union([z.string(), z.number()]),
+      idColumn: z.string().default("id"),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    id: data.id,
+    idColumn: data.idColumn,
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+  });
+
+// --- JsonUpdate ---
+export const JsonUpdateSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  column: z.string().optional().describe("JSON column name"),
+  col: z.string().optional().describe("Alias for column"),
+  path: z.string().describe("JSON path to update"),
+  value: z.unknown().describe("New value"),
+  id: z.union([z.string(), z.number()]).describe("Row ID"),
+  idColumn: z.string().default("id").describe("ID column name"),
+});
+
+export const JsonUpdateSchema = z
+  .preprocess(
+    preprocessJsonColumnParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      column: z.string().optional(),
+      col: z.string().optional(),
+      path: z.string(),
+      value: z.unknown(),
+      id: z.union([z.string(), z.number()]),
+      idColumn: z.string().default("id"),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    value: data.value,
+    id: data.id,
+    idColumn: data.idColumn,
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+  });
+
+// --- JsonNormalize ---
+export const JsonNormalizeSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  column: z.string().optional().describe("JSON column name"),
+  col: z.string().optional().describe("Alias for column"),
+  where: z.string().optional().describe("WHERE clause"),
+  filter: z.string().optional().describe("Alias for where"),
+  limit: z.number().default(100).describe("Maximum rows to process"),
+});
+
+export const JsonNormalizeSchema = z
+  .preprocess(
+    preprocessJsonColumnParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      column: z.string().optional(),
+      col: z.string().optional(),
+      where: z.string().optional(),
+      filter: z.string().optional(),
+      limit: z.number().default(100),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    where: data.where ?? data.filter,
+    limit: data.limit,
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+  });
+
+// --- JsonStats ---
+export const JsonStatsSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  column: z.string().optional().describe("JSON column name"),
+  col: z.string().optional().describe("Alias for column"),
+  where: z.string().optional().describe("Optional WHERE clause"),
+  filter: z.string().optional().describe("Alias for where"),
+  sampleSize: z.number().default(1000).describe("Sample size for statistics"),
+});
+
+export const JsonStatsSchema = z
+  .preprocess(
+    preprocessJsonColumnParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      column: z.string().optional(),
+      col: z.string().optional(),
+      where: z.string().optional(),
+      filter: z.string().optional(),
+      sampleSize: z.number().default(1000),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    where: data.where ?? data.filter,
+    sampleSize: data.sampleSize,
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+  });
+
+// --- JsonIndexSuggest ---
+export const JsonIndexSuggestSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  column: z.string().optional().describe("JSON column name"),
+  col: z.string().optional().describe("Alias for column"),
+  sampleSize: z.number().default(100).describe("Sample size to analyze"),
+});
+
+export const JsonIndexSuggestSchema = z
+  .preprocess(
+    preprocessJsonColumnParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      column: z.string().optional(),
+      col: z.string().optional(),
+      sampleSize: z.number().default(100),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    sampleSize: data.sampleSize,
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+  });
+
 // --- JsonValidate (no table/column — no aliases needed) ---
 export const JsonValidateSchema = z.object({
   value: z.string().describe("JSON string to validate"),
@@ -1070,6 +1455,119 @@ export const FulltextSearchSchema = z
     message: "query (or sql alias) is required",
   });
 
+// --- FulltextDrop ---
+export const FulltextDropSchemaBase = z.object({
+  table: z.string().optional().describe("Table containing the index"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  indexName: z
+    .string()
+    .optional()
+    .describe("Name of the FULLTEXT index to drop"),
+});
+
+export const FulltextDropSchema = z
+  .preprocess(
+    preprocessTableParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      indexName: z.string().optional(),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    indexName: data.indexName ?? "",
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.indexName !== "", {
+    message: "indexName is required",
+  });
+
+// --- FulltextBoolean ---
+export const FulltextBooleanSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  columns: z.array(z.string()).optional().describe("Columns to search"),
+  query: z
+    .string()
+    .optional()
+    .describe("Boolean search query with +, -, *, etc."),
+  maxLength: z
+    .number()
+    .optional()
+    .describe(
+      "Optional max characters per text column in results. Truncates with '...' if exceeded.",
+    ),
+});
+
+export const FulltextBooleanSchema = z
+  .preprocess(
+    preprocessTableParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      columns: z.array(z.string()).optional(),
+      query: z.string().optional(),
+      maxLength: z.number().optional(),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    columns: data.columns ?? [],
+    query: data.query ?? "",
+    maxLength: data.maxLength,
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.columns.length > 0, { message: "columns is required" })
+  .refine((data) => data.query !== "", { message: "query is required" });
+
+// --- FulltextExpand ---
+export const FulltextExpandSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  columns: z.array(z.string()).optional().describe("Columns to search"),
+  query: z.string().optional().describe("Search query to expand"),
+  maxLength: z
+    .number()
+    .optional()
+    .describe(
+      "Optional max characters per text column in results. Truncates with '...' if exceeded.",
+    ),
+});
+
+export const FulltextExpandSchema = z
+  .preprocess(
+    preprocessTableParams,
+    z.object({
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      columns: z.array(z.string()).optional(),
+      query: z.string().optional(),
+      maxLength: z.number().optional(),
+    }),
+  )
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    columns: data.columns ?? [],
+    query: data.query ?? "",
+    maxLength: data.maxLength,
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  })
+  .refine((data) => data.columns.length > 0, { message: "columns is required" })
+  .refine((data) => data.query !== "", { message: "query is required" });
+
 // =============================================================================
 // Performance Schemas
 // =============================================================================
@@ -1143,6 +1641,20 @@ export const SlowQuerySchema = z.object({
   minTime: z.number().optional().describe("Minimum query time in seconds"),
 });
 
+// --- QueryStats (no table/query aliases — simple passthrough) ---
+export const QueryStatsSchema = z.object({
+  orderBy: z
+    .enum(["total_time", "avg_time", "executions"])
+    .optional()
+    .default("total_time")
+    .describe("Order results by metric"),
+  limit: z
+    .number()
+    .optional()
+    .default(10)
+    .describe("Maximum number of queries to return"),
+});
+
 // --- IndexUsage ---
 export const IndexUsageSchemaBase = z.object({
   table: z.string().optional().describe("Filter by table name"),
@@ -1195,6 +1707,48 @@ export const TableStatsSchema = z
     message: "table (or tableName/name alias) is required",
   });
 
+// --- IndexRecommendation ---
+
+// Base schema for MCP visibility
+export const IndexRecommendationSchemaBase = z.object({
+  table: z.string().optional().describe("Table to analyze for missing indexes"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+});
+
+// Transformed schema for handler parsing
+export const IndexRecommendationSchema = z
+  .preprocess(preprocessTableParams, IndexRecommendationSchemaBase)
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  });
+
+// --- ForceIndex ---
+
+// Base schema for MCP visibility
+export const ForceIndexSchemaBase = z.object({
+  table: z.string().optional().describe("Table name"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  query: z.string().describe("Original query"),
+  indexName: z.string().describe("Index name to force"),
+});
+
+// Transformed schema for handler parsing
+export const ForceIndexSchema = z
+  .preprocess(preprocessTableParams, ForceIndexSchemaBase)
+  .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    query: data.query,
+    indexName: data.indexName,
+  }))
+  .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+  });
+
 // =============================================================================
 // Preprocess: Admin table params (normalizes singular 'table' to 'tables' array)
 // =============================================================================
@@ -1276,10 +1830,7 @@ export const CheckTableSchemaBase = z.object({
   table: z.string().optional().describe("Single table name (alias for tables)"),
   tableName: z.string().optional().describe("Alias for table"),
   name: z.string().optional().describe("Alias for table"),
-  option: z
-    .enum(["QUICK", "FAST", "MEDIUM", "EXTENDED", "CHANGED"])
-    .optional()
-    .describe("Check option"),
+  option: z.string().optional().describe("Check option"),
 });
 
 export const CheckTableSchema = z
@@ -1303,6 +1854,38 @@ export const CheckTableSchema = z
     message: "tables (or table/tableName/name alias) is required",
   });
 
+// --- RepairTable ---
+export const RepairTableSchemaBase = z.object({
+  tables: z.array(z.string()).optional().describe("Table names to repair"),
+  table: z.string().optional().describe("Single table name (alias for tables)"),
+  tableName: z.string().optional().describe("Alias for table"),
+  name: z.string().optional().describe("Alias for table"),
+  quick: z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe("Quick repair (MyISAM only)"),
+});
+
+export const RepairTableSchema = z
+  .preprocess(
+    preprocessAdminTableParams,
+    z.object({
+      tables: z.array(z.string()).optional(),
+      table: z.string().optional(),
+      tableName: z.string().optional(),
+      name: z.string().optional(),
+      quick: z.boolean().optional().default(false),
+    }),
+  )
+  .transform((data) => ({
+    tables: data.tables ?? [],
+    quick: data.quick,
+  }))
+  .refine((data) => data.tables.length > 0, {
+    message: "tables (or table/tableName/name alias) is required",
+  });
+
 // --- FlushTables ---
 export const FlushTablesSchemaBase = z.object({
   tables: z
@@ -1328,6 +1911,15 @@ export const FlushTablesSchema = z
     tables: data.tables,
   }));
 
+export const KillQuerySchemaBase = z.object({
+  processId: z.number().describe("Process ID to kill"),
+  connection: z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe("Kill connection instead of query"),
+});
+
 export const KillQuerySchema = z.object({
   processId: z.number().describe("Process ID to kill"),
   connection: z
@@ -1347,7 +1939,6 @@ export const ShowStatusSchema = z.object({
   limit: z
     .number()
     .int()
-    .positive()
     .optional()
     .describe(
       "Maximum number of variables to return (default: 100). Set higher to see all.",
@@ -1364,7 +1955,6 @@ export const ShowVariablesSchema = z.object({
   limit: z
     .number()
     .int()
-    .positive()
     .optional()
     .describe(
       "Maximum number of variables to return (default: 100). Set higher to see all.",
@@ -1390,12 +1980,20 @@ export const ExportTableSchemaBase = z.object({
   limit: z
     .number()
     .int()
-    .positive()
     .optional()
     .default(100)
     .describe(
       "Maximum number of rows to export (default: 100). Set higher to export more rows.",
     ),
+  batch: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .default(1)
+    .describe(
+      "Rows per INSERT statement (default: 1). Higher values produce multi-row INSERT ... VALUES (...), (...) for smaller payloads.",
+    ),
 });
 
 export const ExportTableSchema = z
@@ -1409,6 +2007,7 @@ export const ExportTableSchema = z
       where: z.string().optional(),
       filter: z.string().optional(),
       limit: z.number().int().positive().optional().default(100),
+      batch: z.number().int().positive().optional().default(1),
     }),
   )
   .transform((data) => ({
@@ -1416,6 +2015,7 @@ export const ExportTableSchema = z
     format: data.format,
     where: data.where ?? data.filter,
     limit: data.limit,
+    batch: data.batch,
   }))
   .refine((data) => data.table !== "", {
     message: "table (or tableName/name alias) is required",
@@ -1453,11 +2053,24 @@ export const ImportDataSchema = z
 // Replication Schemas
 // =============================================================================
 
+export const BinlogEventsSchemaBase = z.object({
+  logFile: z.string().optional().describe("Binlog file name"),
+  position: z.number().optional().describe("Starting position"),
+  limit: z
+    .number()
+    .optional()
+    .default(20)
+    .describe(
+      "Maximum events to return (default: 20). Set higher for more events.",
+    ),
+});
+
 export const BinlogEventsSchema = z.object({
   logFile: z.string().optional().describe("Binlog file name"),
   position: z.number().optional().describe("Starting position"),
   limit: z
     .number()
+    .nonnegative()
     .optional()
     .default(20)
     .describe(