mi-sii-mcp

io.github.Taksuma-0Published by GitHub account Taksuma-0v0.3.1Updated Nov 7, 2026

Servidor MCP para el SII de Chile: IVA, F29, F22 y boletas de honorarios. Solo lectura y local.

VerifiedSTDIODesktop onlyDatabasesFinanceData & Analytics

Overview

AI-generated overview

Local MCP server that reads a Chilean SII taxpayer's IVA, F29, F22 and honorarios data, stores it on your machine and reconciles it for an AI assistant.

What you can do
  • List configured taxpayer accounts and their session state, and open a local page to connect an account
  • Sync RCV purchases and sales, F29 filings, F22 income tax, honorarios receipts and taxpayer profile from the SII
  • Review IVA reconciliation, F29 history, deadlines, RCV documents and Mi SII notices
  • Estimate F29 and F22 before filing, and project the year-end close
  • Import bank statements, reconcile them, and build chart of accounts, ledgers, journal entries and income statements
  • Query the local data with read-only SQL, produce HTML reports, and list legal tax-saving opportunities and regime simulations
When to use it
Useful for Chilean taxpayers and accountants who want to ask an assistant about their own IVA, F29, renta and honorarios without copying data from the SII portal, and who want reconciliation, deadline alerts and pre-filing estimates kept on their own machine.
Requirements
Runs locally over stdio via npx, so Node.js 22.12 or higher is needed, plus an MCP client that launches local servers. A SII taxpayer account with its tax key (or ClaveÚnica) is required; login happens in a local page or terminal, not through the assistant. Optional environment variable MI_SII_MCP_HOME sets the data folder (default ~/.mi-sii-mcp). Windows is the tested platform.
Before you install
It stores SII session cookies and, if you choose to stay connected, your tax key in the system credential store, and keeps taxpayer data in a local SQLite database. Everything you ask about is passed into the chat and therefore to your AI provider. It only reads the SII and never files or modifies anything, but its estimates and accounting entries are not official SII output or tax advice and should be reviewed with an accountant.

Installation

In SourceWeft

  1. Open mi-sii-mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Logo de mi-sii-mcp]

mi-sii-mcp — Servidor MCP para el SII de Chile

Tus impuestos del SII, conversados con tu asistente de IA.

[Pruebas en Windows, macOS y Linux] [Versión en npm] [Publicado en el MCP Registry oficial] [Licencia MIT] [Open source] [Node.js 22.12 o superior] [Model Context Protocol] [Solo lectura]

[mi-sii-mcp en Glama: puntuación del servidor MCP] [Listado en mcpservers.org] [Colaborador en XERJ Corpus Hub]

Sitio web · Instalación · Compatibilidad · Ejemplos · Preguntas frecuentes · Guía completa · English

mi-sii-mcp es un servidor Model Context Protocol (MCP) de código abierto que conecta asistentes de inteligencia artificial —Claude, Codex, Gemini CLI, Grok, Cursor, VS Code con Copilot y otros clientes MCP— con tu información tributaria del Servicio de Impuestos Internos (SII) de Chile. Lee tu IVA, tus F29, tu renta (F22), tus boletas de honorarios, lo que otros informan sobre ti y tus anotaciones en Mi SII; lo guarda en tu equipo y lo concilia para mostrarte qué cuadra, qué no y qué vence. Además estima el F29 y la renta antes de declarar, concilia tus cartolas del banco, arma libros y asientos para tu contador, te avisa cada día solo si algo requiere atención y muestra las formas legales de pagar menos, con su norma. Funciona en solo lectura frente al SII y el asistente nunca recibe tu clave.

[!NOTE] Proyecto independiente de código abierto: no está afiliado al SII ni reemplaza la asesoría de un contador. Úsalo para revisar tu información y tomar mejores decisiones.

[Demostración con datos ficticios: el asistente consulta mi-sii-mcp y responde cuánto se ha retenido en boletas de honorarios, por pagador, y que cuadra con lo informado al SII]


Características principales

  • Consultas tributarias en lenguaje natural: pregúntale a tu asistente por tu IVA, tus F29, tu renta o tus boletas de honorarios, con tus datos reales del SII.
  • Conciliación automática: cruza el registro de compras y ventas con el F29, las boletas con la renta y lo que informan tus pagadores con tus propios registros.
  • Alertas útiles: F29 sin presentar o por vencer (día 12, 20 o 28 según tu caso), facturas por reclamar, descuadres y anotaciones vigentes del SII.
  • F29 y renta estimados: calcula el F29 del mes (débito, crédito, remanente, PPM y retenciones) y el F22 de una persona antes de declararlos, y los compara con lo presentado.
  • Banco y contabilidad: importa cartolas en CSV de cualquier banco, las concilia con facturas, boletas e impuestos, y arma libros, asientos y el resultado del período, exportables a Excel.
  • Revisión diaria: con un clic en la página local, revisa todas tus cuentas cada día y te avisa con una notificación de Windows solo cuando hay algo nuevo.
  • Ahorro tributario legal: oportunidades que tus datos sostienen (crédito de IVA por usar, postergación del IVA, gastos efectivos, APV), cada una con su norma y la página oficial; simula el régimen Pro Pyme y proyecta el cierre del año.
  • Cartera: para quien lleva varias empresas, una vista de qué cuenta necesita atención.
  • Se adapta a los cambios del SII: nota cuando el SII cambia sus respuestas; si renombra un monto, lo encuentra solo comprobándolo al peso con los totales del propio SII; si no puede comprobarlo, se detiene antes de guardar datos malos y avisa. Con diagnostico ves su salud.
  • Resiliente: si el SII no responde, se detiene en vez de insistir; si la sesión vence a mitad de camino y guardaste la clave, entra de nuevo sola; lo que falló se reintenta en la revisión diaria; la base se respalda cada día.
  • Respuestas livianas: JSON compacto y versiones resumidas por defecto (detalle: true trae todo), para que el asistente responda más rápido.
  • Solo lectura: nunca presenta, modifica ni emite nada en el SII.
  • Datos locales: todo se guarda en una base SQLite en tu equipo; no hay servidores intermedios.
  • La clave no pasa por el chat: inicias sesión en una página local y ninguna herramienta del MCP recibe claves.
  • Varias cuentas: tu RUT personal y los de tus empresas, cada uno con su propia sesión.
  • Open source (MIT), escrito en TypeScript, con más de 1.600 pruebas automáticas que usan solo datos ficticios.

Qué lee del SII y qué concilia

