Loading ToolBench

Reading the current corpus…

cuadra MCP server · D · ToolBench

cuadra

MCP server for financial statement ingestion, reconciliation, and audit management. Exposes tools for importing bank statements (PDF/CSV/XLSX), categorizing transactions, applying corrections, and managing the canonical finance database.

<=2025-11-25STDIO14 tools

50/100

Definition Quality64

Protocol Readiness32

Supportability38

Spec posture

Inferred effective spec <=2025-11-25·current baseline 2026-07-28

Static source inference · medium confidence · detected: Logging

Deprecated protocol patterns detected

Summary

Server has 14 well-structured tools with explicit schemas and descriptions. Naming follows verb_noun convention (finance_*). Descriptions are present and contextual (avg ~80 chars), exceeding the 20-char minimum. All tools have JSON Schema with type and required fields. However, parameter descriptions are MISSING, the schema shows property names but no 'description' field for individual parameters. This is a critical gap: LLMs cannot infer what 'period', 'run_id', 'confirm', or 'reason' mean without explicit descriptions. Error handling is present (MCPError class, confirm gates on destructive ops) but recovery guidance is minimal. Output schemas are not documented. Security is strong (path validation, account masking, audit logging via actor field), but parameter descriptions would elevate this to 75+.

Tools (14)

finance_apply_correctionswritesource verified60/100

Aplica correcciones de categoría/tipo/review_status al staging (auditadas).

finance_approvewritesource verified63/100

Aprueba un statement REVIEW_REQUIRED (bloqueos blandos) con razón auditada.

finance_audit_monthread onlysource verified63/100

Cobertura y conciliación de un mes (YYYY-MM).

finance_close_monthirreversiblesource verified63/100

Marca un mes como cerrado de forma persistente y auditable.

finance_commit_importirreversiblesource verified67/100

Incorpora atómicamente un run a la base. REQUIERE confirm=true.

finance_get_review_queueread onlysource verified65/100

Statements de un run que requieren revisión/aprobación y por qué.

finance_get_runread onlysource verified63/100

Manifiesto de un run de staging (cuentas enmascaradas, sin texto original).

Issues (5)

CRITICALtool-description ↗

Parameter descriptions missing from all 14 tools. Schema defines properties (path, period, run_id, confirm, reason, etc.) but no 'description' field for each parameter. LLMs cannot infer what 'period' means (date range? fiscal period? string format?) or when 'confirm' is required without explicit text.

finance_preview_importfinance_ingest_statementfinance_get_runfinance_get_review_queuefinance_apply_correctionsfinance_approvefinance_commit_importfinance_rollback_importfinance_audit_monthfinance_close_monthfinance_resolve_quarantine

HIGHresponse-shaper ↗

Output schemas not documented. Tools return complex objects (manifest, review_queue, corrections log) but no schema is provided to LLMs. Agents cannot plan downstream calls or extract fields reliably.

finance_get_runfinance_get_review_queuefinance_apply_correctionsfinance_approvefinance_commit_importfinance_rollback_importfinance_audit_month

Recommendations

Add 'description' field to every parameter in all 14 tool schemas. E.g., for finance_preview_import: 'path': {'type': 'string', 'description': 'Relative path to file or folder within statements/ (e.g., inbox/statement.pdf or inbox). Must be within project root.'}, 'period': {'type': ['string', 'null'], 'description': 'Optional fiscal period (YYYY-MM format) to assign to imported transactions. If omitted, inferred from statement date.'}
Document output schemas for all tools. E.g., finance_get_run returns {'type': 'object', 'properties': {'run_id': {'type': 'string'}, 'statements': {'type': 'array', 'items': {...}}, 'created_at': {'type': 'string', 'format': 'date-time'}}}. Include this in tool registration or a separate schema map.
Enhance error messages with recovery hints. E.g., MCPError('run not found: {run_id}. Call finance_list_inbox() to see available runs, or finance_preview_import() to create a new one.') instead of bare 'run no encontrado'.
Add confirm=true gate to finance_close_month for consistency with other irreversible operations. Closing a month is a permanent audit action and should require explicit confirmation.
Remove finance_ingest_statement alias or clearly document it as a deprecated alias. If both must exist, add a note in descriptions: 'Alias of finance_preview_import (identical behavior). Use finance_preview_import instead.' Consolidate to one canonical name to reduce LLM confusion.

Spec posture evidence

Inferred effective spec: <=2025-11-25.

Relies on Logging (deprecated) - log to stderr or use OpenTelemetry

Score history

Overall score trend

First recorded score · v2 rubric

50/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	D	50	<=2025-11-25	v2