@berthojoris/mcp-mysql-server 1.23.0 → 1.24.0

package/CHANGELOG.md

@@ -27,6 +27,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Version increment for implemented features and improvements
 
+## [1.24.0] - 2025-12-19
+
+### Added
+- New tool `list_all_tools` for listing all available tools in the MySQL MCP server with their descriptions and schemas
+- Enhanced meta-tool capabilities for AI agents to discover available functionality
+
+### Changed
+- Updated tool count from 144 to 145 in README.md
+- Updated tool count from 157 to 158 in DOCUMENTATIONS.md  
+- Added `list_all_tools` to the Utilities section in documentation
+- Updated Last Updated timestamp in README.md
+- Version increment for new tool implementation
+
 ## [Unreleased]
 
 ### Security

package/DOCUMENTATIONS.md

@@ -9,7 +9,7 @@ This file contains detailed documentation for all features of the MySQL MCP Serv
 ## Table of Contents
 
 1. [Setup & Configuration (Extended)](#setup--configuration-extended) - Permissions + Categories
-2. [🔧 Complete Tools Reference](#🔧-complete-tools-reference) - All 157 tools organized by category
+2. [🔧 Complete Tools Reference](#🔧-complete-tools-reference) - All 158 tools organized by category
 3. [DDL Operations](#🏗️-ddl-operations)
 4. [Data Export Tools](#📤-data-export-tools)
 5. [Data Import Tools](#📥-data-import-tools)
@@ -201,7 +201,7 @@ Add 'bulk_operations' to the categories argument.
 
 ## 🔧 Complete Tools Reference
 
-This section provides a comprehensive reference of all 157 available tools organized by category.
+This section provides a comprehensive reference of all 158 available tools organized by category.
 
 ### Database Discovery
 
@@ -255,6 +255,7 @@ This section provides a comprehensive reference of all 157 available tools organ
 | `read_changelog` | Read the changelog to see new features/changes |
 | `export_table_to_csv` | Export table data to CSV format |
 | `export_query_to_csv` | Export query results to CSV format |
+| `list_all_tools` | List all available tools in this MySQL MCP server |
 
 ### Transaction Management
 

package/README.md

@@ -4,7 +4,7 @@
 
 **A production-ready Model Context Protocol (MCP) server for MySQL database integration with AI agents**
 
-**Last Updated:** 2025-12-18 13:45:00
+**Last Updated:** 2025-12-19 03:59:00
 
 [![npm version](https://img.shields.io/npm/v/@berthojoris/mcp-mysql-server)](https://www.npmjs.com/package/@berthojoris/mysql-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/@berthojoris/mysql-mcp)](https://www.npmjs.com/package/@berthojoris/mysql-mcp)
@@ -300,7 +300,7 @@ Common configuration examples are documented in **[DOCUMENTATIONS.md → Categor
 
 ## Available Tools
 
-The server exposes **144 tools** organized into categories (CRUD, schema, backups, migrations, perf/monitoring, and AI enhancement).
+The server exposes **145 tools** organized into categories (CRUD, schema, backups, migrations, perf/monitoring, and AI enhancement).
 
 - Complete list of tools: **[DOCUMENTATIONS.md → Complete Tools Reference](DOCUMENTATIONS.md#🔧-complete-tools-reference)**
 - AI enhancement tools overview: **[DOCUMENTATIONS.md → AI Enhancement Tools](DOCUMENTATIONS.md#🤖-ai-enhancement-tools)**

package/dist/index.d.ts

@@ -216,6 +216,11 @@ export declare class MySQLMCP {
         data?: any;
         error?: string;
     }>;
+    listAllTools(): Promise<{
+        status: string;
+        data?: any;
+        error?: string;
+    }>;
     beginTransaction(params?: {
         transactionId?: string;
     }): Promise<import("./tools/transactionTools").TransactionResult | {

package/dist/index.js

@@ -270,6 +270,13 @@ class MySQLMCP {
         }
         return await this.utilityTools.readChangelog(params);
     }
+    async listAllTools() {
+        const check = this.checkToolEnabled("listAllTools");
+        if (!check.enabled) {
+            return { status: "error", error: check.error };
+        }
+        return await this.utilityTools.listAllTools();
+    }
     // Transaction Tools
     async beginTransaction(params) {
         const check = this.checkToolEnabled("beginTransaction");

package/dist/mcp-server.js

@@ -699,7 +699,7 @@ const TOOLS = [
     },
     {
         name: "get_all_tables_relationships",
-        description: "Gets foreign key relationships for ALL tables in a single call. Processes relationships in memory to avoid multiple queries.",
+        description: "Gets all table foreign key relationships in one call with memory-efficient relationship mapping.",
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/analysisTools.js

@@ -60,10 +60,10 @@ class AnalysisTools {
                 return { status: "error", error: "Invalid column name" };
             }
             // Check if column exists and get its type
-            const colCheckQuery = `
-        SELECT DATA_TYPE 
-        FROM INFORMATION_SCHEMA.COLUMNS 
-        WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? AND COLUMN_NAME = ?
+            const colCheckQuery = `
+        SELECT DATA_TYPE 
+        FROM INFORMATION_SCHEMA.COLUMNS 
+        WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? AND COLUMN_NAME = ?
       `;
             const colCheck = await this.db.query(colCheckQuery, [
                 database,
@@ -95,34 +95,34 @@ class AnalysisTools {
                 "year",
             ].includes(dataType);
             // Build statistics query
-            let query = `
-        SELECT
-          COUNT(*) as total_rows,
-          COUNT(\`${column_name}\`) as non_null_count,
-          COUNT(DISTINCT \`${column_name}\`) as distinct_count,
-          SUM(CASE WHEN \`${column_name}\` IS NULL THEN 1 ELSE 0 END) as null_count
+            let query = `
+        SELECT
+          COUNT(*) as total_rows,
+          COUNT(\`${column_name}\`) as non_null_count,
+          COUNT(DISTINCT \`${column_name}\`) as distinct_count,
+          SUM(CASE WHEN \`${column_name}\` IS NULL THEN 1 ELSE 0 END) as null_count
       `;
             if (isNumeric || isDate) {
-                query += `,
-          MIN(\`${column_name}\`) as min_value,
-          MAX(\`${column_name}\`) as max_value
+                query += `,
+          MIN(\`${column_name}\`) as min_value,
+          MAX(\`${column_name}\`) as max_value
         `;
             }
             if (isNumeric) {
-                query += `,
-          AVG(\`${column_name}\`) as avg_value
+                query += `,
+          AVG(\`${column_name}\`) as avg_value
         `;
             }
             query += ` FROM \`${database}\`.\`${table_name}\``;
             const statsResult = await this.db.query(query);
             const stats = statsResult[0];
             // Get top frequent values
-            const topValuesQuery = `
-        SELECT \`${column_name}\` as value, COUNT(*) as count
-        FROM \`${database}\`.\`${table_name}\`
-        GROUP BY \`${column_name}\`
-        ORDER BY count DESC
-        LIMIT 5
+            const topValuesQuery = `
+        SELECT \`${column_name}\` as value, COUNT(*) as count
+        FROM \`${database}\`.\`${table_name}\`
+        GROUP BY \`${column_name}\`
+        ORDER BY count DESC
+        LIMIT 5
       `;
             const topValues = await this.db.query(topValuesQuery);
             return {
@@ -171,12 +171,12 @@ class AnalysisTools {
             const totalTablesResult = await this.db.query(`SELECT COUNT(*) as total FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = ?`, [database]);
             const totalTables = totalTablesResult[0]?.total ?? 0;
             // Fetch tables limited for context pack
-            const tables = await this.db.query(`
-          SELECT TABLE_NAME, TABLE_ROWS
-          FROM INFORMATION_SCHEMA.TABLES
-          WHERE TABLE_SCHEMA = ?
-          ORDER BY TABLE_NAME
-          LIMIT ?
+            const tables = await this.db.query(`
+          SELECT TABLE_NAME, TABLE_ROWS
+          FROM INFORMATION_SCHEMA.TABLES
+          WHERE TABLE_SCHEMA = ?
+          ORDER BY TABLE_NAME
+          LIMIT ?
         `, [database, maxTables]);
             if (!tables.length) {
                 return {
@@ -193,23 +193,23 @@ class AnalysisTools {
             const tableNames = tables.map((t) => t.TABLE_NAME);
             const placeholders = tableNames.map(() => "?").join(",");
             const columnParams = [database, ...tableNames];
-            const columns = await this.db.query(`
-          SELECT TABLE_NAME, COLUMN_NAME, DATA_TYPE, COLUMN_KEY, IS_NULLABLE
-          FROM INFORMATION_SCHEMA.COLUMNS
-          WHERE TABLE_SCHEMA = ?
-            AND TABLE_NAME IN (${placeholders})
-          ORDER BY TABLE_NAME, ORDINAL_POSITION
+            const columns = await this.db.query(`
+          SELECT TABLE_NAME, COLUMN_NAME, DATA_TYPE, COLUMN_KEY, IS_NULLABLE
+          FROM INFORMATION_SCHEMA.COLUMNS
+          WHERE TABLE_SCHEMA = ?
+            AND TABLE_NAME IN (${placeholders})
+          ORDER BY TABLE_NAME, ORDINAL_POSITION
         `, columnParams);
             let foreignKeys = [];
             if (includeRelationships) {
                 const fkParams = [database, ...tableNames, ...tableNames];
-                foreignKeys = await this.db.query(`
-            SELECT TABLE_NAME, COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME
-            FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
-            WHERE TABLE_SCHEMA = ?
-              AND TABLE_NAME IN (${placeholders})
-              AND REFERENCED_TABLE_NAME IN (${placeholders})
-              AND REFERENCED_TABLE_NAME IS NOT NULL
+                foreignKeys = await this.db.query(`
+            SELECT TABLE_NAME, COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME
+            FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
+            WHERE TABLE_SCHEMA = ?
+              AND TABLE_NAME IN (${placeholders})
+              AND REFERENCED_TABLE_NAME IN (${placeholders})
+              AND REFERENCED_TABLE_NAME IS NOT NULL
           `, fkParams);
             }
             const fkLookup = new Map();

package/dist/tools/indexRecommendationTools.js

@@ -250,11 +250,11 @@ class IndexRecommendationTools {
         return false;
     }
     async getExistingIndexMap(database) {
-        const rows = await this.db.query(`
-      SELECT TABLE_NAME, INDEX_NAME, SEQ_IN_INDEX, COLUMN_NAME
-      FROM INFORMATION_SCHEMA.STATISTICS
-      WHERE TABLE_SCHEMA = ?
-      ORDER BY TABLE_NAME, INDEX_NAME, SEQ_IN_INDEX
+        const rows = await this.db.query(`
+      SELECT TABLE_NAME, INDEX_NAME, SEQ_IN_INDEX, COLUMN_NAME
+      FROM INFORMATION_SCHEMA.STATISTICS
+      WHERE TABLE_SCHEMA = ?
+      ORDER BY TABLE_NAME, INDEX_NAME, SEQ_IN_INDEX
     `, [database]);
         const byTable = new Map();
         for (const r of rows) {
@@ -281,21 +281,21 @@ class IndexRecommendationTools {
     }
     async getTopSelectDigests(limit) {
         // Note: performance_schema access may require extra privileges.
-        const query = `
-      SELECT
-        DIGEST_TEXT as query_pattern,
-        COUNT_STAR as execution_count,
-        ROUND(AVG_TIMER_WAIT / 1000000000000, 6) as avg_execution_time_sec,
-        ROUND(SUM_TIMER_WAIT / 1000000000000, 6) as total_execution_time_sec,
-        SUM_ROWS_EXAMINED as rows_examined,
-        SUM_ROWS_SENT as rows_sent,
-        FIRST_SEEN as first_seen,
-        LAST_SEEN as last_seen
-      FROM performance_schema.events_statements_summary_by_digest
-      WHERE DIGEST_TEXT IS NOT NULL
-        AND DIGEST_TEXT LIKE 'SELECT %'
-      ORDER BY SUM_TIMER_WAIT DESC
-      LIMIT ${limit}
+        const query = `
+      SELECT
+        DIGEST_TEXT as query_pattern,
+        COUNT_STAR as execution_count,
+        ROUND(AVG_TIMER_WAIT / 1000000000000, 6) as avg_execution_time_sec,
+        ROUND(SUM_TIMER_WAIT / 1000000000000, 6) as total_execution_time_sec,
+        SUM_ROWS_EXAMINED as rows_examined,
+        SUM_ROWS_SENT as rows_sent,
+        FIRST_SEEN as first_seen,
+        LAST_SEEN as last_seen
+      FROM performance_schema.events_statements_summary_by_digest
+      WHERE DIGEST_TEXT IS NOT NULL
+        AND DIGEST_TEXT LIKE 'SELECT %'
+      ORDER BY SUM_TIMER_WAIT DESC
+      LIMIT ${limit}
     `;
         const rows = await this.db.query(query);
         return rows.map((r) => ({
@@ -310,25 +310,25 @@ class IndexRecommendationTools {
         }));
     }
     async getUnusedIndexes() {
-        const query = `
-      SELECT
-        t.TABLE_SCHEMA as table_schema,
-        t.TABLE_NAME as table_name,
-        s.INDEX_NAME as index_name
-      FROM information_schema.STATISTICS s
-      LEFT JOIN performance_schema.table_io_waits_summary_by_index_usage p
-        ON s.TABLE_SCHEMA = p.OBJECT_SCHEMA
-        AND s.TABLE_NAME = p.OBJECT_NAME
-        AND s.INDEX_NAME = p.INDEX_NAME
-      JOIN information_schema.TABLES t
-        ON s.TABLE_SCHEMA = t.TABLE_SCHEMA
-        AND s.TABLE_NAME = t.TABLE_NAME
-      WHERE s.TABLE_SCHEMA NOT IN ('mysql', 'performance_schema', 'information_schema', 'sys')
-        AND s.INDEX_NAME != 'PRIMARY'
-        AND (p.INDEX_NAME IS NULL OR p.COUNT_STAR = 0)
-        AND t.TABLE_TYPE = 'BASE TABLE'
-      GROUP BY t.TABLE_SCHEMA, t.TABLE_NAME, s.INDEX_NAME
-      ORDER BY t.TABLE_SCHEMA, t.TABLE_NAME, s.INDEX_NAME
+        const query = `
+      SELECT
+        t.TABLE_SCHEMA as table_schema,
+        t.TABLE_NAME as table_name,
+        s.INDEX_NAME as index_name
+      FROM information_schema.STATISTICS s
+      LEFT JOIN performance_schema.table_io_waits_summary_by_index_usage p
+        ON s.TABLE_SCHEMA = p.OBJECT_SCHEMA
+        AND s.TABLE_NAME = p.OBJECT_NAME
+        AND s.INDEX_NAME = p.INDEX_NAME
+      JOIN information_schema.TABLES t
+        ON s.TABLE_SCHEMA = t.TABLE_SCHEMA
+        AND s.TABLE_NAME = t.TABLE_NAME
+      WHERE s.TABLE_SCHEMA NOT IN ('mysql', 'performance_schema', 'information_schema', 'sys')
+        AND s.INDEX_NAME != 'PRIMARY'
+        AND (p.INDEX_NAME IS NULL OR p.COUNT_STAR = 0)
+        AND t.TABLE_TYPE = 'BASE TABLE'
+      GROUP BY t.TABLE_SCHEMA, t.TABLE_NAME, s.INDEX_NAME
+      ORDER BY t.TABLE_SCHEMA, t.TABLE_NAME, s.INDEX_NAME
     `;
         const rows = await this.db.query(query);
         return rows.map((r) => ({

package/dist/tools/performanceTools.js

@@ -17,28 +17,28 @@ class PerformanceTools {
         try {
             const metrics = {};
             // Get query performance metrics
-            const perfQuery = `
-        SELECT
-          SUM(TIMER_WAIT) / 1000000000000 as total_execution_time_sec,
-          SUM(LOCK_TIME) / 1000000000000 as total_lock_time_sec,
-          SUM(ROWS_EXAMINED) as total_rows_examined,
-          SUM(ROWS_SENT) as total_rows_sent,
-          SUM(ROWS_AFFECTED) as total_rows_affected,
-          SUM(SELECT_FULL_JOIN) as full_table_scans,
-          SUM(NO_INDEX_USED) as queries_without_indexes,
-          SUM(NO_GOOD_INDEX_USED) as queries_with_bad_indexes,
-          COUNT(*) as total_queries
-        FROM performance_schema.events_statements_summary_global_by_event_name
-        WHERE EVENT_NAME LIKE 'statement/sql/%'
+            const perfQuery = `
+        SELECT
+          SUM(TIMER_WAIT) / 1000000000000 as total_execution_time_sec,
+          SUM(LOCK_TIME) / 1000000000000 as total_lock_time_sec,
+          SUM(ROWS_EXAMINED) as total_rows_examined,
+          SUM(ROWS_SENT) as total_rows_sent,
+          SUM(ROWS_AFFECTED) as total_rows_affected,
+          SUM(SELECT_FULL_JOIN) as full_table_scans,
+          SUM(NO_INDEX_USED) as queries_without_indexes,
+          SUM(NO_GOOD_INDEX_USED) as queries_with_bad_indexes,
+          COUNT(*) as total_queries
+        FROM performance_schema.events_statements_summary_global_by_event_name
+        WHERE EVENT_NAME LIKE 'statement/sql/%'
       `;
             const perfResult = await this.db.query(perfQuery);
             metrics.query_performance = perfResult[0] || {};
             // Get connection metrics
-            const connQuery = `
-        SHOW GLOBAL STATUS WHERE Variable_name IN (
-          'Threads_connected', 'Threads_running', 'Threads_created',
-          'Connections', 'Max_used_connections', 'Aborted_connects', 'Aborted_clients'
-        )
+            const connQuery = `
+        SHOW GLOBAL STATUS WHERE Variable_name IN (
+          'Threads_connected', 'Threads_running', 'Threads_created',
+          'Connections', 'Max_used_connections', 'Aborted_connects', 'Aborted_clients'
+        )
       `;
             const connResult = await this.db.query(connQuery);
             metrics.connections = {};
@@ -46,11 +46,11 @@ class PerformanceTools {
                 metrics.connections[row.Variable_name.toLowerCase()] = row.Value;
             }
             // Get table cache metrics
-            const cacheQuery = `
-        SHOW GLOBAL STATUS WHERE Variable_name IN (
-          'Open_tables', 'Opened_tables', 'Table_open_cache_hits',
-          'Table_open_cache_misses', 'Table_open_cache_overflows'
-        )
+            const cacheQuery = `
+        SHOW GLOBAL STATUS WHERE Variable_name IN (
+          'Open_tables', 'Opened_tables', 'Table_open_cache_hits',
+          'Table_open_cache_misses', 'Table_open_cache_overflows'
+        )
       `;
             const cacheResult = await this.db.query(cacheQuery);
             metrics.table_cache = {};
@@ -58,15 +58,15 @@ class PerformanceTools {
                 metrics.table_cache[row.Variable_name.toLowerCase()] = row.Value;
             }
             // Get InnoDB metrics
-            const innodbQuery = `
-        SHOW GLOBAL STATUS WHERE Variable_name LIKE 'Innodb_%'
-        AND Variable_name IN (
-          'Innodb_buffer_pool_reads', 'Innodb_buffer_pool_read_requests',
-          'Innodb_buffer_pool_pages_total', 'Innodb_buffer_pool_pages_free',
-          'Innodb_buffer_pool_pages_data', 'Innodb_buffer_pool_pages_dirty',
-          'Innodb_row_lock_waits', 'Innodb_row_lock_time', 'Innodb_rows_read',
-          'Innodb_rows_inserted', 'Innodb_rows_updated', 'Innodb_rows_deleted'
-        )
+            const innodbQuery = `
+        SHOW GLOBAL STATUS WHERE Variable_name LIKE 'Innodb_%'
+        AND Variable_name IN (
+          'Innodb_buffer_pool_reads', 'Innodb_buffer_pool_read_requests',
+          'Innodb_buffer_pool_pages_total', 'Innodb_buffer_pool_pages_free',
+          'Innodb_buffer_pool_pages_data', 'Innodb_buffer_pool_pages_dirty',
+          'Innodb_row_lock_waits', 'Innodb_row_lock_time', 'Innodb_rows_read',
+          'Innodb_rows_inserted', 'Innodb_rows_updated', 'Innodb_rows_deleted'
+        )
       `;
             const innodbResult = await this.db.query(innodbQuery);
             metrics.innodb = {};
@@ -82,8 +82,8 @@ class PerformanceTools {
                     (((requests - reads) / requests) * 100).toFixed(2) + "%";
             }
             // Get slow query metrics
-            const slowQuery = `
-        SHOW GLOBAL STATUS WHERE Variable_name IN ('Slow_queries', 'Questions')
+            const slowQuery = `
+        SHOW GLOBAL STATUS WHERE Variable_name IN ('Slow_queries', 'Questions')
       `;
             const slowResult = await this.db.query(slowQuery);
             metrics.slow_queries = {};
@@ -121,23 +121,23 @@ class PerformanceTools {
                     error: "Limit must be a positive integer between 1 and 100",
                 };
             }
-            const query = `
-        SELECT
-          DIGEST_TEXT as query_pattern,
-          COUNT_STAR as execution_count,
-          ROUND(AVG_TIMER_WAIT / 1000000000000, 6) as avg_execution_time_sec,
-          ROUND(MAX_TIMER_WAIT / 1000000000000, 6) as max_execution_time_sec,
-          ROUND(SUM_TIMER_WAIT / 1000000000000, 6) as total_execution_time_sec,
-          ROUND(SUM_LOCK_TIME / 1000000000000, 6) as total_lock_time_sec,
-          SUM_ROWS_EXAMINED as rows_examined,
-          SUM_ROWS_SENT as rows_sent,
-          SUM_ROWS_AFFECTED as rows_affected,
-          FIRST_SEEN,
-          LAST_SEEN
-        FROM performance_schema.events_statements_summary_by_digest
-        WHERE DIGEST_TEXT IS NOT NULL
-        ORDER BY SUM_TIMER_WAIT DESC
-        LIMIT ${limit}
+            const query = `
+        SELECT
+          DIGEST_TEXT as query_pattern,
+          COUNT_STAR as execution_count,
+          ROUND(AVG_TIMER_WAIT / 1000000000000, 6) as avg_execution_time_sec,
+          ROUND(MAX_TIMER_WAIT / 1000000000000, 6) as max_execution_time_sec,
+          ROUND(SUM_TIMER_WAIT / 1000000000000, 6) as total_execution_time_sec,
+          ROUND(SUM_LOCK_TIME / 1000000000000, 6) as total_lock_time_sec,
+          SUM_ROWS_EXAMINED as rows_examined,
+          SUM_ROWS_SENT as rows_sent,
+          SUM_ROWS_AFFECTED as rows_affected,
+          FIRST_SEEN,
+          LAST_SEEN
+        FROM performance_schema.events_statements_summary_by_digest
+        WHERE DIGEST_TEXT IS NOT NULL
+        ORDER BY SUM_TIMER_WAIT DESC
+        LIMIT ${limit}
       `;
             const results = await this.db.query(query);
             return {
@@ -164,21 +164,21 @@ class PerformanceTools {
                     error: "Limit must be a positive integer between 1 and 100",
                 };
             }
-            const query = `
-        SELECT
-          DIGEST_TEXT as query_pattern,
-          COUNT_STAR as execution_count,
-          ROUND(AVG_TIMER_WAIT / 1000000000000, 6) as avg_execution_time_sec,
-          ROUND(MAX_TIMER_WAIT / 1000000000000, 6) as max_execution_time_sec,
-          ROUND(SUM_TIMER_WAIT / 1000000000000, 6) as total_execution_time_sec,
-          SUM_ROWS_EXAMINED as rows_examined,
-          SUM_ROWS_SENT as rows_sent,
-          FIRST_SEEN,
-          LAST_SEEN
-        FROM performance_schema.events_statements_summary_by_digest
-        WHERE DIGEST_TEXT IS NOT NULL
-        ORDER BY COUNT_STAR DESC
-        LIMIT ${limit}
+            const query = `
+        SELECT
+          DIGEST_TEXT as query_pattern,
+          COUNT_STAR as execution_count,
+          ROUND(AVG_TIMER_WAIT / 1000000000000, 6) as avg_execution_time_sec,
+          ROUND(MAX_TIMER_WAIT / 1000000000000, 6) as max_execution_time_sec,
+          ROUND(SUM_TIMER_WAIT / 1000000000000, 6) as total_execution_time_sec,
+          SUM_ROWS_EXAMINED as rows_examined,
+          SUM_ROWS_SENT as rows_sent,
+          FIRST_SEEN,
+          LAST_SEEN
+        FROM performance_schema.events_statements_summary_by_digest
+        WHERE DIGEST_TEXT IS NOT NULL
+        ORDER BY COUNT_STAR DESC
+        LIMIT ${limit}
       `;
             const results = await this.db.query(query);
             return {
@@ -213,23 +213,23 @@ class PerformanceTools {
                 };
             }
             const thresholdPico = thresholdSec * 1000000000000;
-            const query = `
-        SELECT
-          DIGEST_TEXT as query_pattern,
-          COUNT_STAR as execution_count,
-          ROUND(AVG_TIMER_WAIT / 1000000000000, 6) as avg_execution_time_sec,
-          ROUND(MAX_TIMER_WAIT / 1000000000000, 6) as max_execution_time_sec,
-          ROUND(SUM_TIMER_WAIT / 1000000000000, 6) as total_execution_time_sec,
-          ROUND(SUM_LOCK_TIME / 1000000000000, 6) as total_lock_time_sec,
-          SUM_ROWS_EXAMINED as rows_examined,
-          SUM_ROWS_SENT as rows_sent,
-          SUM_NO_INDEX_USED as no_index_used_count,
-          FIRST_SEEN,
-          LAST_SEEN
-        FROM performance_schema.events_statements_summary_by_digest
-        WHERE DIGEST_TEXT IS NOT NULL AND AVG_TIMER_WAIT > ${thresholdPico}
-        ORDER BY AVG_TIMER_WAIT DESC
-        LIMIT ${limit}
+            const query = `
+        SELECT
+          DIGEST_TEXT as query_pattern,
+          COUNT_STAR as execution_count,
+          ROUND(AVG_TIMER_WAIT / 1000000000000, 6) as avg_execution_time_sec,
+          ROUND(MAX_TIMER_WAIT / 1000000000000, 6) as max_execution_time_sec,
+          ROUND(SUM_TIMER_WAIT / 1000000000000, 6) as total_execution_time_sec,
+          ROUND(SUM_LOCK_TIME / 1000000000000, 6) as total_lock_time_sec,
+          SUM_ROWS_EXAMINED as rows_examined,
+          SUM_ROWS_SENT as rows_sent,
+          SUM_NO_INDEX_USED as no_index_used_count,
+          FIRST_SEEN,
+          LAST_SEEN
+        FROM performance_schema.events_statements_summary_by_digest
+        WHERE DIGEST_TEXT IS NOT NULL AND AVG_TIMER_WAIT > ${thresholdPico}
+        ORDER BY AVG_TIMER_WAIT DESC
+        LIMIT ${limit}
       `;
             const results = await this.db.query(query);
             return {
@@ -257,21 +257,21 @@ class PerformanceTools {
                     error: "Limit must be a positive integer between 1 and 100",
                 };
             }
-            let query = `
-        SELECT
-          OBJECT_SCHEMA as table_schema,
-          OBJECT_NAME as table_name,
-          COUNT_READ as read_operations,
-          COUNT_WRITE as write_operations,
-          COUNT_FETCH as fetch_operations,
-          COUNT_INSERT as insert_operations,
-          COUNT_UPDATE as update_operations,
-          COUNT_DELETE as delete_operations,
-          ROUND(SUM_TIMER_READ / 1000000000000, 6) as total_read_time_sec,
-          ROUND(SUM_TIMER_WRITE / 1000000000000, 6) as total_write_time_sec,
-          ROUND(SUM_TIMER_FETCH / 1000000000000, 6) as total_fetch_time_sec
-        FROM performance_schema.table_io_waits_summary_by_table
-        WHERE OBJECT_SCHEMA NOT IN ('mysql', 'performance_schema', 'information_schema', 'sys')
+            let query = `
+        SELECT
+          OBJECT_SCHEMA as table_schema,
+          OBJECT_NAME as table_name,
+          COUNT_READ as read_operations,
+          COUNT_WRITE as write_operations,
+          COUNT_FETCH as fetch_operations,
+          COUNT_INSERT as insert_operations,
+          COUNT_UPDATE as update_operations,
+          COUNT_DELETE as delete_operations,
+          ROUND(SUM_TIMER_READ / 1000000000000, 6) as total_read_time_sec,
+          ROUND(SUM_TIMER_WRITE / 1000000000000, 6) as total_write_time_sec,
+          ROUND(SUM_TIMER_FETCH / 1000000000000, 6) as total_fetch_time_sec
+        FROM performance_schema.table_io_waits_summary_by_table
+        WHERE OBJECT_SCHEMA NOT IN ('mysql', 'performance_schema', 'information_schema', 'sys')
       `;
             if (schema) {
                 query += ` AND OBJECT_SCHEMA = '${schema.replace(/'/g, "''")}'`;
@@ -303,21 +303,21 @@ class PerformanceTools {
                     error: "Limit must be a positive integer between 1 and 100",
                 };
             }
-            let query = `
-        SELECT
-          OBJECT_SCHEMA as table_schema,
-          OBJECT_NAME as table_name,
-          INDEX_NAME as index_name,
-          COUNT_STAR as usage_count,
-          COUNT_READ as read_count,
-          COUNT_WRITE as write_count,
-          COUNT_FETCH as fetch_count,
-          COUNT_INSERT as insert_count,
-          COUNT_UPDATE as update_count,
-          COUNT_DELETE as delete_count
-        FROM performance_schema.table_io_waits_summary_by_index_usage
-        WHERE OBJECT_SCHEMA NOT IN ('mysql', 'performance_schema', 'information_schema', 'sys')
-        AND INDEX_NAME IS NOT NULL
+            let query = `
+        SELECT
+          OBJECT_SCHEMA as table_schema,
+          OBJECT_NAME as table_name,
+          INDEX_NAME as index_name,
+          COUNT_STAR as usage_count,
+          COUNT_READ as read_count,
+          COUNT_WRITE as write_count,
+          COUNT_FETCH as fetch_count,
+          COUNT_INSERT as insert_count,
+          COUNT_UPDATE as update_count,
+          COUNT_DELETE as delete_count
+        FROM performance_schema.table_io_waits_summary_by_index_usage
+        WHERE OBJECT_SCHEMA NOT IN ('mysql', 'performance_schema', 'information_schema', 'sys')
+        AND INDEX_NAME IS NOT NULL
       `;
             if (schema) {
                 query += ` AND OBJECT_SCHEMA = '${schema.replace(/'/g, "''")}'`;
@@ -342,26 +342,26 @@ class PerformanceTools {
     async getUnusedIndexes(params) {
         try {
             const schema = params?.table_schema;
-            let query = `
-        SELECT
-          t.TABLE_SCHEMA as table_schema,
-          t.TABLE_NAME as table_name,
-          s.INDEX_NAME as index_name,
-          s.COLUMN_NAME as column_name,
-          s.SEQ_IN_INDEX as sequence_in_index,
-          s.NON_UNIQUE as is_non_unique
-        FROM information_schema.STATISTICS s
-        LEFT JOIN performance_schema.table_io_waits_summary_by_index_usage p
-          ON s.TABLE_SCHEMA = p.OBJECT_SCHEMA
-          AND s.TABLE_NAME = p.OBJECT_NAME
-          AND s.INDEX_NAME = p.INDEX_NAME
-        JOIN information_schema.TABLES t
-          ON s.TABLE_SCHEMA = t.TABLE_SCHEMA
-          AND s.TABLE_NAME = t.TABLE_NAME
-        WHERE s.TABLE_SCHEMA NOT IN ('mysql', 'performance_schema', 'information_schema', 'sys')
-          AND s.INDEX_NAME != 'PRIMARY'
-          AND (p.INDEX_NAME IS NULL OR p.COUNT_STAR = 0)
-          AND t.TABLE_TYPE = 'BASE TABLE'
+            let query = `
+        SELECT
+          t.TABLE_SCHEMA as table_schema,
+          t.TABLE_NAME as table_name,
+          s.INDEX_NAME as index_name,
+          s.COLUMN_NAME as column_name,
+          s.SEQ_IN_INDEX as sequence_in_index,
+          s.NON_UNIQUE as is_non_unique
+        FROM information_schema.STATISTICS s
+        LEFT JOIN performance_schema.table_io_waits_summary_by_index_usage p
+          ON s.TABLE_SCHEMA = p.OBJECT_SCHEMA
+          AND s.TABLE_NAME = p.OBJECT_NAME
+          AND s.INDEX_NAME = p.INDEX_NAME
+        JOIN information_schema.TABLES t
+          ON s.TABLE_SCHEMA = t.TABLE_SCHEMA
+          AND s.TABLE_NAME = t.TABLE_NAME
+        WHERE s.TABLE_SCHEMA NOT IN ('mysql', 'performance_schema', 'information_schema', 'sys')
+          AND s.INDEX_NAME != 'PRIMARY'
+          AND (p.INDEX_NAME IS NULL OR p.COUNT_STAR = 0)
+          AND t.TABLE_TYPE = 'BASE TABLE'
       `;
             if (schema) {
                 query += ` AND s.TABLE_SCHEMA = '${schema.replace(/'/g, "''")}'`;
@@ -385,18 +385,18 @@ class PerformanceTools {
      */
     async getConnectionPoolStats() {
         try {
-            const statusQuery = `
-        SHOW GLOBAL STATUS WHERE Variable_name IN (
-          'Threads_connected', 'Threads_running', 'Threads_created', 'Threads_cached',
-          'Connections', 'Max_used_connections', 'Max_used_connections_time',
-          'Aborted_connects', 'Aborted_clients', 'Connection_errors_max_connections'
-        )
+            const statusQuery = `
+        SHOW GLOBAL STATUS WHERE Variable_name IN (
+          'Threads_connected', 'Threads_running', 'Threads_created', 'Threads_cached',
+          'Connections', 'Max_used_connections', 'Max_used_connections_time',
+          'Aborted_connects', 'Aborted_clients', 'Connection_errors_max_connections'
+        )
       `;
-            const variablesQuery = `
-        SHOW GLOBAL VARIABLES WHERE Variable_name IN (
-          'max_connections', 'thread_cache_size', 'connect_timeout',
-          'wait_timeout', 'interactive_timeout'
-        )
+            const variablesQuery = `
+        SHOW GLOBAL VARIABLES WHERE Variable_name IN (
+          'max_connections', 'thread_cache_size', 'connect_timeout',
+          'wait_timeout', 'interactive_timeout'
+        )
       `;
             const statusResult = await this.db.query(statusQuery);
             const variablesResult = await this.db.query(variablesQuery);
@@ -461,8 +461,8 @@ class PerformanceTools {
                 errors: [],
             };
             // Check 1: Connection usage
-            const connQuery = `
-        SHOW GLOBAL STATUS WHERE Variable_name IN ('Threads_connected', 'Max_used_connections')
+            const connQuery = `
+        SHOW GLOBAL STATUS WHERE Variable_name IN ('Threads_connected', 'Max_used_connections')
       `;
             const maxConnQuery = `SHOW GLOBAL VARIABLES WHERE Variable_name = 'max_connections'`;
             const connResult = await this.db.query(connQuery);
@@ -498,8 +498,8 @@ class PerformanceTools {
                     health.overall_status = "warning";
             }
             // Check 2: Buffer pool hit ratio
-            const bufferQuery = `
-        SHOW GLOBAL STATUS WHERE Variable_name IN ('Innodb_buffer_pool_read_requests', 'Innodb_buffer_pool_reads')
+            const bufferQuery = `
+        SHOW GLOBAL STATUS WHERE Variable_name IN ('Innodb_buffer_pool_read_requests', 'Innodb_buffer_pool_reads')
       `;
             const bufferResult = await this.db.query(bufferQuery);
             let readRequests = 0;
@@ -526,8 +526,8 @@ class PerformanceTools {
                     health.overall_status = "warning";
             }
             // Check 3: Aborted connections
-            const abortQuery = `
-        SHOW GLOBAL STATUS WHERE Variable_name IN ('Connections', 'Aborted_connects')
+            const abortQuery = `
+        SHOW GLOBAL STATUS WHERE Variable_name IN ('Connections', 'Aborted_connects')
       `;
             const abortResult = await this.db.query(abortQuery);
             let totalConnections = 0;
@@ -557,8 +557,8 @@ class PerformanceTools {
                     health.overall_status = "warning";
             }
             // Check 4: Slow queries
-            const slowQuery = `
-        SHOW GLOBAL STATUS WHERE Variable_name IN ('Questions', 'Slow_queries')
+            const slowQuery = `
+        SHOW GLOBAL STATUS WHERE Variable_name IN ('Questions', 'Slow_queries')
       `;
             const slowResult = await this.db.query(slowQuery);
             let questions = 0;

package/dist/tools/securityAuditTools.js

@@ -217,15 +217,15 @@ class SecurityAuditTools {
     async tryReadUserAccounts() {
         try {
             // We intentionally do NOT return authentication_string or password hashes.
-            const rows = await this.db.query(`
-        SELECT
-          User as user,
-          Host as host,
-          account_locked,
-          password_expired,
-          plugin
-        FROM mysql.user
-        WHERE User NOT IN ('mysql.sys', 'mysql.session', 'mysql.infoschema')
+            const rows = await this.db.query(`
+        SELECT
+          User as user,
+          Host as host,
+          account_locked,
+          password_expired,
+          plugin
+        FROM mysql.user
+        WHERE User NOT IN ('mysql.sys', 'mysql.session', 'mysql.infoschema')
       `);
             const findings = [];
             const anonymous = rows.filter((r) => !r.user);
@@ -282,10 +282,10 @@ class SecurityAuditTools {
     async tryReadPrivilegeSummaries() {
         try {
             // These INFORMATION_SCHEMA views are generally less sensitive than mysql.user.
-            const schemaPriv = await this.db.query(`
-        SELECT GRANTEE as grantee, TABLE_SCHEMA as schema_name, PRIVILEGE_TYPE as privilege_type
-        FROM INFORMATION_SCHEMA.SCHEMA_PRIVILEGES
-        WHERE TABLE_SCHEMA NOT IN ('mysql','performance_schema','information_schema','sys')
+            const schemaPriv = await this.db.query(`
+        SELECT GRANTEE as grantee, TABLE_SCHEMA as schema_name, PRIVILEGE_TYPE as privilege_type
+        FROM INFORMATION_SCHEMA.SCHEMA_PRIVILEGES
+        WHERE TABLE_SCHEMA NOT IN ('mysql','performance_schema','information_schema','sys')
       `);
             const findings = [];
             const anyAll = schemaPriv.filter((r) => (r.privilege_type || "").toUpperCase() === "ALL PRIVILEGES");

package/dist/tools/utilityTools.d.ts

@@ -38,6 +38,14 @@ export declare class UtilityTools {
         data?: any;
         error?: string;
     }>;
+    /**
+     * Lists all available tools in this MySQL MCP server
+     */
+    listAllTools(): Promise<{
+        status: string;
+        data?: any;
+        error?: string;
+    }>;
     /**
      * Reads the CHANGELOG.md file from the project root
      */

package/dist/tools/utilityTools.js

@@ -292,6 +292,45 @@ class UtilityTools {
             };
         }
     }
+    /**
+     * Lists all available tools in this MySQL MCP server
+     */
+    async listAllTools() {
+        try {
+            // Read manifest.json to get tool definitions
+            const manifestPath = path_1.default.resolve(__dirname, "..", "..", "manifest.json");
+            if (!fs_1.default.existsSync(manifestPath)) {
+                return {
+                    status: "error",
+                    error: "manifest.json not found in project root.",
+                };
+            }
+            const manifestContent = fs_1.default.readFileSync(manifestPath, "utf-8");
+            const manifest = JSON.parse(manifestContent);
+            const tools = manifest.tools.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+                input_schema: tool.input_schema,
+                output_schema: tool.output_schema
+            }));
+            return {
+                status: "success",
+                data: {
+                    total_tools: tools.length,
+                    server_name: manifest.name,
+                    server_version: manifest.version,
+                    server_description: manifest.description,
+                    tools: tools
+                }
+            };
+        }
+        catch (error) {
+            return {
+                status: "error",
+                error: `Failed to list tools: ${error.message}`,
+            };
+        }
+    }
     /**
      * Reads the CHANGELOG.md file from the project root
      */

package/manifest.json

@@ -404,7 +404,7 @@
     },
     {
       "name": "get_all_tables_relationships",
-      "description": "Gets foreign key relationships for ALL tables in a single call. Processes relationships in memory to avoid multiple queries.",
+      "description": "Gets all table foreign key relationships in one call with memory-efficient relationship mapping.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -784,6 +784,42 @@
           "error": { "type": ["string", "null"] }
         }
       }
+    },
+    {
+      "name": "list_all_tools",
+      "description": "Lists all available tools in this MySQL MCP server with their descriptions and schemas.",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      },
+      "output_schema": {
+        "type": "object",
+        "properties": {
+          "status": { "type": "string" },
+          "data": {
+            "type": "object",
+            "properties": {
+              "total_tools": { "type": "number" },
+              "server_name": { "type": "string" },
+              "server_version": { "type": "string" },
+              "server_description": { "type": "string" },
+              "tools": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": { "type": "string" },
+                    "description": { "type": "string" },
+                    "input_schema": { "type": "object" },
+                    "output_schema": { "type": "object" }
+                  }
+                }
+              }
+            }
+          },
+          "error": { "type": ["string", "null"] }
+        }
+      }
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.23.0",
+  "version": "1.24.0",
   "description": "Model Context Protocol server for MySQL database integration with dynamic per-project permissions, backup/restore, data import/export, and data migration capabilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",