Funciones

avenir-mcp da a un agente 25 herramientas, 4 recursos y 4 prompts sobre sus planes de YNAB. Esta página los lista según lo que quiera hacer. Cada fila da una frase que puede decir al agente; el agente elige la herramienta.

Nota

L = solo lectura, siempre disponible. E = escritura, disponible con AVENIR_MCP_WRITE=1, previsualizada y confirmada. ↺ = se puede deshacer con undo_operation.

¿Plan o presupuesto?

YNAB llama ahora plan a un presupuesto, y también las herramientas de avenir-mcp (list_plans, plan_id). Diga la palabra que prefiera: el agente entiende ambas y le responde con la suya. «Mi presupuesto de restaurantes» sigue siendo el importe asignado a esa categoría.

Echar un vistazo

Usted dice	Herramienta
«¿Qué planes tengo?»	list_plans	L
«¿Qué hay en mis cuentas?»	list_accounts	L
«¿Por qué no llegan mis movimientos bancarios?»	list_accounts — la conexión bancaria de cada cuenta (activa, con error, ninguna) y su última conciliación	L
«¿Qué grupos de categorías existen?»	list_category_groups	L
«¿Qué transacción es mi ticket de 86,40 del día 12?»	find_transactions — por fechas, importe exacto y cuenta, con categoría o sin ella	L
«¿Qué hizo que Restaurantes se pasara este mes?»	find_transactions — por categoría, líneas divididas incluidas, o por beneficiario, sea cual sea la etiqueta bancaria	L
«¿Qué facturas vencen antes del día 10?»	list_scheduled_transactions — las transacciones programadas repetidas según su frecuencia, con el dinero que entra y sale	L
«¿A qué estoy suscrito y cuánto me cuesta al año?»	find_recurring_charges — los gastos vistos casi todos los meses, los más caros del año primero	L

Los planes, cuentas y categorías también se sirven como recursos que su cliente puede adjuntar a una conversación sin llamar a una herramienta.

Entender un mes

Usted dice	Herramienta
«¿Cómo va septiembre?»	get_monthly_summary — ingresos, presupuestado, gastado, Ready to Assign, categorías excedidas	L
«Muéstrame todas las categorías.»	get_category_balances — presupuestado, gastado y disponible por categoría	L
«¿Qué presupuestos están casi agotados?»	get_budget_vs_actual — parte consumida de cada presupuesto	L
«¿El gasto en Restaurantes es alto todos los meses?»	get_spending_trends — gasto por categoría durante N meses	L

Guía: Revisar un mes.

Clasificar transacciones

Usted dice	Herramienta
«Trae las últimas transacciones de mi banco.»	import_transactions — lo que hace Import en YNAB, aplicado al momento	E
«¿Qué queda sin categoría?»	suggest_categories — transacciones pendientes, con una sugerencia cuando su historial es claro	L
«Sí, aplícalo.»	apply_categories — un lote confirmado	E ↺
«Marca con una bandera las que debo revisar en YNAB.»	flag_transactions — una bandera de color, para mirar en YNAB	E ↺
«Divide este ticket: 81,15 en comida, 5,25 en hogar.»	split_transaction — una transacción en varias categorías; se deshace en YNAB, no aquí	E
«Márcalas como revisadas.»	approve_transactions — quita la marca unapproved de YNAB	E

Las sugerencias reconocen un comercio a través de sus etiquetas bancarias (CB MARKET FRESH FACT 050926 525130******1 y … 190926 … son la misma tienda), aprenden por separado entradas y salidas de dinero, y nunca apuntan a una categoría oculta. Guía: Clasificar transacciones pendientes. Cómo funciona: Sugerencias.

Comprobar con el banco

Usted dice	Herramienta
«Mi banco muestra 3.440,80. ¿Coincide YNAB?»	reconcile_account — explica una diferencia sin escribir; concilia cuando cuadra	E ↺
«Añade el pago de la farmacia que faltó en la importación.»	create_transactions	E ↺

Una diferencia se explica por las transacciones pendientes, la que tiene exactamente el importe de la diferencia, y los probables duplicados (mismo importe y comercio, a 3 días como mucho). Guías: Conciliar una cuenta, Añadir transacciones que faltan.

Planificar

Usted dice	Herramienta
«¿Bajaré de cero antes de diciembre?»	forecast_balance — mes a mes, con sus supuestos	L
«Pon 150 en Restaurantes para septiembre.»	set_category_budget	E ↺
«Mueve 30 de Tenis a Restaurantes.»	move_money — las dos categorías en una confirmación	E ↺

La previsión coloca las transacciones programadas de YNAB en sus fechas, encuentra los cargos recurrentes en su historial, promedia el resto y le deja indicar sus ingresos e importes puntuales. Guía: Planificar. Cómo funciona: Previsión.

Organizar categorías

Usted dice	Herramienta
«Crea una categoría Mascotas en el grupo Día a día.»	create_category	E
«Cambia el nombre de Tenis a Deporte.»	update_category — también mueve una categoría a otro grupo	E
«Ahorra 1.200 para las vacaciones antes de junio de 2027.»	set_category_target — un importe para una fecha, o cada mes, semana o año	E ↺

Guía: Organizar categorías.

Deshacer

Usted dice	Herramienta
«Deshaz eso.»	undo_operation — la última operación, o la indicada	E

Guía: Deshacer un cambio. Cómo funciona: Diario y deshacer.

Flujos de trabajo listos para usar

Cuatro prompts guían al agente por una tarea completa. En Claude Code son comandos slash del servidor avenir-mcp.

Prompt	Argumentos	Qué hace
classify_pending	plan	sugerencias, sus elecciones, un lote confirmado, el id para deshacer
monthly_review	plan, mes	totales, lo que destaca, correcciones propuestas
reconcile	plan, cuenta, saldo bancario	la diferencia explicada, luego una conciliación confirmada
plan_next_month	plan	previsión y supuestos, luego los importes del mes siguiente

De serie

• Seguridad: solo lectura por defecto, confirmación ligada a la vista previa exacta, un diario local para deshacer, texto bancario tratado como no fiable. Vea Seguridad por diseño.
• Economía: una copia local de sus transacciones actualizada por sincronización incremental; la mayoría de las herramientas cuestan una o dos peticiones a YNAB. Vea Datos y sincronización.
• Claridad para agentes: unidades monetarias, esquemas de salida tipados con una descripción por campo, paginación, errores útiles.
• Protocolo: MCP 2026-07-28 y versiones anteriores; stdio o HTTP streamable.