@albertomarturelo/sii-mcp 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -9,6 +9,25 @@ Versions move in **lockstep** with `@albertomarturelo/sii-core` and
9
9
  (ADR-003), so the domain detail behind each entry lives in the
10
10
  [core changelog](../core/CHANGELOG.md).
11
11
 
12
+ ## 0.10.0 — 2026-09-12
13
+
14
+ ### Added
15
+
16
+ - **`carpeta_instituciones`** (`readOnlyHint`) — SII's live list of destination institutions
17
+ for the Carpeta Tributaria Regular. Its description tells the model the codes drift, so a
18
+ remembered one must be re-checked here rather than reused. A **public catalog**: the rows
19
+ are registered entities (banks, cooperatives), not taxpayer data. Session-keyed, no
20
+ arguments.
21
+ - **`auth_login` gains `www2` (boolean, optional)** — mints the second cookies-only layer the
22
+ `carpeta_*` tools need. It still takes **no password**: the tool opens SII's own OAuth page
23
+ and the user types the Clave there (ADR-006 / ADR-026). `auth_status` reports the layer and
24
+ `auth_logout` closes it.
25
+
26
+ ### Note
27
+
28
+ - A www2 tool called without that layer fails with an actionable message naming the login,
29
+ never a silent retry — the classic session can be alive while the layer is missing.
30
+
12
31
  ## 0.9.0 — 2026-09-09
13
32
 
14
33
  ### Security
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAaL,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAC;AAoBpC,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CA8JvD"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAcL,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAC;AA4BpC,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAuKvD"}
package/dist/server.js CHANGED
@@ -8,6 +8,10 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
8
8
  import { z } from 'zod';
9
9
  import { HOSTS, authStatus, describeOperating, formatOperableEntry, formatRut as fmt, listOperable, login, logout, operate, operateSelf, operatingStatus, statusRefresh, } from '@albertomarturelo/sii-core';
10
10
  import { toolText } from './tool-helpers.js';
11
+ /** One human line for the www2 app-session layer (ADR-026). */
12
+ const www2Line = (w) => w.authenticated
13
+ ? `Sesión www2: activa${w.expiresAt ? ` (hasta ${w.expiresAt})` : ''}.`
14
+ : 'Sesión www2: no iniciada (auth_login con www2=true para la Carpeta Tributaria).';
11
15
  // Domain read surfaces — each module owns a tools/<mod>.ts register fn (append-only).
12
16
  import { registerWhoamiTools } from './tools/whoami.js';
13
17
  import { registerRcvTools } from './tools/rcv.js';
@@ -16,6 +20,7 @@ import { registerF29Tools } from './tools/f29.js';
16
20
  import { registerDteTools } from './tools/dte.js';
17
21
  import { registerBteTools } from './tools/bte.js';
18
22
  import { registerPeticionesTools } from './tools/peticiones.js';
23
+ import { registerCarpetaTools } from './tools/carpeta.js';
19
24
  const jsonResource = (uri, value) => ({
20
25
  contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(value, null, 2) }],
21
26
  });
