> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finzaria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Herramientas del MCP

> Las acciones que un agente puede ejecutar sobre tu cuenta de Finzaria.

Cada herramienta corresponde a una operación de la [API `/v1`](/referencia); los permisos son los
mismos que los de tu credencial ([`read_only` no puede crear/editar](/guias/autenticacion/scopes)).

### Lectura

| Herramienta                   | Qué hace                                                            |
| ----------------------------- | ------------------------------------------------------------------- |
| `list_accounts`               | Lista tus cuentas con su saldo.                                     |
| `list_transactions`           | Lista transacciones con filtros (cuenta, categoría, fechas, texto). |
| `list_categories`             | Lista tus categorías.                                               |
| `list_budgets`                | Presupuestos del periodo con gasto y disponible.                    |
| `list_iou_balances`           | Posición neta de deudas por contacto.                               |
| `list_repeating_transactions` | Reglas recurrentes con su próximo vencimiento.                      |
| `get_spending_report`         | Gasto por categoría en un periodo.                                  |
| `list_rules`                  | Reglas de auto-categorización.                                      |

### Escritura

| Herramienta                    | Qué hace                                                     |
| ------------------------------ | ------------------------------------------------------------ |
| `create_transaction`           | Registra una transacción (gasto, ingreso, traspaso, deuda…). |
| `update_transaction`           | Edita una transacción.                                       |
| `delete_transaction`           | Manda una transacción a la papelera.                         |
| `create_repeating_transaction` | Crea una regla recurrente.                                   |
| `create_rule`                  | Crea una regla de auto-categorización.                       |
| `delete_rule`                  | Elimina una regla.                                           |

<Note>
  Los errores llegan al agente en [`problem+json`](/guias/referencia-transversal/errores) con un
  `detail` accionable, así el agente puede corregirse solo (p. ej. pedir un `accountId` válido) y
  reintentar.
</Note>

## Ejemplos de prompts

* *"Registra un gasto de \$150 en comida de hoy en mi cuenta de BBVA."*
* *"¿Cuánto llevo gastado este mes por categoría?"*
* *"Crea un presupuesto de \$6,000 al mes para comida."*
* *"¿Quién me debe dinero y cuánto?"*