Listar cuentas bancarias

Herramienta MCP: banks_getBanks.

Lista las cuentas bancarias y de caja de la compañía con filtros opcionales y paginación.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "banks_getBanks",
    "arguments": { "limit": 10 }
  }
}

Soporta paginación con start y limit (hasta 30 por página), orden con order_field (id o date) y order_direction (ASC o DESC), búsqueda por texto con query o name, y filtros por status (active o inactive) y type (bank, cash, credit-card, foreign-account).

Con metadata: true (valor por defecto) la respuesta es { metadata: { total }, data: [...] } e incluye el total de cuentas; con includeBalance: true añade el saldo de cada cuenta y con includeInactive: true incluye las cuentas inactivas. Con fields puedes ampliar cada cuenta con información adicional separada por comas (deletable, journal, lastMovementDate, category).

Úsala para descubrir los id de las cuentas que necesitan banks_getBanksById, banks_getReconciliations o banks_getTransactions. Para buscar una cuenta por su nombre exacto, usa banks_getBanksByName.

Notas por país: el tipo foreign-account (cuenta en moneda extranjera) solo está disponible en México; en el resto de países type acepta únicamente bank, cash y credit-card.

Solo lectura.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum

Campos adicionales a incluir en la respuesta: deletable, journal, lastMovementDate o category.

Allowed:
boolean

Incluye el saldo de cada cuenta bancaria.

boolean

Incluye las cuentas inactivas.

integer
1 to 30

Cantidad de cuentas a consultar. Máximo 30.

boolean
Defaults to true

Si es true (valor por defecto), la respuesta es { metadata: { total }, data: [...] } e incluye el total de cuentas.

string

Filtra por nombre del banco o de la cuenta.

string
enum

Dirección del orden: ASC (ascendente) o DESC (descendente).

Allowed:
string
enum

Campo por el cual se ordenan los resultados: id o date.

Allowed:
string

Texto libre para buscar cuentas.

integer
≥ 0

A partir de cuál cuenta se desea consultar (0 para la primera página).

string
enum

Filtra por estado de la cuenta: active o inactive.

Allowed:
string
enum

Filtra por tipo de cuenta: bank, cash, credit-card o foreign-account. El tipo foreign-account solo aplica en México.

Allowed:
Responses

401

No autorizado (token de Alegra inválido o expirado).

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json