Skip to main content
Glama
Sign In
@integradte/mcp

@integradte/mcp

by JoseLuis21
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

@integradte/mcp

MCP Server para consultar datos de facturación electrónica chilena desde la API IntegraDTE.

Permite a modelos de lenguaje (Claude, etc.) consultar documentos tributarios, folios, estadísticas y más mediante el protocolo MCP (Model Context Protocol).

Tools disponibles

Tool

Descripción

get_user_info

Info del usuario autenticado (nombre, email, estado)

get_certificate_info

Estado del certificado digital (vencimiento, titular)

list_documents

Listar DTEs con filtros (tipo, estado, fechas, paginación)

get_document

Detalle de un documento por ID

get_document_stats

Estadísticas: totales emitidos, montos, por tipo DTE

get_numeration_summary

Resumen de folios disponibles por tipo

get_last_folio

Último folio usado para un tipo de DTE

Related MCP server: mcp-sii

Instalación

npm install
npm run build

Variables de entorno

Variable

Descripción

Default

API_BASE_URL

URL de la API IntegraDTE

http://localhost:5058

API_KEY

API Key de autenticación (requerida)

—

Uso con Claude Desktop

Agregar a claude_desktop_config.json:

{
  "mcpServers": {
    "integradte": {
      "command": "npx",
      "args": ["-y", "@integradte/mcp"],
      "env": {
        "API_BASE_URL": "https://api.integradte.cl",
        "API_KEY": "tu_api_key"
      }
    }
  }
}

Uso con npx (una vez publicado)

{
  "mcpServers": {
    "integradte": {
      "command": "npx",
      "args": ["-y", "@integradte/mcp"],
      "env": {
        "API_BASE_URL": "https://api.integradte.cl",
        "API_KEY": "tu_api_key"
      }
    }
  }
}

Tipos de DTE soportados

Código

Tipo

33

Factura Electrónica

34

Factura Exenta

39

Boleta Electrónica

41

Boleta Exenta

46

Factura de Compra

52

Guía de Despacho

56

Nota de Débito

61

Nota de Crédito

Desarrollo

npm install
npm run dev    # Watch mode
npm run build  # Build
npm start      # Run

Publicación a npm con versiones automáticas

Este repo usa Changesets + GitHub Actions.

Configuración inicial

  1. Crear el secret NPM_TOKEN en GitHub (Settings > Secrets and variables > Actions).

  2. El token debe tener permisos para publicar en el scope @integradte.

  3. Si la organización exige 2FA para publish, usa un token con bypass 2fa.

Flujo de versiones

  1. Para cada cambio que quieras versionar, crea un changeset:

    pnpm changeset

  2. Haz commit del archivo en .changeset/*.md junto a tu cambio.

  3. Al hacer merge a main, el workflow Release crea/actualiza un PR de release con el nuevo versionado.

  4. Cuando ese PR se mergea, el mismo workflow publica automáticamente a npm.

Available Tools

11 tools
get_business_detailA

Obtiene el detalle de una empresa específica: RUT, razón social, giro comercial, dirección, comuna, estado, resolución SII y si tiene certificado digital cargado. Usar cuando el cliente pregunta por los datos de una empresa en particular.

Inputs: no named parameters.

get_certificate_infoA

Obtiene información del certificado digital de la empresa: titular, RUT, fecha de vencimiento y estado. Usar cuando el cliente pregunta por su certificado o si está por vencer. NO retorna el certificado en sí por seguridad.

Inputs: no named parameters.

get_documentA

Obtiene el detalle completo de un documento tributario electrónico (DTE) por su ID. Retorna tipo, folio, emisor, receptor, montos, estado SII e historial de estados. Usar cuando el cliente pregunta por un documento específico.

Inputs: no named parameters.

get_document_statsA

Estadísticas agregadas de documentos tributarios: total emitidos, monto total facturado, desglose por tipo DTE (facturas, boletas, notas de crédito, etc.), documentos con error. Usar cuando preguntan totales, resúmenes, cuánto han facturado o cuántos documentos emitieron.

Inputs: no named parameters.

get_dte_balanceA

Obtiene el saldo de DTEs disponibles del cliente. Retorna packs activos, DTEs restantes y fecha de vencimiento. Usar cuando el cliente pregunta cuántos documentos le quedan o su saldo.

Inputs: no named parameters.

get_last_folioB

Obtiene el último folio usado para un tipo de DTE específico. Útil para saber cuál fue el último número de folio emitido. Requiere el código SII del tipo de documento.

Inputs: no named parameters.

get_numeration_summaryA

Resumen de folios (CAF) disponibles por tipo de DTE. Muestra cuántos folios quedan, rangos activos, agotados y vencidos. Usar cuando el cliente pregunta cuántos folios le quedan, si tiene folios disponibles para boletas/facturas, o si necesita solicitar más al SII.

Inputs: no named parameters.

get_user_infoA

Obtiene información del usuario autenticado: nombre, email, estado de la cuenta. Usar cuando el cliente pregunta por sus datos personales o de su cuenta.

Inputs: no named parameters.

list_businessesA

Lista todas las empresas registradas del usuario. Retorna RUT, razón social, giro, estado y si tiene certificado digital cargado. Usar cuando el cliente pregunta cuántas empresas tiene o cuáles son.

Inputs: no named parameters.

list_documentsA

Lista documentos tributarios emitidos con filtros opcionales. Permite filtrar por tipo DTE (33=Factura, 34=Factura Exenta, 39=Boleta, 41=Boleta Exenta, 46=Factura Compra, 52=Guía Despacho, 56=Nota Débito, 61=Nota Crédito), estado y rango de fechas. Retorna lista paginada con folio, tipo, monto, estado y fecha de emisión.

Inputs: no named parameters.

list_purchasesA

Lista las facturas de compra recibidas de proveedores (libro de compras). Retorna RUT emisor, razón social, monto, tipo DTE y fecha. Usar cuando el cliente pregunta por sus compras o facturas recibidas.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct resource: user, certificate, businesses, emitted documents, document stats, folios, DTE balance, and received purchases. Even similar-looking tools like list_documents and list_purchases are clearly separated by emitted vs. received documents.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern, using get_ for singular resources and list_ for plural collections. Descriptor suffixes like _stats, _summary, and _balance are applied uniformly and do not break the pattern.

    Tool Count5/5

    With 11 tools, the server is well-scoped for a Chilean DTE/invoicing query assistant. Each tool covers a meaningful query area without redundancies or excessive fragmentation.

    Completeness4/5

    The server covers the core read-only domain well: user info, businesses, certificates, document listing/detail/stats, folios, balance, and purchases. Minor gaps exist such as no document file/PDF download and no purchase detail view, but agents can answer most common customer queries.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-ai-fiskalizacija

      Seyn-Labs
      A
      license
      A
      quality
      C
      maintenance
      MCP server for creating and fiscalizing invoices via solo.com.hr API. Enables AI agents to generate invoices, retrieve invoice details, list invoices, and check next invoice number.
      4
      MIT

    • mcp-sii

      crilam
      A
      license
      A
      quality
      B
      maintenance
      Open-source MCP server for Chile's SII free invoicing system, enabling AI agents to query issued and received tax documents.
      12
      6
      MIT

    • mcp-nfse-nacional

      SamuelMoraesF
      A
      license
      A
      quality
      D
      maintenance
      MCP server for querying Brazilian electronic service invoices (NFSe) from the national portal. Allows AI agents to authenticate with digital certificates and search, detail, and download PDFs of issued NFSe.
      3
      62 npm
      19
      ISC

    • cobra-mcp

      Motivandollc
      A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for SRI electronic invoicing in Ecuador, enabling AI agents to emit invoices, credit notes, retention documents, and more via natural language through the Cobra API.
      MIT