Revisa antes de registrar
Comprueba primero el resumen actual; los registros de ledger contienen datos financieros y una entrada duplicada es más difícil de interpretar que una ausente.
ledger({ action: "summary", months: 1 })Herramienta MCP pública
ledger
Propósito
Gestiona transacciones financieras gobernadas y recordatorios de renovación de servicios externos mediante el dispatcher de Ledger, con resúmenes estructurados y límites de auditoría.
Cuándo usar
- Registra un gasto u otra transacción admitida con importe, moneda, fecha y contexto del comercio.
- Enumera, resume o consulta registros de Ledger autorizados mediante filtros de fecha, categoría, moneda o proyecto.
- Crea o gestiona recordatorios de renovación de suscripciones y, opcionalmente, conecta su ciclo de revisión con TODOs.
Cuándo NO usar
- No uses remember genérico para registros financieros; ledger conserva el contrato de datos financieros.
- No infieras un total entre monedas; los resúmenes mantienen separadas las monedas cuando la agregación no es segura.
- No actualices ni elimines un registro sin el ID/versión exactos requeridos y la autorización del usuario.
- La API REST acepta un conjunto de campos más amplio que la herramienta MCP pública; consulta /docs/api/memory para los filtros de scope, bucket, team y provenance.
Ámbito requerido
- Se requiere memory:read para las acciones de lectura; las mutaciones de transacciones y suscripciones requieren memory:write en la superficie de chat pública.
- El límite de propietario/equipo/scope autenticado rige cada operación de registro y recordatorio de Ledger.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
action | add_expense | list | summary | overview | update_transaction · obligatorio | Operación de Ledger seleccionada por el caller. Solo se aceptan estos cinco valores literales. |
item / amount / transaction_type / currency | string / number | Campos principales de la transacción; amount y currency son obligatorios para las escrituras financieras. |
transaction_date / category / merchant / payment_method / note | string | Campos opcionales de clasificación, fecha y nota de la transacción. |
query / date_from / date_to / min_amount / max_amount | string / number | Filtros de lista y resumen. |
transaction_id / expected_version / patch | string / integer / object | Objetivo exacto de actualización, versión de concurrencia optimista y campos de actualización permitidos. |
owner_timezone / project_id | string | Interpretación de fechas y límite de proyecto/equipo autorizado. |
limit / offset / months | integer / boolean · predeterminado: 20 / 0 / 6 / false | Paginación, horizonte del resumen y controles de salida estructurada. |
Esquema de retorno
La salida estructurada contiene la transacción solicitada, grupos de resumen u overview, además de un resumen textual para el usuario. Los callers de widgets pueden recibir metadatos de actualización; los secretos sin procesar nunca forman parte del contrato de respuesta.
Ejemplos
ledger({
action: "add_expense",
item: "Domain renewal",
amount: 18.00,
currency: "USD",
transaction_date: "2026-08-21",
category: "software"
})ledger({ action: "summary", months: 1 })Errores
- Authorization failure: el token carece de memory:read para lecturas o de memory:write para mutaciones.
- Validation failure: los campos de transacción obligatorios, los formatos de fecha, la moneda o los valores de action no son válidos.
- Concurrency failure: una actualización tiene un expected_version obsoleto o no se encuentra la transacción exacta.
- Aggregation boundary: los registros en distintas monedas se informan por separado en lugar de producir un total combinado falso.
Herramientas relacionadas
Fuente: Superficie de herramientas MCP