Chile Invoices (DTE boleta/factura electrónica via OpenFactura)

Official3 toolsLive

by junter1989k-ai · JavaScript

Chile DTE for AI agents - boleta/factura electronica via OpenFactura or LibreDTE. Stateless BYO.

Topics

ai-agentsboleta-electronicachiledtee-invoiceinvoicingmcpmcp-serverai-agentclaudeinvoicetaxwishpool

Captured live from the server via tools/list.

create_invoice

Issue a Chile electronic tax document (DTE): a boleta electrónica (consumer receipt, TipoDTE 39, default) or a factura electrónica (B2B invoice, TipoDTE 33), stamped against SII with the merchant's own CAF. Two backends (auto-selected from your credential header, or force with the "provider" field): OpenFactura/Haulmer (header x-openfactura-key; Emisor auto-derived from your account; DEV sandbox by default, x-openfactura-mode: production to go live) or LibreDTE cloud (header x-libredte-hash + x-libredte-emisor for your RUT; the certification-vs-production environment is whatever your emisor is registered as in LibreDTE — there is no server-side sandbox toggle). Both keep your SII certificate and CAF in your own provider account; this server only forwards a token and stores nothing. Amounts are in CLP (Chilean pesos: whole integers, no decimals). IMPORTANT price convention: for a boleta (39) each price is GROSS (IVA 19% already included, as shown to consumers); for a factura (33) each price is NET (IVA 19% is added on top).

Parameters8

provider	string	optional	Optional. Which backend to issue through. Omit to auto-detect from your credential header (x-openfactura-key -> openfactura, x-libredte-hash -> libredte; default openfactura).
document_type	string	optional	DTE type: 39 = boleta electrónica (consumer, prices GROSS/IVA-included) — default; 33 = factura electrónica (B2B, prices NET/IVA-added). Cannot issue 61 here — use cancel_invoice to void via a credit note.
customer_rut	string	optional	Buyer RUT, format 12345678-9 (check digit 0-9 or K). REQUIRED for a factura (33). For a boleta (39) it is optional and defaults to the generic consumer 66666666-6.
customer_name	string	optional	Buyer razón social / name. Required for a factura (33); defaults to "Consumidor Final" for a boleta.
customer_giro	string	optional	Buyer giro (business activity). Factura (33) only; SII expects it for B2B. Default "Particular".
customer_address	string	optional	Buyer street address (DirRecep). Factura (33) only. Default "Sin direccion".
customer_comuna	string	optional	Buyer comuna (CmnaRecep). Factura (33) only. Default "Santiago".
items	array	required	Line items. Each: description, price (CLP integer — GROSS for boleta, NET for factura), optional quantity (default 1).

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "openfactura",
        "libredte"
      ],
      "description": "Optional. Which backend to issue through. Omit to auto-detect from your credential header (x-openfactura-key -> openfactura, x-libredte-hash -> libredte; default openfactura)."
    },
    "document_type": {
      "type": "string",
      "enum": [
        "33",
        "39"
      ],
      "description": "DTE type: 39 = boleta electrónica (consumer, prices GROSS/IVA-included) — default; 33 = factura electrónica (B2B, prices NET/IVA-added). Cannot issue 61 here — use cancel_invoice to void via a credit note."
    },
    "customer_rut": {
      "type": "string",
      "description": "Buyer RUT, format 12345678-9 (check digit 0-9 or K). REQUIRED for a factura (33). For a boleta (39) it is optional and defaults to the generic consumer 66666666-6."
    },
    "customer_name": {
      "type": "string",
      "description": "Buyer razón social / name. Required for a factura (33); defaults to \"Consumidor Final\" for a boleta."
    },
    "customer_giro": {
      "type": "string",
      "description": "Buyer giro (business activity). Factura (33) only; SII expects it for B2B. Default \"Particular\"."
    },
    "customer_address": {
      "type": "string",
      "description": "Buyer street address (DirRecep). Factura (33) only. Default \"Sin direccion\"."
    },
    "customer_comuna": {
      "type": "string",
      "description": "Buyer comuna (CmnaRecep). Factura (33) only. Default \"Santiago\"."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "description": "Line items. Each: description, price (CLP integer — GROSS for boleta, NET for factura), optional quantity (default 1).",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string",
            "description": "Item name (NmbItem), max 80 chars."
          },
          "price": {
            "type": "number",
            "description": "Unit price in CLP (whole pesos, no decimals)."
          },
          "quantity": {
            "type": "number",
            "description": "Default 1."
          }
        },
        "required": [
          "description",
          "price"
        ]
      }
    }
  },
  "required": [
    "items"
  ]
}

query_invoice

Fetch a DTE you emitted (by document_type + folio) from your provider (OpenFactura or LibreDTE, auto-selected from your credential header or the "provider" field). Status values: ISSUED (accepted by the provider, awaiting/without an SII acceptance timestamp), ACCEPTED_BY_SII (SII reception confirmed). Returns the receptor, net/IVA/total (CLP). Safe to call anytime. (OpenFactura resolves your Emisor RUT from the API key; LibreDTE uses the x-libredte-emisor header.)

Parameters3

