# Otras operaciones

> Contextos (assignments), diagnóstico de credenciales, listado de cuentas, saldo de una cuenta y estado de una solicitud de estado de cuenta, en una sola página.

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

> 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.

### Contextos (assignments) [#baas-list-assignments]

- `baas_list_assignments`
- Acceso: Sólo lectura

Lista los contextos tenant/cuenta (assignments) disponibles para las credenciales del API bancario del usuario. Úsalo cuando otra herramienta pida assignmentId.

**Parámetros**

Sin parámetros.

**Devuelve**

`{ assignments[] }`

assignments = contextos disponibles con assignment_id, tenant_code, owner_type, country_code y status.

### Diagnóstico [#baas-diagnostics]

- `baas_diagnostics`
- Acceso: Sólo lectura

Verifica las credenciales del API bancario del usuario, el login, el intercambio de token y el acceso a cuentas. Úsalo cuando una consulta falle.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `assignmentId` | string | — | Contexto (assignment) del API bancario; se envía sólo cuando hay varios |

**Devuelve**

`{ checks[], failed }`

checks = una fila por verificación (credenciales, login + assignments, cuentas) con ok y detalle; failed = cuántas fallaron. El correo de la credencial se devuelve enmascarado.

### Listar cuentas [#baas-list-accounts]

- `baas_list_accounts`
- Acceso: Sólo lectura
- Operación del API: `GET /api/public/v1/accounts` — https://www.tilopay.com/developers/api-bancario/cuentas

Lista las cuentas accesibles del API bancario, sin saldos: tipo de identificador, valor y moneda.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `accountType` | string | — | Filtro por esquema (IBAN) |
| `accountValue` | string | — | Filtro por identificador |
| `limit` | integer | — | Tamaño de página, entre 1 y 100 |
| `cursor` | string | — | Cursor de la página anterior |
| `assignmentId` | string | — | Contexto (assignment) del API bancario; se envía sólo cuando hay varios |

**Devuelve**

`{ result }`

result = respuesta del API bancario tal cual.

### Saldo de una cuenta [#baas-get-balance]

- `baas_get_balance`
- Acceso: Sólo lectura
- Operación del API: `GET /api/public/v1/accounts/balance` — https://www.tilopay.com/developers/api-bancario/cuentas

Obtiene el saldo actual de una cuenta del API bancario identificada por IBAN.

**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) |
| `assignmentId` | string | — | Contexto (assignment) del API bancario; se envía sólo cuando hay varios |

**Devuelve**

`{ result }`

result = respuesta del API bancario tal cual.

### Estado de la solicitud de estado de cuenta [#baas-get-statement-status]

- `baas_get_statement_status`
- Acceso: Sólo lectura
- Operación del API: `GET /api/public/v1/accounts/statements/{request_id}` — https://www.tilopay.com/developers/api-bancario/cuentas

Consulta el estado de una solicitud de estado de cuenta. Cuando está DONE incluye el enlace de descarga firmado y su vencimiento.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `requestId` | string | sí | request_id devuelto al solicitar el estado de cuenta |
| `assignmentId` | string | — | Contexto (assignment) del API bancario; se envía sólo cuando hay varios |

**Devuelve**

`{ result }`

result = respuesta del API bancario tal cual.