@@ -55,13 +60,17 @@ export function buildServer(runtime) {
55
60
  server.registerTool('auth_login', {
56
61
  title: 'Iniciar sesión (navegador)',
57
62
  description: 'Abre el navegador en la página del SII para que el usuario escriba su Clave Tributaria. ' +
58
- 'NUNCA recibe la Clave como argumento (ADR-006); persiste solo cookies. Idempotente sobre una sesión viva.',
63
+ 'NUNCA recibe la Clave como argumento (ADR-006); persiste solo cookies. Idempotente sobre una sesión viva. ' +
64
+ 'www2=true añade además la sesión de la plataforma www2 (necesaria para carpeta_*): el mismo ' +
65
+ 'navegador abre la página OAuth del SII y el usuario vuelve a escribir su Clave ahí (ADR-026).',
66
+ inputSchema: { www2: z.boolean().optional() },
59
67
  annotations: { readOnlyHint: false, openWorldHint: true },
60
- }, () => toolText(async () => {
61
- const r = await login(runtime);
62
- return r.reason === 'already_authenticated'
68
+ }, ({ www2 }) => toolText(async () => {
69
+ const r = await login(runtime, www2 ? { www2: true } : {});
70
+ const head = r.reason === 'already_authenticated'
63
71
  ? `Ya tienes una sesión activa como ${fmt(r.rut)}.`
64
72
  : `Sesión iniciada como ${fmt(r.rut)}.`;
73
+ return r.www2 ? `${head}\n${www2Line(r.www2)}` : head;
65
74
  }));
66
75
  server.registerTool('auth_status', {
67
76
  title: 'Estado de sesión',
@@ -71,14 +80,14 @@ export function buildServer(runtime) {
71
80
  }, ({ refresh }) => toolText(async () => {
72
81
  if (refresh) {
73
82
  const id = await statusRefresh(runtime);
74
- return `RUT: ${fmt(id.rut)}\nNombre: ${id.nombre ?? '—'}\nTipo: ${id.accountType}`;
83
+ return `RUT: ${fmt(id.rut)}\nNombre: ${id.nombre ?? '—'}\nTipo: ${id.accountType}\n${www2Line(id.www2)}`;
75
84
  }
76
85
  const s = await authStatus(runtime);
77
86
  if (!s.authenticated || !s.rut)
78
87
  return 'No autenticado. Usa la tool auth_login.';
79
88
  const ctx = await operatingStatus(runtime);
80
89
  const op = ctx && !ctx.isSelf ? `\n${describeOperating(ctx)}` : '';
81
- return `Autenticado (sesión local) como ${fmt(s.rut)}.${op}`;
90
+ return `Autenticado (sesión local) como ${fmt(s.rut)}.${op}\n${www2Line(s.www2)}`;
82
91
  }));
83
92
  // logout carries NO secret (best-effort server close + local cookie wipe), so
84
93
  // ADR-006 does not bar it from MCP — switching accounts is logout→login (ADR-005).
@@ -92,7 +101,10 @@ export function buildServer(runtime) {
92
101
  const r = await logout(runtime);
93
102
  if (!r.loggedOut)
94
103
  return 'No había sesión activa.';
95
- return r.serverClosed ? 'Sesión cerrada (servidor y local).' : 'Sesión cerrada (local).';
104
+ const head = r.serverClosed
105
+ ? 'Sesión cerrada (servidor y local).'
106
+ : 'Sesión cerrada (local).';
107
+ return r.www2Closed ? `${head} Sesión www2 cerrada.` : head;
96
108
  }));
97
109
  server.registerTool('operate', {
98
110
  title: 'Operar como',
@@ -129,6 +141,7 @@ export function buildServer(runtime) {
129
141
  registerDteTools(server, runtime);
130
142
  registerBteTools(server, runtime);
131
143
  registerPeticionesTools(server, runtime);
144
+ registerCarpetaTools(server, runtime);
132
145
  return server;
133
146
  }
134
147
  //# sourceMappingURL=server.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { type Runtime } from '@albertomarturelo/sii-core';
3
+ export declare function registerCarpetaTools(server: McpServer, runtime: Runtime): void;
4
+ //# sourceMappingURL=carpeta.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"carpeta.d.ts","sourceRoot":"","sources":["../../src/tools/carpeta.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAGhF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB9E"}
@@ -0,0 +1,17 @@
1
+ import { carpetaInstituciones } from '@albertomarturelo/sii-core';
2
+ import { toolText } from '../tool-helpers.js';
3
+ export function registerCarpetaTools(server, runtime) {
4
+ server.registerTool('carpeta_instituciones', {
5
+ title: 'Carpeta Tributaria — instituciones destinatarias',
6
+ description: 'Lista VIGENTE de las instituciones a las que puede dirigirse una Carpeta Tributaria ' +
7
+ 'Regular (bancos, cooperativas, etc.): [{codigo, descripcion, abreviacion}]. `codigo` es ' +
8
+ 'el valor que exige `carpeta_regular` como institución destinataria; los códigos cambian ' +
9
+ 'con el tiempo, así que se leen del SII en cada llamada — no uses un código recordado sin ' +
10
+ 'confirmarlo aquí. Catálogo público: no expone datos del contribuyente. Session-keyed: ' +
11
+ 'requiere sesión; para una empresa, inicia sesión como ella. Necesita además la sesión ' +
12
+ 'www2 del SII (ADR-026); si falta, el error lo indica.',
13
+ inputSchema: {},
14
+ annotations: { readOnlyHint: true },
15
+ }, () => toolText(async () => JSON.stringify(await carpetaInstituciones(runtime), null, 2)));
16
+ }
17
+ //# sourceMappingURL=carpeta.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"carpeta.js","sourceRoot":"","sources":["../../src/tools/carpeta.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAgB,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,OAAgB;IACtE,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,kDAAkD;QACzD,WAAW,EACT,sFAAsF;YACtF,0FAA0F;YAC1F,0FAA0F;YAC1F,2FAA2F;YAC3F,wFAAwF;YACxF,wFAAwF;YACxF,uDAAuD;QACzD,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,oBAAoB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CACzF,CAAC;AACJ,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@albertomarturelo/sii-mcp",
3
- "version": "0.9.0",
3
+ "version": "0.10.0",
4
4
  "type": "module",
5
5
  "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).",
6
6
  "keywords": [
@@ -45,7 +45,7 @@
45
45
  "@modelcontextprotocol/sdk": "^1.0.0",
46
46
  "playwright": "^1.49.0",
47
47
  "zod": "^4.4.3",
48
- "@albertomarturelo/sii-core": "^0.9.0"
48
+ "@albertomarturelo/sii-core": "^0.10.0"
49
49
  },
50
50
  "scripts": {
51
51
  "build": "tsc -b"