ÁreaQué trae del SIIQué concilia
IVARegistro de Compras y Ventas (RCV), F29 presentados (con su PDF) y propuesta de F29IVA del RCV contra el F29, F29 faltantes, facturas por reclamar y coherencia interna del F29
Boletas de honorariosRecibidas (por mes) y emitidas (resumen anual y detalle boleta por boleta)Retención de las boletas contra el F29 (código 151) y contra la renta (códigos 547 y 492)
Renta (F22)Declaraciones por año tributario, folio vigente, códigos, observaciones y eventos (devoluciones, giros), y lo que el SII prepara para el F22 (PPM y comparativo F29-RCV)Boletas emitidas y lo informado por terceros contra el F22; los PPM del SII contra tus F29
Informado por tercerosDeclaraciones juradas que otros presentan sobre ti (p. ej. retenciones de honorarios)Lo que informa cada pagador contra tus boletas y tu F22; avisa si el SII observó la declaración de un informante
CuentaPerfil tributario (régimen, segmento, autorización para declarar el F29 hasta el día 20) y empresas autorizadasVencimientos del F29 según tu caso
Mi SIIAnotaciones vigentes (p. ej. F29 no presentado, que puede impedir emitir documentos), estado de cumplimiento y mensajesLas convierte en avisos de la revisión diaria

Y con lo guardado, sin ir al SII:

ÁreaQué hace
EstimacionesF29 del mes antes de declararlo y F22 de una persona (con los datos públicos del año); proyección del cierre del año contra los PPM pagados
BancoImporta cartolas CSV, concilia cada movimiento con facturas, boletas, F29 y F22, y muestra las cuentas por cobrar y por pagar por antigüedad
ContabilidadPlan de cuentas base, libros de compras, ventas, honorarios y banco, propuesta de asientos que cuadran y resultado devengado o percibido, exportables a CSV
SeguimientoRevisión diaria con avisos sin repetir, novedades y el estado de toda la cartera
Ahorro legalOportunidades con su norma y página oficial, y simulación Pro Pyme General frente a Transparente

Los datos públicos (UTM, tablas de impuestos, tasas de cotización, comisiones de AFP) no se guardan: la herramienta fuentes_oficiales indica en qué página oficial consultarlos para el año que corresponda.

Qué no hace

mi-sii-mcp (repositorio oficial: github.com/Taksuma-0/mi-sii-mcp) sirve para consultar y conciliar tu información tributaria. Para no confundirlo con otros proyectos de nombre parecido:

  • No emite facturas, boletas ni otros documentos, y no usa el Sistema de Facturación Gratuito del SII (MiPyme).
  • No presenta ni rectifica declaraciones (F29, F22) ni modifica nada en el portal.
  • No descarga los archivos XML o PDF de las facturas electrónicas (DTE): lee el detalle del Registro de Compras y Ventas.
  • No opera el portal con un navegador automatizado: consulta el SII directamente y solo abre el navegador, si tú lo eliges, para iniciar sesión con ClaveÚnica.
  • No envía tus datos a servidores de terceros: todo queda en tu equipo. Solo escribe en tu equipo: la base, los archivos que exportas y la tarea de la revisión diaria si la activas.
  • No es una contabilidad completa: propone libros y asientos para revisar con tu contador.
  • No sugiere operaciones para pagar menos: solo muestra beneficios que la ley ya permite, con su norma; simular gastos o contratos es elusión o fraude.
  • No consulta la Tesorería (deudas y giros) por ahora.
  • No se actualiza sola: avisa cuando hay una versión nueva en npm (una consulta al día a registry.npmjs.org, sin datos tuyos; se apaga con MI_SII_MCP_SIN_AVISO_VERSION=1), pero no instala nada.

Compatibilidad con agentes de IA

mi-sii-mcp es un servidor MCP local (transporte stdio), así que funciona con los clientes que ejecutan servidores MCP locales.

ClienteEstadoCómo se configura
Claude Code✅ ProbadoPlugin (/plugin install) o claude mcp add (ver instalación)
Codex (OpenAI)✅ Conexión probadaPlugin (codex plugin add) o ~/.codex/config.toml
Gemini CLI✅ Conexión probadaExtensión (gemini extensions install) o ~/.gemini/settings.json
Grok Build (xAI)Configuración documentadagrok mcp add; también lee lo que ya instalaste en Claude Code
Claude DesktopConfiguración documentadaclaude_desktop_config.json (formato mcpServers)
CursorConfiguración documentadaBotón de instalación o ~/.cursor/mcp.json
VS Code con GitHub CopilotConfiguración documentadaBotón de instalación o .vscode/mcp.json
Windsurf, Cline y otrosConfiguración documentadaFormato mcpServers

«Configuración documentada» significa que se usa el formato MCP estándar de cada cliente. «Conexión probada» significa que el cliente instaló el servidor y se conectó a él en Windows. El desarrollo y las pruebas en vivo se hicieron con Claude Code.

Cómo funciona

mermaid
flowchart LR    P([Tú]) -- preguntas --> A    subgraph A [Tu asistente con MCP]        direction TB        A1[Claude Code / Desktop]        A2[Cursor · Windsurf · Cline]        A3[VS Code + Copilot]        A4[Codex · Gemini CLI · Grok]    end    A <-- herramientas MCP --> M[mi-sii-mcp]    M -- solo lectura --> S[(Portal del SII)]    M <--> D[(Base local<br/>~/.mi-sii-mcp)]    P -. conecta su cuenta .-> W[Terminal o página local<br/>login]    W --> M
  1. Conectas tu cuenta una vez, en la terminal o en una página local; la clave no pasa por el chat.
  2. El asistente pide datos al servidor MCP, que los lee del SII y los guarda en tu equipo.
  3. mi-sii-mcp concilia la información con reglas tributarias y responde con hallazgos claros.

Requisitos

  • Node.js 22.12 o superior (probado con Node 24).
  • Un cliente MCP que ejecute servidores locales (ver compatibilidad).
  • Clave tributaria del SII.
  • Windows es la plataforma probada; el código es multiplataforma (en macOS o Linux, conecta la cuenta con login desde la terminal o, si instalaste desde el código, con npm run local).

Instalación

Lo más simple es npx: tu asistente descarga y arranca la versión publicada en npm, sin clonar ni compilar nada. Solo necesitas Node.js 22.12 o superior.

1. Registrar el servidor en tu asistente

En un clic:

[Instalar mi-sii-mcp en VS Code] [Instalar mi-sii-mcp en VS Code Insiders] [Instalar mi-sii-mcp en Cursor]

Claude Code

Como plugin, que trae el servidor y la skill. Dentro de Claude Code:

text
/plugin install mi-sii-mcp --marketplace Taksuma-0/mi-sii-mcp

En versiones anteriores a la 2.1.275, en dos pasos: /plugin marketplace add Taksuma-0/mi-sii-mcp y luego /plugin install mi-sii-mcp@mi-sii-mcp.

O solo el servidor, desde la terminal:

bash
claude mcp add --scope user mi-sii-mcp -- npx -y mi-sii-mcp@latest mcp
Gemini CLI

Como extensión, que trae el servidor y la skill:

bash
gemini extensions install https://github.com/Taksuma-0/mi-sii-mcp
Codex (OpenAI)

Como plugin, que trae el servidor y la skill:

bash
codex plugin marketplace add Taksuma-0/mi-sii-mcpcodex plugin add mi-sii-mcp@mi-sii-mcp

El plugin ya amplía los plazos de Codex, que por defecto espera 10 segundos a que el servidor arranque y 60 por herramienta; una sincronización de 12 meses con el SII tarda más que eso.

O solo el servidor, en ~/.codex/config.toml (con codex mcp add mi-sii-mcp -- npx -y mi-sii-mcp@latest mcp quedan los plazos por defecto: agrega después las dos últimas líneas):

toml
[mcp_servers.mi-sii-mcp]command = "npx"args = ["-y", "mi-sii-mcp@latest", "mcp"]startup_timeout_sec = 120tool_timeout_sec = 900
Grok Build (xAI)

Si ya lo instalaste en Claude Code (plugin o claude mcp add), Grok Build lo carga solo: lee la configuración, los plugins y las skills de Claude Code. Si no:

bash
grok mcp add mi-sii-mcp -- npx -y mi-sii-mcp@latest mcp

La primera vez npx descarga el paquete; si Grok corta la conexión antes, sube startup_timeout_sec = 120 en la entrada [mcp_servers.mi-sii-mcp] de ~/.grok/config.toml. Para la skill, copia la carpeta skills/mi-sii-mcp a ~/.grok/skills/. Revisa la conexión con grok mcp doctor mi-sii-mcp.

VS Code con Copilot (.vscode/mcp.json o la configuración de usuario)
json
{  "servers": {    "mi-sii-mcp": {      "type": "stdio",      "command": "npx",      "args": ["-y", "mi-sii-mcp@latest", "mcp"]    }  }}
Claude Desktop, Cursor, Windsurf, Cline y otros con formato mcpServers

Agrega esto al archivo de configuración MCP de tu cliente (Claude Desktop: claude_desktop_config.json; Cursor: ~/.cursor/mcp.json; Windsurf: ~/.codeium/windsurf/mcp_config.json; Gemini CLI sin la extensión: ~/.gemini/settings.json):

json
{  "mcpServers": {    "mi-sii-mcp": {      "command": "npx",      "args": ["-y", "mi-sii-mcp@latest", "mcp"]    }  }}
Desde el código (sin npx, o para usar la página local)
bash
git clone https://github.com/Taksuma-0/mi-sii-mcp.gitcd mi-sii-mcpnpm installnpm run build

El servidor se inicia con node <carpeta>/dist/interfaces/cli/bin.js mcp. En las configuraciones de arriba, cambia npx por node y los argumentos por la ruta de bin.js y mcp. Por ejemplo, en Claude Code (reemplaza C:\ruta\a\mi-sii-mcp por la carpeta donde clonaste el proyecto):

bash
claude mcp add --scope user mi-sii-mcp -- node "C:\ruta\a\mi-sii-mcp\dist\interfaces\cli\bin.js" mcp

@latest hace que npx use siempre la última versión publicada. El servidor trae sus propias instrucciones de uso para el asistente (por dónde empezar, cómo reintentar, que nunca pida la clave), así que se comporta igual con cualquier cliente.

2. Conectar tu cuenta del SII

Inicias sesión una vez y la clave nunca pasa por el chat.

Desde tu asistente (lo más simple): pídele «conecta mi cuenta». Con la herramienta cuenta_conectar se abre en tu navegador la página local de mi-sii-mcp: escribes tu RUT y tu clave tributaria, dejas marcado Mantener conectada y pulsas Conectar (o entras con ClaveÚnica). Sin asistente, la misma página se abre con npx -y mi-sii-mcp@latest conectar.

Desde la terminal, con npx (cualquier sistema). Reemplaza 11111111-1 por tu RUT:

bash
npx -y mi-sii-mcp@latest login 11111111-1 --guardar-clave

Te pide la clave tributaria sin mostrarla. Con --guardar-clave la guarda en el almacén de credenciales del sistema para que la sesión se renueve sola. Para entrar con ClaveÚnica (experimental; su sesión no se renueva sola): npx -y mi-sii-mcp@latest login-navegador --rut 11111111-1. Se abre Edge o Chrome y mi-sii-mcp no ve la clave.

Con la página local (si instalaste desde el código). En Windows, haz doble clic en Abrir mi-sii-mcp.cmd (en la carpeta del proyecto). Se abre una página local donde:

  1. Escribes tu RUT (los puntos y el guion se ponen solos) y tu clave tributaria.
  2. Dejas marcado Mantener conectada para que la sesión se renueve sola.
  3. Pulsas Conectar.

[Página local de mi-sii-mcp para conectar la cuenta del SII, con cuentas de ejemplo]

Puedes conectar varias cuentas (tu RUT personal y tus empresas). La misma página ofrece entrar con ClaveÚnica desde el navegador; esa opción es experimental (aún no se ha probado con una cuenta real) y su sesión no se renueva sola.

En macOS o Linux, la página se abre con npm run local desde la carpeta del proyecto.

3. Preguntar

Reinicia tu asistente (en Claude Code basta con /mcp) para que cargue el servidor y pregunta, por ejemplo: «lista mis perfiles» o «trae mi renta de los últimos 3 años».

Ejemplos de consultas tributarias

Pregunta al asistenteQué hace mi-sii-mcp
«¿Cuánto me han retenido este año en boletas de honorarios?»Trae tus boletas emitidas y suma la retención por mes y por pagador (renta_sincronizar, renta_resumen)
«¿Cuadran mis boletas con lo que declaré en la renta?»Compara tus boletas con los códigos 547 y 492 del F22, considerando el reajuste por IPC
«¿Qué informaron mis pagadores al SII sobre mí?»Lee las declaraciones juradas de terceros y las cruza con tus boletas
«¿Tengo algún F29 sin presentar o por vencer?»Revisa tus F29 y calcula el vencimiento según tu caso (plazos_proximos, iva_hallazgos)
«¿Cuadra el IVA de compras y ventas con el F29 de septiembre?»Concilia el RCV con el F29 del mes (iva_resumen)
«¿A quién le emití más boletas en 2026?»Consulta el detalle boleta por boleta guardado (consulta_sql)
«Estímame la devolución de la próxima renta»Junta tus datos, te indica las fuentes oficiales de los valores públicos y estima el F22 (fuentes_oficiales, renta_estimar)
«¿Cuánto voy a pagar en el F29 de este mes?»Calcula el F29 con el RCV, el remanente, el PPM y las retenciones (f29_estimar)
«Concilia mi cartola de octubre»Importa el CSV del banco y empareja cada movimiento con facturas, boletas e impuestos (banco_importar, banco_conciliar)
«¿Qué me falta cobrar?»Lista las facturas sin cobro en el banco, por antigüedad (cuentas_pendientes)
«Dame el libro de compras y los asientos de septiembre en Excel»Exporta los CSV a ~/.mi-sii-mcp/exportaciones (contabilidad_libro, contabilidad_asientos)
«¿Tengo anotaciones en el SII?»Lee tus anotaciones vigentes y el estado de cumplimiento en Mi SII (sii_avisos)
«¿Cómo puedo pagar menos impuestos, legalmente?»Busca oportunidades con su norma y simula régimen y cierre (ahorro_oportunidades, regimen_simular, cierre_proyectar)
«¿Qué cuenta necesita atención esta semana?»Una línea por cuenta con lo vencido, lo pendiente y los avisos (cartera_estado)

