IVA y F29
Registro de Compras y Ventas (RCV), F29 presentados con su PDF y propuesta de F29. Concilia el IVA del RCV con el F29 y detecta F29 faltantes y facturas por reclamar.
Open source · Model Context Protocol
Servidor MCP para el SII de Chile
Conecta Claude, Codex, Cursor o Gemini CLI con tu IVA, tus F29, tu renta F22 y tus boletas de honorarios. mi-sii-mcp lee tu información del SII, la guarda en tu equipo y la concilia para mostrarte qué cuadra, qué no y qué vence.
- Licencia MIT
- Solo lectura
- Datos en tu equipo
- La clave no pasa por el chat
¿Qué es un servidor MCP para el SII?
MCP (Model Context Protocol) es un estándar abierto para que los asistentes de inteligencia artificial usen herramientas externas. mi-sii-mcp es un servidor MCP que le entrega a tu asistente herramientas para leer tu información tributaria del Servicio de Impuestos Internos y aplicar reglas de conciliación. En vez de copiar y pegar datos del portal, le preguntas a tu asistente en lenguaje natural.
Conectas tu cuenta
Una sola vez, en una página local. Tu clave se escribe ahí, nunca en el chat.
Tu asistente consulta
Pide los datos al servidor MCP, que los lee del SII en solo lectura y los guarda en tu equipo.
mi-sii-mcp concilia
Cruza registros con reglas tributarias y responde con hallazgos claros: qué cuadra y qué revisar.
Funcionalidades tributarias
Lo que mi-sii-mcp lee del SII y cómo lo concilia. Todo en solo lectura: nunca presenta, modifica ni emite nada.
Vencimientos
Calcula el vencimiento del F29 según tu caso (día 12, 20 o 28) a partir de tu perfil tributario.
Renta F22
Declaraciones por año tributario, folio vigente, códigos, observaciones y eventos como devoluciones y giros.
Boletas de honorarios
Recibidas y emitidas, con detalle boleta por boleta. Cruza la retención con el F29 (código 151) y con la renta (códigos 547 y 492).
Informado por terceros
Declaraciones juradas que otros presentan sobre ti, cruzadas con tus boletas y tu F22. Avisa si el SII observó la declaración de un informante.
Preguntas libres
Consultas SQL de solo lectura sobre tus datos guardados y fuentes oficiales para los valores públicos (UTM, tablas, tasas).
Compatible con tu agente de IA
mi-sii-mcp es un servidor MCP local (stdio): funciona con los clientes que ejecutan servidores MCP locales. El desarrollo y las pruebas en vivo se hicieron con Claude Code; para los demás se documenta su formato de configuración estándar.
| Cliente | Estado | Configuración |
|---|---|---|
| Claude Code | Probado | claude mcp add |
| Claude Desktop | Documentado | claude_desktop_config.json |
| Codex CLI | Documentado | ~/.codex/config.toml |
| Cursor | Documentado | ~/.cursor/mcp.json |
| VS Code con GitHub Copilot | Documentado | .vscode/mcp.json |
| Gemini CLI | Documentado | ~/.gemini/settings.json |
| Windsurf, Cline y otros | Documentado | Formato mcpServers |
Privacidad y arquitectura local
Tu información tributaria no pasa por servidores de terceros: mi-sii-mcp corre en tu equipo y habla directamente con el SII.
Túpreguntas en lenguaje natural
Tu asistenteClaude, Codex, Cursor…
mi-sii-mcpen tu equipo + base SQLite local
Portal del SIIsolo lectura
- Solo lectura: nunca presenta, modifica ni emite nada en el SII.
- Datos locales: todo se guarda en una base SQLite en
~/.mi-sii-mcp. - La clave no pasa por el chat: inicias sesión en una página local y ninguna herramienta del MCP recibe claves. Si eliges mantener la sesión, la clave queda en el almacén de credenciales del sistema operativo.
- Respaldos saneados: las respuestas del SII que se guardan no incluyen correos, direcciones, códigos de barra ni el token de la sesión.
- Transparencia: lo que consultas pasa a la conversación con tu asistente; el código es abierto y auditable.
Ejemplos de consultas
Preguntas reales que tu asistente puede responder con mi-sii-mcp.
¿Cuánto me han retenido este año en boletas de honorarios?
Suma la retención de tus boletas emitidas por mes y por pagador.
¿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.
¿Tengo algún F29 sin presentar o por vencer?
Revisa tus F29 y calcula cada vencimiento según tu caso.
¿Cuadra el IVA de compras y ventas con el F29 de septiembre?
Concilia el Registro de Compras y Ventas con el F29 del mes.
¿Qué informaron mis pagadores al SII sobre mí?
Lee las declaraciones juradas de terceros y las cruza con tus registros.
¿A quién le emití más boletas en 2026?
Consulta el detalle boleta por boleta guardado en tu equipo.
Instalación y configuración
Requiere Node.js 22.12 o superior, un cliente MCP y tu clave tributaria del SII.
1. Descarga y compila
git clone https://github.com/Taksuma-0/mi-sii-mcp.git
cd mi-sii-mcp
npm install
npm run build2. Registra el servidor en tu asistente
Reemplaza C:\ruta\a\mi-sii-mcp por la carpeta donde clonaste el proyecto.
Claude Code
claude mcp add --scope user mi-sii-mcp -- node "C:\ruta\a\mi-sii-mcp\dist\interfaces\cli\bin.js" mcpCodex CLI (~/.codex/config.toml)
[mcp_servers.mi-sii-mcp]
command = "node"
args = ["C:\\ruta\\a\\mi-sii-mcp\\dist\\interfaces\\cli\\bin.js", "mcp"]VS Code con Copilot (.vscode/mcp.json)
{
"servers": {
"mi-sii-mcp": {
"type": "stdio",
"command": "node",
"args": ["C:\\ruta\\a\\mi-sii-mcp\\dist\\interfaces\\cli\\bin.js", "mcp"]
}
}
}Claude Desktop, Cursor, Gemini CLI, Windsurf, Cline (mcpServers)
{
"mcpServers": {
"mi-sii-mcp": {
"command": "node",
"args": ["C:\\ruta\\a\\mi-sii-mcp\\dist\\interfaces\\cli\\bin.js", "mcp"]
}
}
}3. Conecta tu cuenta del SII
En Windows, abre Abrir mi-sii-mcp.cmd (en macOS o Linux, npm run local). Escribe tu RUT —los puntos y el guion se ponen solos— y tu clave tributaria, deja marcado «Mantener conectada» y pulsa Conectar. Puedes conectar tu RUT personal y los de tus empresas.
4. Pregunta
Reinicia tu asistente y pregunta, por ejemplo, «lista mis perfiles» o «trae mi renta de los últimos 3 años».
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 para 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 copiar y pegar información del portal.
¿Cómo conecto Claude, Codex, Cursor o Gemini CLI al SII?
Instala mi-sii-mcp con git clone, npm install y npm run build, regístralo en tu cliente MCP con node dist/interfaces/cli/bin.js mcp y conecta tu cuenta del SII en la página local. Claude Code está probado; 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 del sistema operativo.
¿Dónde quedan mis datos tributarios?
En tu equipo, en una base SQLite en la carpeta ~/.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.
¿Es una herramienta oficial del SII?
No. Es un proyecto independiente de código abierto con licencia MIT y no reemplaza la asesoría de un contador.
¿Cuánto cuesta mi-sii-mcp?
Es gratuito y de código abierto. Solo necesitas un cliente MCP; el costo del asistente de IA depende de su proveedor.
Pregúntale a tu asistente por tus impuestos
mi-sii-mcp es gratuito y de código abierto. Revisa el código, instálalo en minutos o contribuye con mejoras.