provider	string	optional	Optional. Backend to query; omit to auto-detect from your credential header.
document_type	string	required	DTE type of the document to fetch: 33 factura, 39 boleta, 61 credit note.
folio	number	required	The folio returned by create_invoice (or cancel_invoice for a 61).

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "openfactura",
        "libredte"
      ],
      "description": "Optional. Backend to query; omit to auto-detect from your credential header."
    },
    "document_type": {
      "type": "string",
      "enum": [
        "33",
        "39",
        "61"
      ],
      "description": "DTE type of the document to fetch: 33 factura, 39 boleta, 61 credit note."
    },
    "folio": {
      "type": "number",
      "description": "The folio returned by create_invoice (or cancel_invoice for a 61)."
    }
  },
  "required": [
    "document_type",
    "folio"
  ]
}

cancel_invoice

Void a Chile DTE by issuing a nota de crédito electrónica (TipoDTE 61) that references the original with CodRef=1 (anula documento) — this is the SII-correct way to cancel; there is no delete. Works through either backend (OpenFactura or LibreDTE, auto-selected from your credential header or the "provider" field). Pass the original document_type + folio; the credit note mirrors the original net amount and reverses it. Returns the credit-note folio.

Parameters4

provider	string	optional	Optional. Backend to void through; omit to auto-detect from your credential header.
document_type	string	required	DTE type of the document to void: 33 factura or 39 boleta.
folio	number	required	The folio of the document to void (as returned by create_invoice).
reason	string	optional	Optional reason text (RazonRef), max 90 chars. Default "Anula documento".

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "openfactura",
        "libredte"
      ],
      "description": "Optional. Backend to void through; omit to auto-detect from your credential header."
    },
    "document_type": {
      "type": "string",
      "enum": [
        "33",
        "39"
      ],
      "description": "DTE type of the document to void: 33 factura or 39 boleta."
    },
    "folio": {
      "type": "number",
      "description": "The folio of the document to void (as returned by create_invoice)."
    },
    "reason": {
      "type": "string",
      "description": "Optional reason text (RazonRef), max 90 chars. Default \"Anula documento\"."
    }
  },
  "required": [
    "document_type",
    "folio"
  ]
}

README.md5 KBView on GitHub

Chile Invoice MCP 🇨🇱 — How can my AI agent issue a boleta / factura electrónica (DTE) in Chile?

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "chile-invoice": {
      "type": "http",
      "url": "https://inv-cl.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/chile-invoice-mcp && cd chile-invoice-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Remote MCP server that lets any AI agent issue Chile electronic tax documents (DTE) — boleta electrónica (TipoDTE 39) and factura electrónica (TipoDTE 33), stamped at SII. Two interchangeable backends, auto-selected by which credential header you send (or forced with a provider field): OpenFactura (Haulmer) and LibreDTE cloud. Stateless, bring-your-own credentials, never stores anything. Your SII certificate and CAF stay in your own provider account.

Live endpoint: https://inv-cl.wishpool.app/mcp · Registry: app.wishpool/chile-invoice-mcp

Quick start

json

{
  "mcpServers": {
    "chile-invoice": {
      "type": "http",
      "url": "https://inv-cl.wishpool.app/mcp",
      "headers": {
        "x-openfactura-key": "your-openfactura-api-key",
        "x-openfactura-mode": "production"
      }
    }
  }
}

Get your API key from your OpenFactura / Haulmer account (Configuración → API). Omit x-openfactura-mode to stay in the DEV sandbox (simulated CAF, no fiscal effect).

Or use LibreDTE cloud instead

Send LibreDTE's headers and the server routes there automatically:

json

{
  "mcpServers": {
    "chile-invoice": {
      "type": "http",
      "url": "https://inv-cl.wishpool.app/mcp",
      "headers": {
        "x-libredte-hash": "your-libredte-api-hash",
        "x-libredte-emisor": "76192083-9"
      }
    }
  }
}

x-libredte-hash is your API hash from your LibreDTE profile; x-libredte-emisor is your emisor RUT (one hash can hold several emisores). LibreDTE has no server-side sandbox toggle — the certification-vs-production environment is whatever your emisor is registered as in your LibreDTE account, so register a certification emisor to test safely. You can also force either backend explicitly with the tool provider field (openfactura | libredte). Your SII certificate and CAF stay in your own provider account — this server never sees them.

Tools

Tool	What it does
`create_invoice`	Emit a boleta (39, default) or factura (33) DTE — items in, `folio` out. Emisor auto-derived from your account. Boleta prices GROSS (IVA included); factura prices NET (IVA added), buyer RUT required.
`query_invoice`	Fetch a DTE by `document_type` + `folio`: status `ISSUED` or `ACCEPTED_BY_SII`, plus net/IVA/total (CLP).
`cancel_invoice`	Void a DTE by issuing a nota de crédito electrónica (TipoDTE 61, `CodRef=1` anula) referencing the original.

Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them.

Develop

bash

node test/serve.js   # local server on :3228
node test/e2e.js     # protocol + validation + fake-credential live probes against dev-api.haulmer.com (OpenFactura) and libredte.cl (LibreDTE)

Safety

Pure stateless translation layer. The SII certification burden sits with your provider (OpenFactura or LibreDTE); credentials travel per-request in headers, nothing is stored. Privacy policy.

Sister servers

Mexico CFDI 4.0 factura electrónica live: inv-mx.wishpool.app · Local payments in 81 countries, one family: mcp.wishpool.app · Taiwan e-invoice 電子發票 included. More invoice countries coming: Brazil NF-e · Peru CPE · India GST · Poland KSeF · Romania e-Factura · Italy SdI.

MIT licensed.

Install

Tools (3)

create_invoicequery_invoicecancel_invoice

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://inv-cl.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "chile-invoice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://inv-cl.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.