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

Official3 tools

by junter1989k-ai · JavaScript

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

Chile DTE for AI agents, enabling boleta/factura electronica issuance in Chile via OpenFactura or LibreDTE. The server is described as “stateless BYO” and exposes 3 tools. It is intended for MCP-capable clients, including Claude Desktop, Cursor, and Windsurf.

🛠️ Key Features

Chile boleta/factura electronica (DTE)
Integration options: OpenFactura or LibreDTE
Stateless, BYO design
3 tools exposed by the server

🚀 Use Cases

Allow an AI agent to issue Chile invoices (boleta/factura electronica)
Use the MCP server from an agent that supports MCP

⚡ Developer Benefits

MCP client configuration via HTTP server endpoint: https://inv-cl.wishpool.app/mcp
Credentials, when needed, travel as HTTP headers on each request
Credentials are not stored by the server (per excerpt)

⚠️ Limitations

Credentials are required “when you need them,” implying tool behavior depends on supplied HTTP headers

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.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

create_invoice

query_invoice

cancel_invoice

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

Use it in 60 seconds

Or run it yourself

Quick start

Or use LibreDTE cloud instead

Tools

Develop

Safety

Sister servers

Install

Remote endpoint

Related servers