MCP Finanzas Chile
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Finanzas Chile
Servidor MCP (Model Context Protocol) que conecta una IA (opencode, Claude Desktop, Cursor…) con Excel (archivos .xlsx) para llevar la contabilidad de una empresa chilena: registras ingresos y gastos (a mano o importando las facturas del Registro de Compras y Ventas del SII) y la IA te entrega el Estado de Resultados (EERR) mensual y anual, lo que hay que pagar al SII (IVA/F29, PPM, retención de honorarios y renta anual) y los próximos vencimientos.
Los cálculos los hace código con pruebas, no el modelo: la IA entiende el pedido, llama a la herramienta y explica el resultado. Se validó contra un F29 real ya declarado de una pyme: el MCP calculó el mismo total que el SII, al peso.
Proyecto individual del examen "MCP para una herramienta de su computadora". Está construido sobre el mcp-starter-kit del curso (rama main).
⚠️ Son estimaciones con fines académicos. No reemplazan a un contador ni a la declaración oficial del SII. Revisa siempre las tasas vigentes en sii.cl.
¿Qué hace?
Antes (a mano) | Con el MCP |
Sumar facturas, separar IVA, armar el EERR y buscar qué se paga al SII en varias planillas | Le dices a la IA "calcula el EERR y lo que debo pagar de 2026" y lo hace sobre tu archivo Excel |
Revisar a mano qué facturas nuevas llegaron al SII | Descargas el CSV del RCV y la IA importa solo las nuevas y te avisa cuáles son |
Acordarse de cuándo vence el F29 | La IA lista lo que vence y crea recordatorios en tu Calendario |
Regímenes soportados: 14 A (general), 14 D N°3 (Pro Pyme general) y 14 D N°8 (Pro Pyme transparente).
Related MCP server: Excel MCP Server
Requisitos
Node.js 18 o superior (probado con 22) y npm.
Un cliente MCP: opencode, Claude Desktop, Cursor o similar.
Excel, LibreOffice o cualquier programa que abra
.xlsx(el servidor no necesita tener Excel abierto; cierra el archivo antes de escribir en él).
Instalación paso a paso
git clone https://github.com/TU-USUARIO/mcp-finanzas-chile.git
cd mcp-finanzas-chile
npm install
npm run build
npm test # debe terminar con: "Prueba de humo superada."
npm run demo # crea ejemplos/demo-empresa.xlsx con datos ficticiosEn Mac también puedes hacer doble clic en Iniciar.command (instala Node y opencode la primera vez) y después en Contador.command (compila y abre opencode con el MCP conectado).
Conectarlo a opencode
El repo ya trae opencode.json. Desde esta carpeta ejecuta opencode y listo. Si lo quieres en otra carpeta, agrega a tu opencode.json:
{
"mcp": {
"finanzas-chile": {
"type": "local",
"command": ["node", "/RUTA/COMPLETA/mcp-finanzas-chile/dist/index.js"],
"enabled": true
}
}
}Conectarlo a Claude Desktop
En claude_desktop_config.json:
{
"mcpServers": {
"finanzas-chile": {
"command": "node",
"args": ["/RUTA/COMPLETA/mcp-finanzas-chile/dist/index.js"]
}
}
}Reinicia el cliente. No hay claves, tokens ni variables de entorno que configurar.
Herramientas
13 herramientas de finanzas, en dos archivos (finanzas.ts: libro y cálculos; contabilidad.ts: rutina mensual), más 2 del starter kit.
Herramienta | Qué hace | Cambia el Excel |
| Crea el libro con las hojas Empresa (nombre, régimen) y Movimientos. No sobrescribe sin | Crea |
| Agrega las hojas Empresa y Movimientos a un Excel que ya tienes (p. ej. la planilla de un evento) sin tocar tus otras hojas. | Agrega 2 hojas |
| Copia gastos desde otra hoja (p. ej. Honorarios), convirtiendo líquido a bruto si corresponde. Primero simula ( | Agrega filas |
| Lee el CSV del Registro de Compras y Ventas descargado de Mi SII y agrega solo las facturas nuevas (no duplica). Avisa cuáles llegaron. | Agrega filas |
| Próximos vencimientos (F29 y renta) con días restantes y monto estimado. | No |
| Anota pagos hechos o pendientes (F29, giros, multas) en la hoja "Pagos registrados"; así no se avisa lo ya pagado. | Agrega/actualiza fila |
| Crea un | Crea archivo |
| EERR de cada mes del año; opcionalmente lo escribe en la hoja "EERR mensual". | Reemplaza 1 hoja |
| Agrega un ingreso o gasto; separa neto e IVA 19% según el documento. | Agrega fila |
| Lee la hoja y entrega totales, filas y advertencias de datos mal escritos. | No |
| Estado de Resultados (mes, año o todo el libro) con impuesto de 1ª categoría estimado. | No |
| F29 mensual (IVA, PPM, retención) con vencimiento + renta anual (F22) estimada. | No |
| Escribe las hojas EERR y Pagos SII en el mismo libro (pide | Reemplaza 2 hojas |
| Del kit: abre el Excel en la app del computador. | No |
Formato de la hoja Movimientos
Fecha (AAAA-MM-DD) · Tipo (ingreso/gasto) · Categoría · Descripción · Neto · IVA · Documento · Folio · RUT contraparte · Período IVA
Documento:
factura,boleta,honorarios,exentoosin_documento.Categorías con tratamiento especial:
costo_ventas(costo de ventas) yfinanciero(gastos financieros). El resto son gastos operacionales.Folio,RUT contraparteyPeríodo IVAson opcionales. El folio (p. ej.33-1234) evita duplicar facturas al importar el RCV.En la hoja Empresa, la fila
PPM %guarda la tasa de PPM que te propone el SII.Puedes escribir las filas a mano en Excel o pedirle a la IA que use
agregar_movimiento.
Ejemplos de uso (lo que le dices a la IA)
"Crea mi planilla en
~/Documentos/mi-empresa.xlsx, empresa Etéreo SpA, régimen 14D8.""Registra una venta con factura de $1.190.000 el 5 de noviembre."
"Registra un gasto de $600.000 en honorarios el 9 de noviembre."
"Calcula el EERR de 2026 de
ejemplos/demo-empresa.xlsx.""¿Cuánto tengo que pagar al SII por mes y cuándo vence?"
"Escribe el informe 2026 en el mismo Excel."
"Importa las compras de
ejemplos/rcv-compras-demo.csv" (CSV ficticio con el formato del RCV)."¿Qué vence en los próximos días?" y "ya pagué el F29 de octubre, $850.000".
"Dame el estado de resultados mes a mes de 2026."
Rutina mensual (llevar la contabilidad al día)
En Mi SII (sii.cl) entra a Registro de Compras y Ventas y descarga el detalle en CSV de compras y de ventas del mes.
Pídele a la IA: "importa las compras de este CSV" y luego las ventas. Te avisa las facturas nuevas.
Clasifica las compras nuevas y registra los gastos sin factura.
Pídele el EERR del mes y los próximos pagos.
Una vez: "genera el calendario de pagos" y abre el
.icspara recibir alarmas en tu Calendario.
Importante: el MCP no se conecta directamente al SII. El SII no ofrece una API abierta para empresas pequeñas, y automatizar el ingreso a Mi SII exigiría guardar la clave tributaria, lo que es un riesgo de seguridad. Por eso trabaja con el CSV que descargas tú. Tampoco envía notificaciones por sí solo: los recordatorios salen del calendario .ics.
Cómo calcula (resumen)
IVA mensual = IVA débito (ventas) − IVA crédito (compras con factura) − remanente del mes anterior. Si da negativo, queda como remanente.
PPM = tasa × ingresos netos del mes (14 D N°3: 0,125%; 14 D N°8: 0,1%; 14 A: 1% de referencia). Si el SII te propone otra tasa, escríbela en la fila
PPM %de la hoja Empresa.Período de IVA: si el SII incluye una factura en un mes distinto al de su fecha (acuse de recibo, Pendientes), indícalo en la columna
Período IVA(AAAA-MM).Retención de honorarios: 15,25% del bruto en 2026 (16% en 2027, 17% desde 2028).
Impuesto de 1ª categoría: 14 A 27% (2026) / 25,5% (2027); 14 D N°3 12,5% (transitorio); 14 D N°8 no paga: la base se atribuye a los dueños (IGC).
Los gastos
sin_documentono dan crédito de IVA ni se aceptan como gasto tributario.F29 vence el día 20 del mes siguiente (declaración por internet), movido a lunes si cae en fin de semana. No considera feriados.
Seguridad y límites
Ver docs/entrega/03-declaracion-ia-limites-seguridad.md. En corto: solo abre los archivos .xlsx, .csv e .ics que tú indiques, no usa red ni claves, no se conecta al SII, pide confirmación antes de sobrescribir y el repo no contiene datos reales (el Excel de ejemplo es ficticio).
Pruebas
npm test compila, corre 20 pruebas unitarias (valores calculados a mano, incluido un caso que reproduce un F29 real) y la prueba de humo que arranca el servidor MCP y recorre las herramientas sobre un Excel temporal: crea el libro, registra movimientos, calcula EERR e IVA, importa el RCV dos veces sin duplicar, lista próximos pagos, crea el calendario y el EERR mensual.
Estructura
src/index.ts servidor MCP (carga src/tools/*)
src/tools/finanzas.ts libro Excel, EERR y pagos SII (8 herramientas)
src/tools/contabilidad.ts RCV, próximos pagos, pagos registrados, calendario, EERR mensual (5)
src/tools/aplicaciones.ts del starter kit: listar y abrir apps
src/lib/tributario.ts motor tributario (funciones puras y parámetros editables)
src/lib/excel.ts lectura/escritura del .xlsx
src/lib/rcv.ts lector del CSV del Registro de Compras y Ventas
ejemplos/ Excel y CSV ficticios para probar
tests/ pruebas unitarias
scripts/ prueba de humo y generador de datos de ejemplo
docs/entrega/ documentos del examenLicencia
MIT (heredada del starter kit).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Chilean DTE/SII invoicing — issue invoices, reconcile payments and manage clients with AI agents.
The Excel engine for AI agents: read, check and edit Excel models over MCP.
Chile DTE for AI agents - boleta/factura electronica via OpenFactura or LibreDTE. Stateless BYO.
Intelligent ledger for your assistant: sorted transactions, bills, source-cited tax, BAS/VAT prep.
1
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables comprehensive Excel operations and financial calculations including investment analysis, rental property management, expense tracking, and automated financial reporting. Supports creating Excel workbooks with advanced financial formulas, cash flow projections, and tax calculations for accounting and finance workflows.1005MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create, read, write, and manipulate Excel files (.xlsx, .xlsm) without requiring Microsoft Excel, including support for charts, pivot tables, data import/export, and professional formatting across Windows, macOS, and Linux.143 npm35MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to perform Excel file operations (create, read, write, format) without requiring Microsoft Excel installation.175MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to read, write, format, and analyze Excel files with 34 tools, including real-time editing on macOS with Microsoft Excel.3417MIT