@albertomarturelo/sii-mcp 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alberto Marturelo Lorenzo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# @albertomarturelo/sii-mcp
+
+**MCP (Model Context Protocol) server** — over stdio — that exposes Chile's **SII**
+(Servicio de Impuestos Internos) to **Claude Desktop** and **Claude Code**.
+Authenticated **reads** — RCV, F22, F29, boletas de honorarios (BHE),
+DTE-authorized (public), peticiones administrativas, whoami — as `readOnly` tools,
+plus a `destructive`, confirm-gated BHE **emit**. A thin surface over
+[`@albertomarturelo/sii-core`](https://www.npmjs.com/package/@albertomarturelo/sii-core);
+all the guardrails live in the core, and **no tool ever receives your password**
+(login delegates to a browser flow — ADR-006).
+
+> ⚠️ **Unofficial.** Not affiliated with or endorsed by the SII. Provided "as is"
+> (MIT, no warranty). You are responsible for the SII's terms of service and
+> Chilean law.
+
+## Install
+
+```bash
+npm i -g @albertomarturelo/sii-mcp @albertomarturelo/sii-cli
+# the browser login needs Chromium once (~100–150 MB):
+npx playwright install chromium
+```
+
+Requires **Node ≥ 20**. (The `sii` CLI is handy for the first `sii auth login`;
+the login can also run through the `auth_login` tool.)
+
+## Connect to Claude
+
+**Claude Desktop** — add to `claude_desktop_config.json` and restart the app
+(macOS: `~/Library/Application Support/Claude/`; Windows: `%APPDATA%\Claude\`):
+
+```json
+{
+  "mcpServers": {
+    "sii": { "command": "sii-mcp" }
+  }
+}
+```
+
+**Claude Code**:
+
+```bash
+claude mcp add sii -- sii-mcp
+```
+
+Then ask in natural language — e.g. «muéstrame el RCV de compras de 2026-05» or
+«¿tengo peticiones administrativas detenidas?». Read tools change nothing; issuing
+a BHE (`bte_emit`) requires an explicit confirmation + amount echo.
+
+Tools, resources, prompts, and the identity model are documented in the
+[project README](https://github.com/albertomarturelo/sii#readme).
+
+## License
+
+[MIT](./LICENSE) © Alberto Marturelo Lorenzo.

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+// @albertomarturelo/sii-mcp entry point. Wires the Node runtime into the server and serves over
+// stdio. STDOUT is the JSON-RPC channel — diagnostics go to STDERR only.
+import { createNodeRuntime } from '@albertomarturelo/sii-core/node';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { buildServer } from './server.js';
+async function main() {
+    const server = buildServer(createNodeRuntime());
+    await server.connect(new StdioServerTransport());
+}
+main().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,gGAAgG;AAChG,yEAAyE;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,WAAW,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChD,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Runtime } from '@albertomarturelo/sii-core';
+/** Build the MCP server over an injected Runtime (tests pass fakes; no SII). */
+export declare function buildServer(runtime: Runtime): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +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"}

package/dist/server.js

@@ -0,0 +1,134 @@
+// The `sii` MCP stdio server (ADR-003): every Resource/Tool is a thin call into a
+// @albertomarturelo/sii-core task — it never reaches past the task layer. The Clave NEVER crosses
+// this boundary: auth_login delegates to the browser flow and takes no password
+// argument (ADR-006). consoleLogin is deliberately unreachable here — it lives in
+// the CLI-only `@albertomarturelo/sii-core/cli` subpath, which this package never imports.
+import { createRequire } from 'node:module';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { HOSTS, authStatus, describeOperating, formatOperableEntry, formatRut as fmt, listOperable, login, logout, operate, operateSelf, operatingStatus, statusRefresh, } from '@albertomarturelo/sii-core';
+import { toolText } from './tool-helpers.js';
+// Domain read surfaces — each module owns a tools/<mod>.ts register fn (append-only).
+import { registerWhoamiTools } from './tools/whoami.js';
+import { registerRcvTools } from './tools/rcv.js';
+import { registerF22Tools } from './tools/f22.js';
+import { registerF29Tools } from './tools/f29.js';
+import { registerDteTools } from './tools/dte.js';
+import { registerBteTools } from './tools/bte.js';
+import { registerPeticionesTools } from './tools/peticiones.js';
+const jsonResource = (uri, value) => ({
+    contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(value, null, 2) }],
+});
+// The published version, read from this package's own package.json at runtime (one
+// level up from dist/) so the MCP handshake reports the real release, never drifting.
+const pkgVersion = createRequire(import.meta.url)('../package.json')
+    .version;
+/** Build the MCP server over an injected Runtime (tests pass fakes; no SII). */
+export function buildServer(runtime) {
+    const server = new McpServer({ name: 'sii', version: pkgVersion });
+    // --- Resources: read-only context the model reads to orient (ROADMAP) ---
+    server.registerResource('session', 'sii://session', {
+        title: 'Sesión SII',
+        description: 'Estado LOCAL de la sesión (autenticado, RUT, fuente). No toca el portal.',
+        mimeType: 'application/json',
+    }, async (uri) => jsonResource(uri, await authStatus(runtime)));
+    server.registerResource('operating', 'sii://operating', {
+        title: 'Operando como',
+        description: 'RUT operativo actual (tú mismo o una empresa representada). null si no hay sesión.',
+        mimeType: 'application/json',
+    }, async (uri) => jsonResource(uri, await operatingStatus(runtime)));
+    server.registerResource('operable', 'sii://operable', {
+        title: 'Conjunto operable',
+        description: 'RUT que la cuenta puede operar (tú mismo + empresas representadas). null si no hay sesión.',
+        mimeType: 'application/json',
+    }, async (uri) => jsonResource(uri, await listOperable(runtime)));
+    server.registerResource('config', 'sii://config', {
+        title: 'Configuración SII',
+        description: 'Hostnames de producción del SII (única fuente de verdad, ADR-004).',
+        mimeType: 'application/json',
+    }, async (uri) => jsonResource(uri, HOSTS));
+    // --- Tools: actions, each a thin call into a @albertomarturelo/sii-core task ---
+    // NOTE: auth_login can block up to the browser-login budget (~180s) while the
+    // user types the Clave into SII's page. Some MCP clients enforce a shorter
+    // tool-call timeout — confirm/tune the budget when live-validating in Claude
+    // Desktop (a credential-free, CLI-only fast path stays out of MCP by design).
+    server.registerTool('auth_login', {
+        title: 'Iniciar sesión (navegador)',
+        description: 'Abre el navegador en la página del SII para que el usuario escriba su Clave Tributaria. ' +
+            'NUNCA recibe la Clave como argumento (ADR-006); persiste solo cookies. Idempotente sobre una sesión viva.',
+        annotations: { readOnlyHint: false, openWorldHint: true },
+    }, () => toolText(async () => {
+        const r = await login(runtime);
+        return r.reason === 'already_authenticated'
+            ? `Ya tienes una sesión activa como ${fmt(r.rut)}.`
+            : `Sesión iniciada como ${fmt(r.rut)}.`;
+    }));
+    server.registerTool('auth_status', {
+        title: 'Estado de sesión',
+        description: 'Lectura LOCAL de la sesión (quién soy, operando-como). refresh=true lee la identidad desde el portal (requiere sesión viva).',
+        inputSchema: { refresh: z.boolean().optional() },
+        annotations: { readOnlyHint: true },
+    }, ({ refresh }) => toolText(async () => {
+        if (refresh) {
+            const id = await statusRefresh(runtime);
+            return `RUT: ${fmt(id.rut)}\nNombre: ${id.nombre ?? '—'}\nTipo: ${id.accountType}`;
+        }
+        const s = await authStatus(runtime);
+        if (!s.authenticated || !s.rut)
+            return 'No autenticado. Usa la tool auth_login.';
+        const ctx = await operatingStatus(runtime);
+        const op = ctx && !ctx.isSelf ? `\n${describeOperating(ctx)}` : '';
+        return `Autenticado (sesión local) como ${fmt(s.rut)}.${op}`;
+    }));
+    // logout carries NO secret (best-effort server close + local cookie wipe), so
+    // ADR-006 does not bar it from MCP — switching accounts is logout→login (ADR-005).
+    server.registerTool('auth_logout', {
+        title: 'Cerrar sesión',
+        description: 'Cierra la sesión: intenta cerrarla en el servidor (mejor esfuerzo) y borra las cookies locales. ' +
+            'No recibe argumentos. Para cambiar de cuenta: auth_logout y luego auth_login.',
+        // Touches SII: the best-effort server-side close is a real portal call (like auth_login).
+        annotations: { readOnlyHint: false, openWorldHint: true },
+    }, () => toolText(async () => {
+        const r = await logout(runtime);
+        if (!r.loggedOut)
+            return 'No había sesión activa.';
+        return r.serverClosed ? 'Sesión cerrada (servidor y local).' : 'Sesión cerrada (local).';
+    }));
+    server.registerTool('operate', {
+        title: 'Operar como',
+        description: 'Selecciona el RUT bajo el que operas: una empresa representada (rut) o tú mismo (self=true). ' +
+            'list=true LISTA los RUT que puedes operar (tú mismo + empresas representadas). ' +
+            'Validado contra el conjunto operable. Sin argumentos, reporta el contexto actual.',
+        inputSchema: {
+            rut: z.string().optional(),
+            self: z.boolean().optional(),
+            list: z.boolean().optional(),
+        },
+        annotations: { readOnlyHint: false },
+    }, ({ rut, self, list }) => toolText(async () => {
+        if (list) {
+            const result = await listOperable(runtime);
+            if (!result)
+                return 'No hay sesión activa. Usa la tool auth_login.';
+            return result.operable.map((e) => formatOperableEntry(e, result.operatingRut)).join('\n');
+        }
+        if (self) {
+            const r = await operateSelf(runtime);
+            return describeOperating(r.context);
+        }
+        if (rut)
+            return describeOperating((await operate(runtime, rut)).context);
+        const ctx = await operatingStatus(runtime);
+        return ctx ? describeOperating(ctx) : 'No hay sesión activa. Usa la tool auth_login.';
+    }));
+    // --- domain read surfaces (one register call per module — append-only) ---
+    registerWhoamiTools(server, runtime);
+    registerRcvTools(server, runtime);
+    registerF22Tools(server, runtime);
+    registerF29Tools(server, runtime);
+    registerDteTools(server, runtime);
+    registerBteTools(server, runtime);
+    registerPeticionesTools(server, runtime);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tool-helpers.d.ts

@@ -0,0 +1,10 @@
+/** Run a task and wrap its text as a tool result; domain errors come back as an
+ *  error result carrying SII's Spanish message verbatim (CONVENTIONS). */
+export declare function toolText(fn: () => Promise<string>): Promise<{
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+}>;
+//# sourceMappingURL=tool-helpers.d.ts.map

package/dist/tool-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../src/tool-helpers.ts"],"names":[],"mappings":"AAMA;0EAC0E;AAC1E,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IACjE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAMD"}

package/dist/tool-helpers.js

@@ -0,0 +1,15 @@
+// Shared MCP tool helpers. Each domain module owns a `tools/<mod>.ts` exporting a
+// `register<Mod>Tools(server, runtime)`; they all reuse `toolText` so SII's Spanish
+// error messages surface verbatim and the registration stays uniform across modules.
+const messageOf = (e) => (e instanceof Error ? e.message : String(e));
+/** Run a task and wrap its text as a tool result; domain errors come back as an
+ *  error result carrying SII's Spanish message verbatim (CONVENTIONS). */
+export async function toolText(fn) {
+    try {
+        return { content: [{ type: 'text', text: await fn() }] };
+    }
+    catch (e) {
+        return { content: [{ type: 'text', text: messageOf(e) }], isError: true };
+    }
+}
+//# sourceMappingURL=tool-helpers.js.map

package/dist/tool-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.js","sourceRoot":"","sources":["../src/tool-helpers.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,oFAAoF;AACpF,qFAAqF;AAErF,MAAM,SAAS,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvF;0EAC0E;AAC1E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAyB;IAItD,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/tools/bte.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Runtime } from '@albertomarturelo/sii-core';
+export declare function registerBteTools(server: McpServer, runtime: Runtime): void;
+//# sourceMappingURL=bte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bte.d.ts","sourceRoot":"","sources":["../../src/tools/bte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAOL,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAC;AAgDpC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAwE1E"}

package/dist/tools/bte.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { bteEmit, bteEmitPreview, bteList, } from '@albertomarturelo/sii-core';
+import { toolText } from '../tool-helpers.js';
+const sideOf = (recibidas) => (recibidas ? 'RECIBIDAS' : 'EMITIDAS');
+// Shared emit input fields (zod raw shape). The emisor fields are read from the live form; the
+// caller supplies only receptor + líneas + fecha + who-withholds.
+const emitFields = {
+    receptor: z.string(),
+    nombre: z.string(),
+    domicilio: z.string(),
+    region: z.number().int(),
+    comuna: z.number().int(),
+    lineas: z
+        .array(z.object({ glosa: z.string(), monto: z.number().int().positive() }))
+        .min(1)
+        .max(4),
+    fecha: z
+        .object({ dia: z.number().int(), mes: z.number().int(), anio: z.number().int() })
+        .optional(),
+    retiene: z.enum(['receptor', 'emisor']),
+    mostrarDetalle: z.boolean().optional(),
+};
+const toArgs = (i) => ({
+    receptor: i.receptor,
+    receptorNombre: i.nombre,
+    receptorDomicilio: i.domicilio,
+    region: i.region,
+    comuna: i.comuna,
+    lineas: i.lineas,
+    retiene: (i.retiene === 'emisor' ? 'EMISOR' : 'RECEPTOR'),
+    ...(i.fecha ? { fecha: i.fecha } : {}),
+    ...(i.mostrarDetalle !== undefined ? { mostrarDetalle: i.mostrarDetalle } : {}),
+});
+export function registerBteTools(server, runtime) {
+    server.registerTool('bte_list', {
+        title: 'BHE/BTE — boletas de honorarios',
+        description: 'Lista las boletas de honorarios electrónicas de un período (YYYYMM/YYYY-MM). ' +
+            'EMITIDAS por defecto; recibidas=true para las RECIBIDAS. SESSION-KEYED: lee SIEMPRE el ' +
+            'titular de la sesión (no acepta otro RUT; para las BHE de una empresa, inicia sesión como ella).',
+        inputSchema: { periodo: z.string(), recibidas: z.boolean().optional() },
+        annotations: { readOnlyHint: true },
+    }, ({ periodo, recibidas }) => toolText(async () => JSON.stringify(await bteList(runtime, { periodo, side: sideOf(recibidas) }), null, 2)));
+    // --- emit preview (does NOT issue) — safe to call freely ---
+    server.registerTool('bte_emit_preview', {
+        title: 'BHE — vista previa de emisión (NO emite)',
+        description: 'Calcula una boleta de honorarios (total, retención de PPM y líquido) SIN EMITIRLA. Usa ' +
+            'esto para cotizar/preparar antes de emitir. Recibe: receptor (RUT), nombre, domicilio, ' +
+            'region+comuna (códigos SII), lineas [{glosa, monto bruto}] (1–4), retiene ' +
+            '("receptor"|"emisor"), fecha opcional. SESSION-KEYED: emite como el titular de la sesión.',
+        inputSchema: emitFields,
+        annotations: { readOnlyHint: true },
+    }, (input) => toolText(async () => JSON.stringify(await bteEmitPreview(runtime, toArgs(input)), null, 2)));
+    // --- emit (ISSUES a legally-binding boleta) — destructive, requires explicit confirmation ---
+    server.registerTool('bte_emit', {
+        title: 'BHE — EMITIR boleta de honorarios (acto legal)',
+        description: 'EMITE una boleta de honorarios electrónica: un DOCUMENTO CON VALOR LEGAL, reportado al SII ' +
+            'y que solo se revierte con una anulación posterior. Llama primero a bte_emit_preview y ' +
+            'muéstrale al usuario el total/retención/líquido. Para emitir DEBES pasar confirmar=true y ' +
+            'montoTotalConfirmacion = la suma exacta de los montos brutos (doble verificación). ' +
+            'Devuelve el código de barras (folio) + el PDF. SESSION-KEYED. Opcional: enviarA (email).',
+        inputSchema: {
+            ...emitFields,
+            confirmar: z.literal(true),
+            montoTotalConfirmacion: z.number().int(),
+            enviarA: z.string().optional(),
+            copiaEmisor: z.boolean().optional(),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+    }, (input) => toolText(async () => {
+        const total = input.lineas.reduce((s, l) => s + l.monto, 0);
+        if (input.montoTotalConfirmacion !== total) {
+            throw new Error(`montoTotalConfirmacion (${input.montoTotalConfirmacion}) no coincide con la suma de ` +
+                `los montos brutos (${total}). Repite el total exacto para emitir.`);
+        }
+        const args = {
+            ...toArgs(input),
+            ...(input.enviarA ? { enviarA: input.enviarA } : {}),
+            ...(input.copiaEmisor !== undefined ? { copiaEmisor: input.copiaEmisor } : {}),
+        };
+        return JSON.stringify(await bteEmit(runtime, args), null, 2);
+    }));
+}
+//# sourceMappingURL=bte.js.map

package/dist/tools/bte.js.map

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

package/dist/tools/dte.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Runtime } from '@albertomarturelo/sii-core';
+export declare function registerDteTools(server: McpServer, runtime: Runtime): void;
+//# sourceMappingURL=dte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dte.d.ts","sourceRoot":"","sources":["../../src/tools/dte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAGzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAgB1E"}

package/dist/tools/dte.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { dteAuthorized } from '@albertomarturelo/sii-core';
+import { toolText } from '../tool-helpers.js';
+export function registerDteTools(server, runtime) {
+    server.registerTool('dte_authorized', {
+        title: 'DTE autorizados (consulta pública)',
+        description: 'Consulta PÚBLICA (sin login) de los tipos de DTE que un RUT está autorizado a emitir. ' +
+            'Funciona para CUALQUIER RUT (no requiere sesión, no toca ninguna cuenta). Devuelve el ' +
+            'detalle curado (razón social, resolución, documentos autorizados) o, si el RUT no es ' +
+            'emisor, autorizado=false con el mensaje verbatim del SII.',
+        inputSchema: { rut: z.string() },
+        annotations: { readOnlyHint: true },
+    }, ({ rut }) => toolText(async () => JSON.stringify(await dteAuthorized(runtime, { rut }), null, 2)));
+}
+//# sourceMappingURL=dte.js.map

package/dist/tools/dte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dte.js","sourceRoot":"","sources":["../../src/tools/dte.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAgB,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,OAAgB;IAClE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,oCAAoC;QAC3C,WAAW,EACT,wFAAwF;YACxF,wFAAwF;YACxF,uFAAuF;YACvF,2DAA2D;QAC7D,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QAChC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CACV,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CACvF,CAAC;AACJ,CAAC"}

package/dist/tools/f22.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Runtime } from '@albertomarturelo/sii-core';
+export declare function registerF22Tools(server: McpServer, runtime: Runtime): void;
+//# sourceMappingURL=f22.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/f22.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { f22Historial, f22Observaciones, f22Overview, f22Status, ValidationError, } from '@albertomarturelo/sii-core';
+import { toolText } from '../tool-helpers.js';
+export function registerF22Tools(server, runtime) {
+    server.registerTool('f22_status', {
+        title: 'F22 estado (Renta anual)',
+        description: 'Estado de la Declaración Anual de Renta (F22). CON `anio` (YYYY): detalle del año ' +
+            '(folio/estado + grilla de códigos curada, sin PII de identidad/banco). SIN `anio`: ' +
+            'resumen multi-año del estado. Para el formulario completo agrupado usa `f22_formulario`. ' +
+            'Session-keyed: lee tu propia renta; para una empresa, inicia sesión como ella.',
+        inputSchema: {
+            anio: z.string().optional(),
+            folio: z.string().optional(),
+            years: z.number().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, ({ anio, folio, years }) => toolText(async () => {
+        if (anio === undefined) {
+            // `folio` selects a declaración within a year; meaningless for the overview.
+            if (folio !== undefined) {
+                throw new ValidationError('`folio` requiere indicar `anio` (YYYY).');
+            }
+            const ov = await f22Overview(runtime, years !== undefined ? { years } : {});
+            return JSON.stringify(ov, null, 2);
+        }
+        const e = await f22Status(runtime, { anio, ...(folio ? { folio } : {}) });
+        return JSON.stringify(e, null, 2);
+    }));
+    server.registerTool('f22_formulario', {
+        title: 'F22 formulario completo (Renta anual)',
+        description: 'El formulario completo de la Declaración Anual de Renta (F22) de un año, sin PII de ' +
+            'identidad/banco, agrupado en `grupos`: `ingresos`, `deducciones`, `creditos` ' +
+            '(grupo COMBINADO retenciones·PPM·créditos — p.ej. 162 es crédito/retención IUSC de ' +
+            'origen, 36/1905 son PPM), `calculo` (subtotales intermedios del IGC/IUSC: 157/158/304, ' +
+            'no son resultados finales), `resultado` (desenlaces finales: impuesto/devolución/giro) ' +
+            'y `otros` (red de seguridad: cualquier código tributario no-PII aún sin clasificar; ' +
+            'vacío = todos clasificados, nunca se oculta nada). La unión de los seis = la grilla ' +
+            'completa. Session-keyed: lee tu propia renta; para una empresa, inicia sesión como ella.',
+        inputSchema: {
+            anio: z.string(),
+            folio: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, ({ anio, folio }) => toolText(async () => {
+        const e = await f22Status(runtime, { anio, full: true, ...(folio ? { folio } : {}) });
+        return JSON.stringify(e, null, 2);
+    }));
+    server.registerTool('f22_observaciones', {
+        title: 'F22 observaciones (inconsistencias)',
+        description: 'Observaciones/inconsistencias de la Declaración Anual de Renta (F22) de un año: ' +
+            'código (B102, G37…), glosa y URL de ayuda del SII para corregir. Session-keyed: ' +
+            'lee tu propia renta; para una empresa, inicia sesión como ella.',
+        inputSchema: {
+            anio: z.string(),
+            folio: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, ({ anio, folio }) => toolText(async () => {
+        const r = await f22Observaciones(runtime, { anio, ...(folio ? { folio } : {}) });
+        return JSON.stringify(r, null, 2);
+    }));
+    server.registerTool('f22_historial', {
+        title: 'F22 historial (eventos de Renta anual)',
+        description: 'Historial de eventos de la Declaración Anual de Renta (F22) de un año: la línea de ' +
+            'tiempo (declaración recibida, devolución autorizada, giros de Tesorería, ' +
+            'rectificatorias) con fecha y glosa verbatim del SII, más reciente primero. Por ' +
+            'defecto cubre todos los folios del año; `folio` acota a uno. Session-keyed: lee tu ' +
+            'propia renta; para una empresa, inicia sesión como ella.',
+        inputSchema: {
+            anio: z.string(),
+            folio: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, ({ anio, folio }) => toolText(async () => {
+        const r = await f22Historial(runtime, { anio, ...(folio ? { folio } : {}) });
+        return JSON.stringify(r, null, 2);
+    }));
+}
+//# sourceMappingURL=f22.js.map

package/dist/tools/f22.js.map

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

package/dist/tools/f29.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Runtime } from '@albertomarturelo/sii-core';
+export declare function registerF29Tools(server: McpServer, runtime: Runtime): void;
+//# sourceMappingURL=f29.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"f29.d.ts","sourceRoot":"","sources":["../../src/tools/f29.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAyC,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAGjG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAsD1E"}

package/dist/tools/f29.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { f29Formulario, f29Overview, f29Status } from '@albertomarturelo/sii-core';
+import { toolText } from '../tool-helpers.js';
+export function registerF29Tools(server, runtime) {
+    server.registerTool('f29_formulario', {
+        title: 'F29 formulario (propuesta IVA, agrupado)',
+        description: 'Propuesta de IVA de un período (YYYYMM o YYYY-MM): los códigos del F29 etiquetados con ' +
+            'su glosa y agrupados (débitos/ventas, créditos/compras, retenciones·PPM, otros, ' +
+            'determinación). `fuente: "propuesta"` — es la sugerencia del SII, no el formulario ' +
+            'presentado. Session-keyed: lee tu propio F29; para una empresa, inicia sesión como ella.',
+        inputSchema: { periodo: z.string() },
+        annotations: { readOnlyHint: true },
+    }, ({ periodo }) => toolText(async () => JSON.stringify(await f29Formulario(runtime, { periodo }), null, 2)));
+    server.registerTool('f29_overview', {
+        title: 'F29 overview (posición IVA por mes)',
+        description: 'Posición de IVA por mes en un rango: por cada mes, estado, folio, fecha y el total a ' +
+            'pagar declarado ("lo que pagué"). Indica el rango con `desde`/`hasta` (YYYY-MM) o con ' +
+            '`anio` (YYYY) para el año completo; sin argumentos, el año en curso a la fecha. ' +
+            'Session-keyed: lee tu propio F29.',
+        inputSchema: {
+            desde: z.string().optional(),
+            hasta: z.string().optional(),
+            anio: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, ({ desde, hasta, anio }) => 
+    // Range semantics live in the task (one policy for CLI + MCP): `anio` → whole
+    // year; `desde` alone → that month; nothing → current calendar year to date.
+    toolText(async () => JSON.stringify(await f29Overview(runtime, { desde, hasta, anio }), null, 2)));
+    server.registerTool('f29_status', {
+        title: 'F29 estado (declaraciones del mes)',
+        description: 'Estado de las declaraciones F29 presentadas/guardadas de un período (YYYYMM o YYYY-MM): ' +
+            'estado, folio, fecha y total. Vacío = nada presentado. Session-keyed: lee tu propio F29.',
+        inputSchema: { periodo: z.string() },
+        annotations: { readOnlyHint: true },
+    }, ({ periodo }) => toolText(async () => JSON.stringify(await f29Status(runtime, { periodo }), null, 2)));
+}
+//# sourceMappingURL=f29.js.map

package/dist/tools/f29.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"f29.js","sourceRoot":"","sources":["../../src/tools/f29.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAgB,MAAM,4BAA4B,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,OAAgB;IAClE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,0CAA0C;QACjD,WAAW,EACT,yFAAyF;YACzF,kFAAkF;YAClF,qFAAqF;YACrF,0FAA0F;QAC5F,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QACpC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACd,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,aAAa,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAC3F,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EACT,uFAAuF;YACvF,wFAAwF;YACxF,kFAAkF;YAClF,mCAAmC;QACrC,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC5B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;IACzB,8EAA8E;IAC9E,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,IAAI,EAAE,CAClB,IAAI,CAAC,SAAS,CAAC,MAAM,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAC5E,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,oCAAoC;QAC3C,WAAW,EACT,0FAA0F;YAC1F,0FAA0F;QAC5F,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QACpC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACd,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,SAAS,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CACvF,CAAC;AACJ,CAAC"}

package/dist/tools/peticiones.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Runtime } from '@albertomarturelo/sii-core';
+export declare function registerPeticionesTools(server: McpServer, runtime: Runtime): void;
+//# sourceMappingURL=peticiones.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"peticiones.d.ts","sourceRoot":"","sources":["../../src/tools/peticiones.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAK1E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBjF"}

package/dist/tools/peticiones.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { peticionesList } from '@albertomarturelo/sii-core';
+import { toolText } from '../tool-helpers.js';
+const rutOpt = (rut) => (rut ? { rut } : {});
+export function registerPeticionesTools(server, runtime) {
+    server.registerTool('peticiones_list', {
+        title: 'Peticiones administrativas',
+        description: 'Lista las peticiones administrativas del contribuyente ante el SII (SISPAD) con su ' +
+            'timeline de estados (ingresada → … → cerrada) y las fechas. Útil para detectar ' +
+            'trámites detenidos, p. ej. "Peticion en espera de Antecedentes" (el SII espera algo ' +
+            'del contribuyente). Devuelve número, materia, estado actual y el historial; incluye ' +
+            'el mensaje textual del SII cuando existe (qué falta / por qué). Body-RUT: usa rut ' +
+            'para una empresa representada. Expone datos personales/tributarios del contribuyente.',
+        inputSchema: {
+            rut: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, ({ rut }) => toolText(async () => JSON.stringify(await peticionesList(runtime, rutOpt(rut)), null, 2)));
+}
+//# sourceMappingURL=peticiones.js.map

package/dist/tools/peticiones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peticiones.js","sourceRoot":"","sources":["../../src/tools/peticiones.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAgB,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,MAAM,GAAG,CAAC,GAAY,EAAoB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAExE,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,OAAgB;IACzE,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,qFAAqF;YACrF,iFAAiF;YACjF,sFAAsF;YACtF,sFAAsF;YACtF,oFAAoF;YACpF,uFAAuF;QACzF,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC3B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CACV,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAC5F,CAAC;AACJ,CAAC"}

package/dist/tools/rcv.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Runtime } from '@albertomarturelo/sii-core';
+export declare function registerRcvTools(server: McpServer, runtime: Runtime): void;
+//# sourceMappingURL=rcv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rcv.d.ts","sourceRoot":"","sources":["../../src/tools/rcv.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAqC,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAO7F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAiD1E"}

package/dist/tools/rcv.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { rcvList, rcvSummary } from '@albertomarturelo/sii-core';
+import { toolText } from '../tool-helpers.js';
+const sideOf = (venta) => (venta ? 'VENTA' : 'COMPRA');
+// exactOptionalPropertyTypes: only carry `rut` when the override was passed.
+const rutOpt = (rut) => (rut ? { rut } : {});
+export function registerRcvTools(server, runtime) {
+    server.registerTool('rcv_summary', {
+        title: 'RCV resumen',
+        description: 'Resumen del Registro de Compras y Ventas por tipo de documento, para un período (YYYYMM/YYYY-MM). ' +
+            'COMPRAS por defecto; venta=true para VENTAS. Body-RUT: usa rut para una empresa representada.',
+        inputSchema: {
+            periodo: z.string(),
+            venta: z.boolean().optional(),
+            rut: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, ({ periodo, venta, rut }) => toolText(async () => JSON.stringify(await rcvSummary(runtime, { periodo, side: sideOf(venta), ...rutOpt(rut) }), null, 2)));
+    server.registerTool('rcv_list', {
+        title: 'RCV detalle',
+        description: 'Detalle de documentos de un tipo (codigoTipoDoc, ej. "33") del RCV para un período. ' +
+            'COMPRAS por defecto; venta=true para VENTAS. Body-RUT: usa rut para una empresa representada.',
+        inputSchema: {
+            periodo: z.string(),
+            codigoTipoDoc: z.string(),
+            venta: z.boolean().optional(),
+            rut: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, ({ periodo, codigoTipoDoc, venta, rut }) => toolText(async () => JSON.stringify(await rcvList(runtime, { periodo, side: sideOf(venta), codigoTipoDoc, ...rutOpt(rut) }), null, 2)));
+}
+//# sourceMappingURL=rcv.js.map

package/dist/tools/rcv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rcv.js","sourceRoot":"","sources":["../../src/tools/rcv.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,UAAU,EAA8B,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,MAAM,GAAG,CAAC,KAAe,EAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC1E,6EAA6E;AAC7E,MAAM,MAAM,GAAG,CAAC,GAAY,EAAoB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAExE,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,OAAgB;IAClE,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,oGAAoG;YACpG,+FAA+F;QACjG,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC7B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC3B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAC1B,QAAQ,CAAC,KAAK,IAAI,EAAE,CAClB,IAAI,CAAC,SAAS,CACZ,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAC3E,IAAI,EACJ,CAAC,CACF,CACF,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,sFAAsF;YACtF,+FAA+F;QACjG,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;YACzB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC7B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC3B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CACzC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAClB,IAAI,CAAC,SAAS,CACZ,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EACvF,IAAI,EACJ,CAAC,CACF,CACF,CACJ,CAAC;AACJ,CAAC"}

package/dist/tools/whoami.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Runtime } from '@albertomarturelo/sii-core';
+export declare function registerWhoamiTools(server: McpServer, runtime: Runtime): void;
+//# sourceMappingURL=whoami.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../src/tools/whoami.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAGlE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAe7E"}

package/dist/tools/whoami.js

@@ -0,0 +1,14 @@
+import { whoami } from '@albertomarturelo/sii-core';
+import { toolText } from '../tool-helpers.js';
+export function registerWhoamiTools(server, runtime) {
+    server.registerTool('whoami', {
+        title: 'Cuenta autenticada (whoami)',
+        description: 'Muestra la cuenta con la que estás autenticado en el SII: RUT, tipo (persona/empresa), ' +
+            'razón social o nombre, y email. Útil para saber con qué cuenta se está trabajando. ' +
+            'EXPONE PII PROPIA del usuario (nombre/razón social + email) al modelo. Lectura en vivo ' +
+            'del principal de la sesión (ignora el puntero operate). No recibe argumentos.',
+        // readOnly, but it DOES touch SII (a live session restore + portal read), like auth_logout.
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, () => toolText(async () => JSON.stringify(await whoami(runtime), null, 2)));
+}
+//# sourceMappingURL=whoami.js.map

package/dist/tools/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../src/tools/whoami.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAgB,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,OAAgB;IACrE,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,yFAAyF;YACzF,qFAAqF;YACrF,yFAAyF;YACzF,+EAA+E;QACjF,4FAA4F;QAC5F,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACzD,EACD,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAC3E,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@albertomarturelo/sii-mcp",
+  "version": "0.5.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 — as tools/resources for Claude Desktop and Claude Code. Each tool is a thin call into @albertomarturelo/sii-core tasks (ADR-003).",
+  "keywords": [
+    "sii",
+    "chile",
+    "impuestos",
+    "sii-cl",
+    "tax",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "rcv",
+    "f29"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/albertomarturelo/sii#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/albertomarturelo/sii.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/albertomarturelo/sii/issues"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "bin": {
+    "sii-mcp": "./dist/main.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "playwright": "^1.49.0",
+    "zod": "^4.4.3",
+    "@albertomarturelo/sii-core": "^0.5.0"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}