Servidor MCP de solo lectura para la API de Interbanking (Argentina) - consulta saldos y movimientos bancarios desde tu agente
Server has 4 read-only tools with consistent naming (verb_noun pattern: listar_, saldos, saldos_historicos, movimientos). All tools have descriptions (194 - 280 chars, within baseline 34 - 392 range) and tool annotations (readOnlyHint, destructiveHint, idempotentHint). However, input schemas are incomplete: listar_cuentas has empty schema ({}), and saldos/movimientos schemas are inferred from package.json rather than visible in server.js code. Parameter descriptions exist but lack format guidance (e.g., 'Fecha desde' doesn't explain YYYY-MM-DD constraint in description text, only in regex). Output schemas are undocumented, LLMs cannot predict response structure. Error handling returns user-friendly messages but lacks recovery guidance or error classification.
Lista las cuentas bancarias disponibles con su banco, tipo, moneda y numero. Util como primer paso para saber que cuentas existen antes de pedir movimientos.
Movimientos de todas las cuentas en un rango de fechas. Descubre las cuentas solo. Por defecto devuelve un resumen (totales por cuenta y los 25 mas recientes); pedir detalle solo para rangos cortos, porque un rango largo son miles de registros.
Saldos actuales de todas las cuentas: contable, operativo y proyectado. Acepta un rango de fechas opcional de hasta 64 dias; para rangos mas largos usar saldos_historicos.
Saldos diarios en un rango de fechas largo. Parte el rango automaticamente en tramos de 60 dias porque la API no acepta mas de 64 por consulta, y devuelve la serie unificada. Devuelve un resumen por cuenta; usar detalle para la serie dia por dia.
listar_cuentas has empty input schema ({}). Tool is functional but LLMs cannot validate inputs or understand parameter expectations.
Output schemas are completely undocumented. LLMs cannot predict response structure (fields, types, pagination). Baseline: 100% of A+ tools have documented return types.
Parameter descriptions lack explicit format/constraint guidance. 'Fecha desde (YYYY-MM-DD), opcional' states format in parentheses but not in description text. Regex pattern exists in schema but LLMs cannot read JSON Schema, they rely on description text.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
Error handling returns user-friendly messages but lacks recovery guidance or error classification. Per pattern:recovery-guide, errors should tell LLM what to do next (retry, ask user, or fatal). Current errors are bare messages without actionable next steps.
Tool definitions for saldos and movimientos are inferred from package.json (file listing) rather than visible in server.js code.