# Analista de pagos del API bancario

> Analiza, sólo lectura, los pagos de una cuenta en un rango de fechas y devuelve un informe en lenguaje natural: éxito, fallas, reversiones, montos netos y recomendaciones. Usa un modelo de lenguaje sobre las cifras calculadas.

- kind: mcp-tool
- status: stable
- access: read
- last_verified: 2026-09-03
- url: https://www.tilopay.com/developers/agentes/mcp/api-bancario/analyze-payments

> Estas herramientas se activan bajo solicitud y sólo funcionan para usuarios con credenciales del API bancario de Tilopay. No forman parte del acceso MCP por defecto: Tilopay habilita el grupo caso por caso. Requiere: Credenciales del API bancario de Tilopay registradas por Tilopay para ese usuario.

- `baas_analyze_payments`
- Acceso: Sólo lectura

Analiza, sólo lectura, los pagos de una cuenta en un rango de fechas y devuelve un informe en lenguaje natural: éxito, fallas, reversiones, montos netos y recomendaciones. Usa un modelo de lenguaje sobre las cifras calculadas.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `accountType` | string (IBAN) | — | Esquema del identificador de la cuenta (IBAN) |
| `accountValue` | string | sí | Identificador de la cuenta (IBAN) |
| `dateFrom` | string | sí | Desde, RFC 3339 |
| `dateTo` | string | sí | Hasta, RFC 3339 |
| `currency` | string | — | Moneda ISO 4217 |
| `direction` | string (OUT | IN) | — | OUT = envío, IN = recibido |
| `question` | string | — | Enfoque específico del análisis |
| `maxItems` | integer | — | Máximo de pagos a analizar, entre 1 y 1000 (por defecto 300) |
| `assignmentId` | string | — | Contexto (assignment) del API bancario; se envía sólo cuando hay varios |

**Devuelve**

`{ summary }`

summary trae account, range, totals {count, succeeded, failed, reversed, pending, successRate}, byCurrency con succeededAmount, reversedAmount, netAmount y averageTicket, failureReasons y sample. El informe redactado viene en el texto. Si no hay pagos en el rango, avisa y no analiza.