El servidor trae además recetas listas (prompts MCP) que tu cliente muestra en su menú: revisión del mes, qué tengo pendiente, cierre contable, cartera semanal, preparar la renta y ahorro tributario.

Skill para agentes

El repositorio incluye una skill en el formato estándar Agent Skills (SKILL.md): skills/mi-sii-mcp. Le enseña a tu agente cuándo usar mi-sii-mcp, qué herramienta usar para cada tarea (revisión de IVA, boletas, renta, vencimientos, preguntas libres), las reglas de seguridad y cómo repartir el trabajo entre varios agentes: un solo agente consulta el SII y el resto analiza los datos guardados en paralelo.

  • Claude Code: el plugin la instala junto con el servidor. También puedes copiar la carpeta skills/mi-sii-mcp a ~/.claude/skills/ (para todos tus proyectos) o a .claude/skills/ dentro de un proyecto.
  • Codex: el plugin la trae.
  • Gemini CLI: la extensión la trae.
  • Grok Build: la toma del plugin de Claude Code, o cópiala a ~/.grok/skills/.
  • Otros agentes compatibles con SKILL.md: copia la misma carpeta en su directorio de skills.

La skill complementa al servidor, que además entrega sus propias instrucciones a cualquier cliente MCP.

Herramientas del MCP

HerramientaPara qué sirve¿Consulta al SII?
perfiles_listarCuentas configuradas, estado de su sesión y si se renueva solaNo
cuenta_conectarAbre en tu navegador la página local para conectar una cuenta (RUT y clave, o ClaveÚnica); la clave no pasa por el chatNo
sii_panoramaQué hay guardado por mes y por añoNo
sincronizarTrae RCV y F29 de un rango de meses (opcional: propuesta de F29 y boletas recibidas)Sí (lectura)
renta_sincronizarTrae el F22, las boletas emitidas y lo informado por terceros, por año tributarioSí (lectura)
perfil_sincronizarTrae el perfil tributario y las empresas autorizadasSí (lectura)
iva_resumen, iva_hallazgosConciliación del IVA y hallazgos por mesNo
f29_historial, plazos_proximosHistorial de F29 y vencimientosNo
rcv_documentosDocumentos del RCV de un mesNo
renta_resumenRenta guardada con sus cruces (boletas, pagadores, terceros)No
f29_releerVuelve a leer los PDF de F29 guardados, sin ir al SIINo
fuentes_oficialesDónde consultar los datos públicos (UTM, tablas, tasas) y cómo estimar una rentaNo
datos_esquema, consulta_sqlMapa de las tablas y consultas SELECT de solo lectura para preguntas libresNo
sii_avisosAnotaciones vigentes, estado de cumplimiento y mensajes de Mi SII; los suma a novedadesSí (lectura)
f29_estimarF29 calculado antes de declararlo, comparado con el presentado si existeNo
renta_estimarF22 estimado de una persona con los datos públicos del año, comparado con el presentadoNo
banco_importar, banco_conciliarImporta cartolas CSV y las concilia con facturas, boletas, F29 y F22 (con ajustes a mano)No
cuentas_pendientesPor cobrar y por pagar, por antigüedadNo
contabilidad_cuentas, contabilidad_libro, contabilidad_asientos, contabilidad_resultadoPlan de cuentas, libros, asientos y resultado, exportables a CSVNo
novedades, cartera_estadoAvisos de la revisión diaria y estado de todas las cuentasNo
ahorro_oportunidadesOportunidades legales de pagar menos o después, con su normaNo
regimen_simular, cierre_proyectarPro Pyme General frente a Transparente y proyección del año al cierreNo
diagnosticoSalud de mi-sii-mcp: versión, base y respaldo, sesiones, fallas por reintentar y cambios del portal del SIINo

sii_panorama, renta_resumen, contabilidad_libro y contabilidad_asientos responden por defecto una versión liviana; con detalle: true traen todo.

Seguridad y privacidad

  • Solo lee. Nunca presenta, modifica ni emite nada en el SII.
  • Tus datos quedan en tu equipo, en una base SQLite en ~/.mi-sii-mcp; el servidor se comunica directamente con el SII, sin servidores intermedios.
  • El asistente nunca recibe tu clave. El inicio de sesión lo haces tú en una página local o en la terminal; el MCP no tiene ninguna herramienta que reciba claves.
  • La sesión se guarda como cookies en tu equipo para no pedirte la clave en cada consulta. Si eliges «Mantener conectada», la clave queda en el almacén de credenciales del sistema (Administrador de credenciales de Windows, Llavero de macOS o Secret Service en Linux), no en archivos.
  • Las respuestas del SII que se guardan como respaldo se sanean: sin correos, direcciones, códigos de barra ni el token de la sesión. De terceros se guarda solo lo necesario (p. ej. la razón social de un pagador).
  • Lo que consultas pasa a la conversación con tu asistente (y a su proveedor de IA): pregunta solo por los contribuyentes que estés dispuesto a comentar ahí.

Cómo protege cada dato (claves, sesiones, página local, qué llega al proveedor de IA): docs/seguridad.md. Para reportar una vulnerabilidad en privado: SECURITY.md.

Preguntas frecuentes

¿Qué es mi-sii-mcp?

Es un servidor MCP de código abierto que permite que un asistente de IA consulte y concilie tu información tributaria del SII de Chile: IVA, F29, renta F22, boletas de honorarios y declaraciones de terceros.

¿Qué es un servidor MCP y por qué usarlo con el SII?

MCP (Model Context Protocol) es un estándar abierto para que los asistentes de IA usen herramientas externas. Un servidor MCP para el SII le da a tu asistente herramientas para leer tus datos tributarios y aplicar reglas de conciliación, en vez de que copies y pegues información del portal.

