MySQL MCP has well-structured schemas with proper type constraints and enums, but descriptions lack LLM-optimization guidance. All 7 tools have input schemas with min/max length constraints and proper typing. However, descriptions are in Korean and lack English translations, limiting accessibility. Parameter descriptions are absent, LLMs cannot infer what 'domain', 'table', 'columns', 'where', 'limit' mean without explicit guidance. Error handling is present but generic. Security is strong (OIDC auth, audit logging, scope-based access control), but tool descriptions don't explain WHEN to use each tool or dependencies between them. Output schemas are not documented.

• Translate all tool descriptions and parameter descriptions to English. Use 50-200 character descriptions that explain WHAT the tool does, WHEN to use it, and any prerequisites. Example: 'mysql_select: Query allowed tables with structured WHERE conditions. Use after mysql_describe_table to understand schema. Returns up to 1000 rows; use limit and WHERE to reduce results.'
• Add descriptions to every parameter. For 'where' array, explain: 'Array of filter conditions. Each condition has column (string), operator (eq|ne|gt|gte|lt|lte|like|in|isNull|isNotNull), and value (string|number|boolean|null|array). Max 20 conditions per query.'
• Document output schemas for all tools. Example for mysql_select: 'Returns {records: [{col1: value, col2: value, ...}], rowCount: number}'. For mysql_list_domains: 'Returns {domains: [{domain: string, engine: string, database: string, allowedTables: string[]}]}'.
• Replace generic 'record' parameter in mysql_insert with explicit schema. Require column names and types: {columns: {name: string, email: string, age: number}, values: {name: 'John', email: '[email protected]', age: 30}}. Or accept array of {column, value} pairs.
• Add error classification and recovery guidance. Example: 'Authorization denied: You lack scope 'db:write' for this domain. Contact your admin or use mysql_select (read-only) instead.' Distinguish retryable (timeout, connection) from fatal (permission, schema mismatch).