MCP server for executing SQL queries and managing PostgreSQL databases
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. Tool names follow verb_noun convention (query_database, list_tables, describe_table), which is good. However, descriptions are minimal (10-40 chars), parameter descriptions lack detail on constraints and formats, and output schemas are not documented. No error handling guidance. The query_database tool accepts arbitrary SQL with args array but lacks validation constraints or injection warnings. Missing idempotency guidance for write operations.
Get table schema information
List all tables in the database
Execute a SQL query on the database
query_database lacks SQL injection warnings and parameter validation guidance. Description does not explain parameterized query syntax or security implications.
No output schemas documented for any tool. LLMs cannot predict response structure, forcing them to guess field names and types for downstream operations.
Parameter descriptions are minimal (10-20 chars) and lack format/constraint details. 'schema' parameter marked optional but no guidance on default behavior when omitted.
query_database tool description (40 chars) does not indicate it is a write-capable tool or explain when to use it vs. read-only tools. No idempotency or retry guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 41 | 2026-07-28+ | v2 |
No error handling guidance. Tool errors return raw database errors without recovery hints or actionable next steps for the LLM.