¿Cómo conecto Claude, Codex, Gemini CLI, Grok o Cursor al SII?

Regístralo en tu cliente con npx: es un comando o un clic, sin descargar el código (ver instalación). En Claude Code y Codex también está el plugin, y en Gemini CLI la extensión, que traen el servidor y la skill; Grok Build usa lo que ya instalaste en Claude Code o se agrega con grok mcp add. Después pídele «conecta mi cuenta»: se abre una página local donde escribes tu clave, que nunca pasa por el chat. Claude Code está probado, y Codex y Gemini CLI se conectan; para los demás clientes se usa su formato MCP estándar.

¿El asistente puede ver mi clave tributaria?

No. La clave se escribe solo en la página local (o en la terminal) y ninguna herramienta del MCP la recibe. Si eliges mantener la sesión, la clave queda en el almacén de credenciales de tu sistema.

¿Dónde quedan mis datos?

En tu equipo, en ~/.mi-sii-mcp. Lo que preguntas y las respuestas sí pasan por tu asistente de IA, como cualquier conversación con él.

¿Puede presentar mi F29 o emitir boletas?

No. mi-sii-mcp solo lee el portal del SII; no presenta declaraciones, no emite documentos ni modifica nada.

¿mi-sii-mcp emite facturas o usa el Sistema de Facturación Gratuito del SII?

No. mi-sii-mcp no emite facturas ni boletas, no usa el Sistema de Facturación Gratuito del SII y no descarga los archivos de las facturas electrónicas (DTE). Lee el Registro de Compras y Ventas, los F29, la renta F22, las boletas de honorarios y las declaraciones de terceros, siempre en solo lectura. Su código está en github.com/Taksuma-0/mi-sii-mcp.

¿Es una herramienta oficial del SII?

No. Es un proyecto independiente de código abierto y no reemplaza la asesoría de un contador.

¿Cuánto cuesta?

Es gratuito y de código abierto (licencia MIT). Solo necesitas un cliente MCP; el costo del asistente de IA depende de su proveedor.

¿Funciona en macOS o Linux?

El código es multiplataforma, pero la plataforma probada es Windows. En macOS o Linux, pídele a tu asistente «conecta mi cuenta» o ejecuta npx -y mi-sii-mcp@latest conectar: los dos abren la página local en tu navegador.

Uso desde la terminal (opcional)

Todo lo anterior también está disponible como comandos (si instalaste desde el código, cambia npx -y mi-sii-mcp@latest por node dist/interfaces/cli/bin.js):

bash
npx -y mi-sii-mcp@latest --helpnpx -y mi-sii-mcp@latest perfil listarnpx -y mi-sii-mcp@latest sync 11111111-1 --desde 2026-01 --hasta 2026-09npx -y mi-sii-mcp@latest renta sync 11111111-1 --desde 2025 --hasta 2027npx -y mi-sii-mcp@latest renta ver 11111111-1

Configuración

Variables de entorno opcionales:

VariablePara qué
MI_SII_MCP_HOMECarpeta de datos (por defecto ~/.mi-sii-mcp)
MI_SII_MCP_PLAZO_HTTP_MSPlazo de cada consulta al SII (por defecto 60 s)
MI_SII_MCP_INTERVALO_MSPausa mínima entre consultas al SII (por defecto 1 s)
MI_SII_MCP_TOLERANCIATolerancia en pesos para los cruces de IVA
MI_SII_MCP_NAVEGADORRuta de Edge o Chrome para entrar con ClaveÚnica
MI_SII_MCP_PLAZO_NAVEGADOR_MSTiempo para completar el inicio de sesión en el navegador
MI_SII_MCP_SIN_AVISO_VERSIONCon 1, no consulta en npm si hay una versión nueva

Documentación

Desarrollo

bash
npm test            # pruebas (solo datos ficticios; nunca consultan el SII real)npm run typecheck   # tiposnpm run build       # compila a dist/npm run probar:mcp  # prueba el servidor MCP compilado

El código está organizado por capas (domain, app, connectors, store, interfaces, main); test/arquitectura.test.ts verifica que se respeten.

Las contribuciones son bienvenidas. Por favor, nunca incluyas datos tributarios reales (RUT, nombres, montos) en issues, pruebas ni fixtures: usa RUT ficticios como 11.111.111-1.

Limitaciones

  • La propuesta del F22 aún no se lee (el SII la publica en abril).
  • Las estimaciones y simulaciones no ven sueldos, depreciación ni otros gastos sin documento tributario: si conoces la base real, infórmala.
  • Las cartolas se importan en CSV o TXT; el XLSX se guarda primero como CSV desde Excel.
  • La revisión diaria y sus notificaciones están hechas para Windows.
  • La declaración de sueldos del empleador (DJ 1887) se lee de forma genérica: su formato no se ha verificado con datos reales.
  • El inicio de sesión con ClaveÚnica desde el navegador es experimental.
  • Si el SII cambia su portal, mi-sii-mcp se adapta solo cuando puede comprobarlo con los totales del SII (hoy, los montos del detalle del RCV); los demás cambios detienen la lectura sin tocar lo guardado hasta actualizar el lector, y diagnostico los muestra.

In English

mi-sii-mcp is an open-source, read-only Model Context Protocol server for Chile's Internal Revenue Service (SII). It lets AI assistants such as Claude, Codex, Gemini CLI, Grok Build, Cursor and VS Code with Copilot read a taxpayer's VAT purchase and sales records (RCV), F29 returns, income tax returns (F22), fee receipts (boletas de honorarios) and third-party sworn statements. It stores them locally in SQLite and cross-checks them for mismatches and upcoming deadlines. It also estimates the F29 and F22, reconciles bank statements and drafts bookkeeping entries. The assistant never receives the taxpayer's password.

bash
claude mcp add --scope user mi-sii-mcp -- npx -y mi-sii-mcp@latest mcpnpx -y mi-sii-mcp@latest login 11111111-1 --guardar-clave   # connect your SII account once

Or ask the assistant to «conecta mi cuenta»: the cuenta_conectar tool opens a local page in the browser where the user types the password, which never goes through the chat.

