Skip to content
MCP server

tefacturo MCP by usefulapi

Read SUNAT status, XML, PDF and CDR; emit invoices, receipts, notes and voids in…

Install
Runs
Remotely
Version
1.2.0
Listing updated
5 days ago

About tefacturo MCP by usefulapi

tefacturo MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read SUNAT status, XML, PDF and CDR; emit invoices, receipts, notes and voids in tefacturo.

Install

Run in a terminal

claude mcp add --transport http tefacturo https://tefacturo.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://tefacturo.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tefacturo": {
      "url": "https://tefacturo.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tefacturo": {
      "type": "http",
      "url": "https://tefacturo.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tefacturo": {
      "serverUrl": "https://tefacturo.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tefacturo": {
      "type": "http",
      "url": "https://tefacturo.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (10)

Read directly from the server.

tefacturo_get_status
Get the three states of one issued document: SUNAT answer (estadoSunat), declaration (estadoComprobante) and mail delivery (estadoEntrega), with the declaration text. Use it before a document is sent again. Read-only.
tefacturo_get_xml
Get the signed UBL XML of one issued document. The reply holds xmlFirma, the XML in base64, and hashCode (may be null). Read-only.
tefacturo_get_pdf
Get the printed PDF of one issued document, as a base64 string (decode it to a .pdf file). Read-only.
tefacturo_get_cdr
Get the SUNAT receipt (CDR) of one document as a base64 ZIP that holds an XML answer from SUNAT. The CDR proves SUNAT accepted the document. Read-only.
tefacturo_preview_document
Render a PDF preview of a document from its JSON, without a number and without a SUNAT filing (the tool sets datosDocumento.numero to 0). Use it to check the layout before tefacturo_emit_invoice. Read-only. Returns base64Pdf.
tefacturo_emit_invoice
SUNAT FILING, IRREVERSIBLE: files a new invoice (factura, type 01) with SUNAT for this login's RUC. The numero must be new: check the series with tefacturo_get_status first. Use tefacturo_preview_document to check the layout first. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocument
tefacturo_emit_receipt
SUNAT FILING, IRREVERSIBLE: files a new receipt (boleta de venta, type 03) for a consumer with SUNAT, through the daily summary. The numero must be new: check the series with tefacturo_get_status first. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login
tefacturo_emit_credit_note
SUNAT FILING, IRREVERSIBLE: files a credit note (nota de crédito, type 07) that adjusts an earlier invoice or receipt. The payload must name the original document in comprobanteAjustado and a motivo. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's
tefacturo_emit_debit_note
SUNAT FILING, IRREVERSIBLE: files a debit note (nota de débito, type 08) that adds a charge to an earlier invoice or receipt. The payload must name the original document in comprobanteAjustado and a motivo. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this l
tefacturo_void_documents
SUNAT FILING, IRREVERSIBLE: sends a voiding summary (resumen de baja) that cancels issued invoices or receipts. The payload holds fechaGeneracion, fechaDocumentoBaja and resumenBajaItemList (serie, numero, tipoComprobante 01 or 03, motivo). SUNAT processes it later: check it with tefacturo_get_status. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocume

tefacturo MCP by usefulapi FAQ

How do I add tefacturo MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http tefacturo https://tefacturo.usefulapi.io/mcp