# tefacturo MCP by usefulapi

> tefacturo MCP by usefulapi is a freemium MCP server for finance and payments. Hosted MCP server to check, preview, file and void SUNAT invoices in tefacturo. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode, CLI
- **Website:** https://usefulapi.io/tefacturo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/tefacturo
- **MCP Registry name:** io.usefulapi/tefacturo
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The server gives an AI client access to a Peruvian company's tefacturo account, so documents can be checked and issued from a chat instead of the tefacturo interface. Reads cover SUNAT status, the signed XML, the printed PDF and the SUNAT receipt (CDR) of an issued document. Writes cover filing invoices, receipts, credit notes, debit notes and voiding summaries with SUNAT.

It runs as a remote Streamable HTTP endpoint, so there is nothing to install. Users sign in through OAuth with their company RUC, tefacturo user email and clave. The README says credentials are stored per user and not placed in config files. Five of the fourteen tools change data, and filings with SUNAT cannot be undone, so approval prompts matter.

It is aimed at Peruvian businesses that already file electronic documents through tefacturo and want to check or correct them with an AI assistant. usefulapi states it is independent and not affiliated with tefacturo.

## Features

- **SUNAT status lookup:** Reads the SUNAT answer, declaration state and mail delivery state of one document.
- **XML, PDF and CDR retrieval:** Downloads the signed UBL XML, printed PDF and SUNAT receipt of an issued document.
- **Layout preview:** Renders a PDF preview from document JSON without assigning a number or filing with SUNAT.
- **SUNAT filing tools:** Files invoices, receipts, credit notes, debit notes and voiding summaries through tefacturo.
- **OAuth login per user:** Signs in with company RUC and tefacturo credentials, with no API key in client config.
- **Usage meter and plans:** Reports monthly tool call usage against the free, Pro and Pro+ limits.

## Good for

- Check whether an invoice was accepted by SUNAT before resending it
- Send a customer the PDF of a receipt without leaving the chat
- Store the signed XML and SUNAT receipt of each accepted document
- Preview an invoice layout before filing it
- Issue a credit note or voiding summary to correct an earlier document

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tefacturo.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tefacturo": {
      "url": "https://tefacturo.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## FAQ

### What do I need to connect?

The login page asks for your company RUC (11 digits), the tefacturo user email and the tefacturo clave (password).

### Do I put an API key or Authorization header in my client config?

No. The README and site say to add only the URL. The server signs you in with OAuth, and an Authorization header in the config can cause 401 errors.

### Can the AI change my tefacturo data?

Yes, through five tools that create or void documents with SUNAT. The site notes that filing cannot be undone and that most MCP clients ask for approval before a tool call runs.

### What does it cost?

The Free plan includes 50 tool calls a month. Pro is $9/mo or $90/yr with 10,000 calls, and Pro+ is $39/mo or $390/yr with 100,000 calls.

### Is tefacturo MCP by usefulapi free?

tefacturo MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### 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

### What are the best alternatives to tefacturo MCP by usefulapi?

The closest alternatives to tefacturo MCP by usefulapi are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/tefacturo-mcp-by-usefulapi