It is also a Claude Code plugin (/plugin install mi-sii-mcp --marketplace Taksuma-0/mi-sii-mcp), a Codex plugin (codex plugin marketplace add Taksuma-0/mi-sii-mcp, then codex plugin add mi-sii-mcp@mi-sii-mcp) and a Gemini CLI extension (gemini extensions install https://github.com/Taksuma-0/mi-sii-mcp); Grok Build loads it from Claude Code or with grok mcp add mi-sii-mcp -- npx -y mi-sii-mcp@latest mcp. Answers and documentation are in Spanish. Not affiliated with the SII; not tax advice.

Licencia

MIT © 2026 Welinton Barrera · Código fuente: github.com/Taksuma-0/mi-sii-mcp

Source: README.md at commit 5957e7a

Tools

33

perfiles_listar

Perfiles configurados

Lista los contribuyentes configurados (persona natural y empresa) y el estado de su sesión SII. Úsala primero para saber qué RUT consultar.

Takes no parameters.

cuenta_conectar

Conectar una cuenta del SII

Abre en el navegador de la persona la página local de mi-sii-mcp, donde conecta una cuenta del SII con su RUT y su clave tributaria (o con ClaveÚnica) sin que la clave pase por el chat; ahí también importa cartolas y activa la revisión diaria. Úsala cuando falte la sesión o la persona quiera conectar una cuenta. No recibe datos.

Takes no parameters.

sii_panorama

Panorama local del SII

Muestra el panorama de todos los meses almacenados localmente para un RUT, con montos y cobertura de RCV (compras y ventas) y F29 y, si se sincronizaron, la propuesta de F29, las boletas de honorarios recibidas y la renta (F22) por año tributario, además de los datos de la cuenta. No requiere un período y no descarga datos del SII: consulta solo lo almacenado localmente.

Parametersrutrequireddetalle

sincronizar

Sincronizar con el SII

Trae desde el portal del SII el RCV (compras y ventas) y el F29 de un rango de meses y los guarda en la base local. Solo lee el SII: nunca presenta ni modifica nada allí. Por defecto trae rcv y f29 (propuesta y bhe son opcionales); con superficies puedes elegir, y «propuesta» (opcional, no va por defecto) agrega la propuesta de F29 del SII: crédito, remanente y retención propuestos, sin débito ni total a pagar; «bhe» (opcional, no va por defecto) agrega las boletas de honorarios recibidas del mes, con su retención, que se cruza con el código 151 del F29. La renta (F22) no va aquí: usa renta_sincronizar, y el perfil y las empresas autorizadas, perfil_sincronizar. Admite hasta 120 meses por llamada; para historia larga llama por tramos de 12 meses, así avanzas por partes y evitas que el cliente agote el plazo de espera. Si no hay sesión, usa cuenta_conectar para que la persona conecte la cuenta; nunca pidas la clave en el chat.

Parametersrutrequireddesderequiredhastasuperficies

diagnostico

Diagnóstico de mi-sii-mcp

Salud de mi-sii-mcp con lo guardado, sin ir al SII: versión (y si hay una nueva en npm), integridad de la base y su último respaldo, por cuenta la sesión, la última lectura buena y las fallas del SII que la revisión diaria reintentará, y lo que se sabe de los cambios del portal del SII (campos nuevos, nombres que se adaptaron solos con los totales cuadrados y lecturas que fallaron). Úsala si algo no cuadra o falla una sincronización.

Parametersrut

sii_avisos

Anotaciones y avisos de Mi SII

Consulta en Mi SII, con la sesión guardada y solo leyendo, las anotaciones vigentes que restringen trámites (por ejemplo, F29 no presentado o domicilio sin acreditar, que impiden timbrar o emitir documentos), el estado de cumplimiento de las obligaciones tributarias y los mensajes informativos. Registra cada anotación y cada requisito incumplido como aviso en novedades (la revisión diaria también lo hace). No muestra deudas de la Tesorería. Solo para el RUT de la sesión: una empresa que entra con la sesión de quien la representa debe conectar su propia cuenta. Si no hay sesión, usa cuenta_conectar; nunca pidas la clave.

Parametersrutrequired

perfil_sincronizar

Sincronizar la cuenta del SII

Trae del SII el perfil tributario (si está autorizado a declarar el F29 hasta el día 20, régimen y segmento) y las empresas que el contribuyente puede consultar, y reemplaza `representa` del perfil por las empresas activas que informa el SII (lo que el SII reporta sobrescribe lo que se haya anotado a mano). Solo lee el SII; de las empresas autorizadas guarda RUT, razón social (que puede ser el nombre de una persona), privilegios y fecha de desautorización, y no guarda correos, teléfonos ni direcciones. Los plazos del F29 usan el día 20 solo si el SII lo autoriza (si no, el 12): sincroniza la cuenta antes de revisar plazos. Si no hay sesión, usa cuenta_conectar para que la persona conecte la cuenta; nunca pidas la clave en el chat.

Parametersrutrequired

renta_sincronizar

Sincronizar la renta (F22)

Trae del SII la declaración anual de renta (F22) de un rango de años tributarios (AAAA; el año tributario es el año comercial + 1) y la guarda en la base local: las declaraciones del año, su conclusión y, del folio vigente, los códigos con su glosa, las observaciones y los eventos. A una persona (no a una empresa) le trae además el informe anual de boletas de honorarios emitidas del año comercial y, de los meses con boletas, su detalle boleta por boleta (a quién, bruto y retenciones; no repite meses que ya calzan); con el año tributario siguiente al actual (p. ej. 2027 en 2026) ves las boletas del año en curso aunque aún no haya F22. A cualquier perfil le trae también las rentas informadas por terceros: las declaraciones juradas (DJ) que otros presentaron sobre él, como la 1879 (quien pagó honorarios y retuvo) o la 1887 (sueldos del empleador), con cada informante, sus meses, montos y si el SII observó su declaración. Máximo 10 años por llamada. Solo lee el SII y no guarda nombres, domicilio, cuenta ni banco. Si el SII responde vacío donde había datos, se conservan los guardados. Si no hay sesión, usa cuenta_conectar para que la persona conecte la cuenta; nunca pidas la clave en el chat.

Parametersrutrequireddesderequiredhasta

renta_resumen

Resumen de la renta (F22)

Muestra la renta (F22) guardada localmente por año tributario: folio vigente, conclusión del SII, impuesto pagado, giro y remanente, los códigos del resultado con su glosa del SII, observaciones y eventos. De una persona muestra además sus boletas de honorarios emitidas del año comercial (vigentes, anuladas, bruto y retención) y su cruce con los códigos 547 (ingresos brutos) y 492 (retención) del F22, que vienen reajustados por IPC: cuadra si el F22 trae entre 0 % y 10 % más; con el detalle boleta por boleta, también sus 5 principales pagadores. También muestra lo informado por terceros (DJ): cada informante con sus meses, monto y estado, con un aviso si su declaración está observada por el SII; en la DJ 1879 cruza la retención informada con las boletas emitidas a ese RUT y la total con las boletas del año y con el 492 del F22 (cuadra o difiere por cuánto). Para preguntas como «¿a quién le emití boletas?» o por mes y receptor, usa consulta_sql sobre bhe_emitida. Lo informado por terceros está en dj_tercero. No va al SII: si no hay datos, usa renta_sincronizar. Los demás códigos están en f22_valor y las boletas por mes en bhe_emitida_mes (consulta_sql).

Parametersrutrequiredaniodetalle

fuentes_oficiales

Fuentes oficiales de datos públicos

Datos públicos de la renta (UTM y UTA, tablas del Impuesto Global Complementario y del Impuesto Único, factores de actualización por IPC, gastos presuntos, tasa de retención de honorarios, obligación y cobertura de la cotización de honorarios, tasas de ATEP, SANNA y salud, comisiones de las AFP y tasa del SIS): mi-sii-mcp no los guarda. Esta herramienta dice en qué página oficial (SII, Superintendencia de Pensiones, Previsión Social, ChileAtiende) consultar cada uno y qué buscar ahí, y con regla=true la regla paso a paso para estimar el F22 de una persona con sueldo y honorarios. Úsala antes de estimar una renta: los datos privados salen de renta_resumen y los públicos de esas páginas, del año que se calcula. No va al SII.

Parametersreglabuscar

f29_releer

Releer el F29 guardado

Relee los PDF ya guardados con el lector actual, sin ir al SII: vuelve a leer el PDF del F29 de cada folio que trajo una sincronización anterior y actualiza sus valores si cambian. Una lectura que no cuadra no reemplaza a una guardada que sí cuadra. Úsala tras actualizar mi-sii-mcp o ante un F29 leído que no cuadra; sin rango relee todos los meses guardados.

Parametersrutrequireddesdehasta

f29_estimar

Estimar el F29 de un mes

Estima el F29 de un mes con lo guardado, sin ir al SII ni presentar nada: débito y crédito del RCV, remanente del mes anterior (del F29 presentado o estimado si ese mes no se presentó), PPM con la tasa del último F29 presentado y retención de las boletas de honorarios recibidas. Si el mes ya tiene F29, compara. El impuesto único de los trabajadores (código 48) no está en el SII: pásalo en impuesto_unico si hubo sueldos. Para reajustar el remanente pasa utm_actual y utm_anterior (https://www.sii.cl/valores_y_fechas/utm/utm2026.htm, cambia el año). Un F29 atrasado paga reajustes, intereses y multas que calcula el portal del SII al declarar; aquí solo va el monto base y los días de atraso.

Parametersrutrequiredperiodorequiredtasa_ppmutm_actualutm_anteriorimpuesto_unico

banco_importar

Importar una cartola bancaria

Importa una cartola bancaria (CSV o TXT de cualquier banco, máximo 5 MB) que la persona tiene en su equipo: pasa la ruta completa del archivo. Guarda los movimientos solo en la base local, sin repetir los que ya estaban (se pueden importar cartolas que se solapan), y revisa que el saldo no se corte. Reconoce solas las columnas de fecha, descripción, cargo y abono (o monto con signo), saldo y documento; si no, indícalas en columnas con el nombre de la cabecera o su número desde 1. Desde Excel: Guardar como CSV. No va al SII ni al banco. Después usa banco_conciliar.

Parametersrutrequiredcuentaarchivorequiredcolumnas

banco_conciliar

Conciliar el banco

Concilia los movimientos de las cartolas importadas en un rango de meses con lo que mi-sii-mcp conoce: ventas y compras del RCV, boletas de honorarios recibidas y emitidas, F29 pagados y devoluciones del F22. Empareja por monto exacto, primero si la glosa trae el RUT de la contraparte y luego por la fecha más cercana. Muestra lo conciliado, los movimientos sin partida (comisiones, sueldos, retiros) y lo facturado que no aparece en el banco. Para corregir: accion «asignar» con huella (o su comienzo) y partida, o «descartar» con huella. Solo usa la base local.

Parametersrutrequireddesderequiredhastaaccionhuellapartida

cuentas_pendientes

Cuentas por cobrar y por pagar

Cuentas por cobrar y por pagar a una fecha: las facturas, notas y boletas de honorarios que no aparecen en las cartolas importadas, con su antigüedad (0-30, 31-60, 61-90 y más de 90 días). Necesita cartolas (banco_importar) y concilia antes de calcular. Lo que no está en el banco pudo pagarse por otra vía: es para revisar, no una deuda confirmada.

Parametersalrutrequiredlado

contabilidad_cuentas

Plan de cuentas

Plan de cuentas del contribuyente para los asientos propuestos: el básico de una pyme más sus cuentas propias, y las reglas que clasifican las compras de un proveedor. accion «listar» lo muestra; «crear» suma (o renombra) una cuenta con cuenta, nombre y tipo; «asignar» lleva las compras de rut_contraparte a una cuenta de gasto o de activo; «quitar» borra esa regla. Sin regla, cada compra va a la cuenta que indica su tipo de compra en el RCV (del giro, activo fijo, supermercado…). Solo usa la base local.

Parametersrutrequiredtipoaccionrequiredcuentanombrerut_contraparte

contabilidad_libro

Libros contables

Libro de un rango de meses con lo guardado: compras o ventas del RCV (registradas; las notas de crédito restan y las boletas de venta van como resumen del mes), boletas de honorarios recibidas o emitidas, o el banco (movimientos de las cartolas con su conciliación). Con exportar=true lo guarda como CSV para Excel o el software contable (punto y coma, fechas dd-mm-aaaa) en la carpeta exportaciones de mi-sii-mcp y devuelve la ruta. Solo usa la base local.

Parametersrutrequiredtiporequireddesderequiredhastadetalleexportar

contabilidad_asientos

Asientos contables propuestos

Propone los asientos contables de un rango de meses con lo guardado: ventas y compras registradas del RCV (cada compra a la cuenta de su tipo o de la regla del proveedor), boletas de venta, boletas de honorarios, la centralización de cada F29 presentado y los movimientos de las cartolas según su conciliación. Todo asiento cuadra; lo que no se sabe dónde va queda en «por clasificar». Con exportar=true los guarda como CSV para Excel o el software contable. Es una propuesta para revisar: no incluye sueldos, inventario ni depreciación. Solo usa la base local.

Parametersrutrequireddesderequiredhastadetalleexportar

contabilidad_resultado

Estado de resultados

Estado de resultados de un rango de meses a partir de los asientos propuestos: base devengada (lo facturado y las boletas del período, por defecto) o percibida (solo lo cobrado y pagado según las cartolas conciliadas, como tributa una Pro Pyme; necesita banco_importar). Muestra ingresos y gastos por cuenta, el resultado y los 5 principales clientes y proveedores. No incluye sueldos, depreciación ni gastos que el SII no conoce. Solo usa la base local.

Parametersrutrequiredbasedesderequiredhasta

novedades

Novedades

Avisos que la persona aún no ve, de una cuenta o de todas: F29 vencidos o por vencer, hallazgos críticos de la conciliación, facturas por reclamar, eventos de la renta y cuentas sin sesión. Los registra la revisión diaria (vigilar), que se activa en la página local (la abre cuenta_conectar). Por defecto quedan marcados como vistos. Solo usa la base local.

Parametersrutmarcar_vistas

cartera_estado

Estado de todas las cuentas

Una línea por cada cuenta configurada (empresas y personas, útil para un contador): sesión, F29 vencidos, por confirmar (meses sin sincronizar) y por vencer, hallazgos críticos, próximo plazo, avisos sin ver, movimientos del banco sin conciliar y fecha de los datos. No va al SII: sincroniza las cuentas que lo necesiten.

Takes no parameters.

informe_visual

Informe visual

Arma un informe visual en HTML (conclusión, tarjetas, gráficos y tablas; listo para imprimir o guardar como PDF) con lo guardado localmente y lo abre en el navegador de la persona: «iva» del mes (rut y periodo), «renta» (rut; anio opcional), «cartera» (todas las cuentas) o «vencimientos» (rut). Úsala cuando la persona pida verlo en un informe, en visual o para imprimir. No consulta el SII ni envía datos fuera del equipo: el archivo queda en la carpeta informes de mi-sii-mcp.

Parametersrutaniotiporequiredabrirperiodo

renta_estimar

Estimar la renta de una persona

Estima el F22 de una persona (honorarios y sueldo) de un año tributario con lo guardado (boletas emitidas del año comercial y la DJ del empleador) y los datos públicos del año, que mi-sii-mcp no guarda: tabla del Impuesto Global Complementario, UTA de diciembre, gastos presuntos (porcentaje y tope en UTA), si está obligada a cotizar y sus cotizaciones, y los factores de actualización. Saca esos datos con fuentes_oficiales (regla=true trae el cálculo de las cotizaciones). Opcionales: gastos efectivos, APV régimen B, otras rentas. Si hay un F22 guardado, compara con su resultado (código 305). Es una estimación, no asesoría.

Parametersrutrequiredutarequiredaniorequiredsueldostabla_igcrequiredcotizacionesfactores_ipcotras_rentasapv_regimen_bgastos_efectivosobligado_cotizarrequiredgastos_presuntos_pctrequired+2 more

ahorro_oportunidades

Oportunidades de ahorro tributario

Oportunidades legales de pagar menos (o de pagar después) que sostienen los datos guardados: crédito de IVA de compras pendientes que aún se puede usar, remanente de crédito sin usar, postergación del pago del IVA para pymes, gastos efectivos en vez de presuntos en honorarios y APV régimen B. Cada una trae su norma con la página oficial del SII, el monto involucrado, qué hacer y los datos que faltan. Nunca sugiere operaciones sin sustancia. No es asesoría: confírmalas con un contador. Solo usa la base local.

Parametersrutrequired

regimen_simular

Simular régimen Pro Pyme

Compara un año en Pro Pyme General (14 D N°3: la empresa paga Primera Categoría y los dueños tributan al retirar, con crédito total) y en Pro Pyme Transparente (14 D N°8: sin Primera Categoría; los dueños tributan por toda la base según su participación). Muestra el impuesto de la empresa, el de los dueños y el total. Base: la informada (mejor, si incluye sueldos y depreciación) o la del año guardado (percibida si hay cartolas de todo el año, si no devengada), proyectada si el año no terminó. Datos públicos que se informan: tasa_idpc y la tabla del Global Complementario (https://www.sii.cl/valores_y_fechas/renta/2026/personas_naturales.html, cambiando el año tributario). Trae los requisitos y el plazo para cambiarse. Simulación, no recomendación. Solo usa la base local.

Parametersrutrequiredaniorequiredbasesociosrequiredtabla_igcrequiredtasa_idpcrequiredretiro_pct

cierre_proyectar

Proyectar el cierre del año

Proyecta el año comercial al cierre con lo guardado (RCV y, si cubren el año, cartolas) al ritmo de los meses con datos, y lo compara con los PPM pagados en los F29. Con tasa_idpc estima la Primera Categoría y el saldo de abril. Si se proyecta pérdida, recuerda la suspensión de PPM (art. 90 de la Ley de la Renta) como posible. Remite a ahorro_oportunidades y regimen_simular. No incluye sueldos ni depreciación. Estimación, no asesoría. Solo usa la base local.

Parametersrutrequiredaniorequiredtasa_idpc

iva_resumen

Resumen de IVA del mes

Compara el débito y el crédito del RCV con el F29 presentado, revisa el remanente, los documentos pendientes y los plazos, y entrega los hallazgos de un mes. Lee solo la base local: revisa "frescura" y sincroniza si los datos están viejos.

Parametersrutrequiredperiodorequired

iva_hallazgos

Hallazgos de conciliación

Hallazgos de conciliación de IVA (descuadres, F29 faltantes, facturas por reclamar, cambios posteriores al F29 y, si se sincronizaron las boletas de honorarios recibidas, la retención de honorarios frente al código 151) de todos los meses con datos, o de un rango.

Parametersrutrequireddesdehastaseveridad

rcv_documentos

Documentos del RCV

Lista paginada (50 por página) de documentos del RCV de un mes, con filtros por lado, estado, tipo de documento y contraparte.

Parametersrutrequiredladoestadopaginaperiodorequiredtipo_docrut_contraparte

f29_historial

Historial del F29

Por cada mes del rango: si el F29 está presentado, folio, débitos, créditos y total a pagar; si se sincronizaron las boletas de honorarios recibidas del mes, también la retención declarada (código 151) junto a la de esas boletas.

Parametersrutrequireddesderequiredhastarequired

plazos_proximos

Plazos próximos

Vencimientos próximos: F29 por presentar y facturas recibidas cuyo plazo de reclamo (8 días) está por vencer.

Parametersrutrequireddias

consulta_sql

Consulta SQL libre

Ejecuta una sola sentencia SELECT (o WITH … SELECT) de solo lectura sobre una copia de los datos locales (RCV, F29, propuesta de F29, boletas de honorarios recibidas, renta F22, hallazgos y bitácora de sincronización). Llama antes una vez a datos_esquema: describe tablas, columnas y reglas (signo de las notas de crédito, estados del RCV, códigos del F29). Sin parámetros: escribe los valores como literales. Devuelve como máximo 200 filas y 40000 caracteres: filtra por RUT y período, agrupa o usa LIMIT.

Parameterssqlrequired

datos_esquema

Esquema de los datos

Describe las tablas que ve consulta_sql: cada columna con su tipo y significado, y las reglas para interpretar montos, notas de crédito, estados del RCV, códigos del F29 y la ausencia de datos. Llámala una vez antes de escribir consultas.

Takes no parameters.

Version history

2
  1. v0.3.1LatestNov 5, 2026
  2. v0.3.0Nov 3, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts