ALalegra
Banks

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.

post/tools/banks_getBanks

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/banks_getBanks
  • Auth
    HTTP bearer

Request body

fields'deletable' | 'journal' | 'lastMovementDate' | 'category'

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

includeBalanceboolean

Incluye el saldo de cada cuenta bancaria.

includeInactiveboolean

Incluye las cuentas inactivas.

limitinteger

Cantidad de cuentas a consultar. Máximo 30.

metadataboolean

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

namestring

Filtra por nombre del banco o de la cuenta.

order_direction'ASC' | 'DESC'

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

order_field'id' | 'date'

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

querystring

Texto libre para buscar cuentas.

startinteger

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

status'active' | 'inactive'

Filtra por estado de la cuenta: active o inactive.

type'bank' | 'cash' | 'credit-card' | 'foreign-account'

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

Response

Lista de cuentas bancarias

Changes

No recorded changes to this operation across all 1 revision of this API.