@albertomarturelo/sii-mcp 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -9,6 +9,18 @@ Versions move in **lockstep** with `@albertomarturelo/sii-core` and
 (ADR-003), so the domain detail behind each entry lives in the
 [core changelog](../core/CHANGELOG.md).
 
+## 0.14.0 — 2026-10-21
+
+### Added
+
+- **`f22_terceros` (#183)** (`anio`, optional `dj`, `pagina`; `readOnlyHint`). Without `dj`: the
+  per-DJ resumen, one SII call. With `dj`: that DJ's rows. The description declares the
+  third-party PII the rows carry, and `pagina` without `dj` is rejected.
+
+### Fixed
+
+- **The `operate` tool's `list` shows the account's own name (#186)** after the next login.
+
 ## 0.13.0 — 2026-10-19
 
 ### Added

package/dist/tools/f22.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"f22.d.ts","sourceRoot":"","sources":["../../src/tools/f22.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAML,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAC;AAGpC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAqG1E"}
+{"version":3,"file":"f22.d.ts","sourceRoot":"","sources":["../../src/tools/f22.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAQL,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAC;AAGpC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA4I1E"}

package/dist/tools/f22.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { f22Historial, f22Observaciones, f22Overview, f22Status, ValidationError, } from '@albertomarturelo/sii-core';
+import { f22Historial, f22Observaciones, f22Overview, f22Status, f22Terceros, f22TercerosDetalle, ValidationError, } from '@albertomarturelo/sii-core';
 import { toolText } from '../tool-helpers.js';
 export function registerF22Tools(server, runtime) {
     server.registerTool('f22_status', {
@@ -75,5 +75,38 @@ export function registerF22Tools(server, runtime) {
         const r = await f22Historial(runtime, { anio, ...(folio ? { folio } : {}) });
         return JSON.stringify(r, null, 2);
     }));
+    server.registerTool('f22_terceros', {
+        title: 'F22 información de terceros (DJ de agentes retenedores e informantes)',
+        description: 'Lo que informaron al SII sobre el contribuyente sus agentes retenedores e informantes ' +
+            '(empleadores, bancos, AFP, AGF, corredoras) en sus declaraciones juradas, para un año ' +
+            'tributario (2026 = ingresos de 2025). Sirve para explicar una observación de la F22 ' +
+            '(p. ej. B102) y cuadrar antes de una rectificatoria. Sin `dj`: el resumen por DJ con sus ' +
+            'totales, UNA consulta al SII; empieza por ahí. Con `dj`: las filas de esa DJ (todas las ' +
+            'páginas de 10, hasta 30; `pagina` lee solo una), cada una con folio, declarante, fecha, ' +
+            'estado ("No Observada"…) y `campos` [{columna, valor}] según las columnas de esa DJ. ' +
+            'EXPONE DATOS DE TERCEROS: el RUT y el nombre de cada declarante, que puede ser una ' +
+            'persona natural (p. ej. un empleador). De las filas se omiten tu RUT y las columnas del ' +
+            'partícipe o aportante (tu propia identidad); tu nombre también cuando se reconoce, ' +
+            'aunque un informante puede escribirlo a su manera. Session-keyed: lee tu propia ' +
+            'información; para una empresa, inicia sesión como ella.',
+        inputSchema: {
+            anio: z.string(),
+            dj: z.string().optional(),
+            pagina: z.number().int().positive().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, ({ anio, dj, pagina }) => toolText(async () => {
+        if (dj === undefined) {
+            if (pagina !== undefined)
+                throw new ValidationError('`pagina` requiere `dj`.');
+            return JSON.stringify(await f22Terceros(runtime, { anio }), null, 2);
+        }
+        const r = await f22TercerosDetalle(runtime, {
+            anio,
+            dj,
+            ...(pagina !== undefined ? { pagina } : {}),
+        });
+        return JSON.stringify(r, null, 2);
+    }));
 }
 //# sourceMappingURL=f22.js.map

package/dist/tools/f22.js.map

@@ -1 +1 @@
-{"version":3,"file":"f22.js","sourceRoot":"","sources":["../../src/tools/f22.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"f22.js","sourceRoot":"","sources":["../../src/tools/f22.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@albertomarturelo/sii-mcp",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "type": "module",
   "description": "MCP (stdio) server for Chile's SII (tax authority): exposes authenticated reads — RCV, F29, F22, boletas de honorarios, DTE-authorized, peticiones administrativas — plus factura borradores on the Portal MIPYME (never emission) and document downloads, as tools/resources for Claude Desktop and Claude Code. Each tool is a thin call into @albertomarturelo/sii-core tasks (ADR-003).",
   "keywords": [
@@ -45,7 +45,7 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "playwright": "^1.49.0",
     "zod": "^4.4.3",
-    "@albertomarturelo/sii-core": "^0.13.0"
+    "@albertomarturelo/sii-core": "^0.14.0"
   },
   "scripts": {
     "build": "tsc -b"