tefacturo MCP server

Read SUNAT status, XML, PDF and CDR; emit invoices, receipts, notes and voids in tefacturo. Hosted by usefulapi: connect it to Claude, ChatGPT, Cursor or any MCP client.

Connect tefacturo50 free tool calls a month

What can I ask?

Turn on the tefacturo connector, then ask in plain words. The AI picks the tools.

Show the SUNAT status of invoice FFA2-15.
Get the PDF of receipt BBV5-4 so I can send it to the customer.
Preview this invoice layout before we file it with SUNAT.
Get the SUNAT receipt (CDR) of invoice FFA2-15 for our records.

What you can do with tefacturo in Claude and ChatGPT

For Peruvian companies that file electronic invoices, receipts and notes with SUNAT through tefacturo.

Check the SUNAT status of a document before resending it

Read the SUNAT answer, the declaration state and the mail delivery state of one document. Check the series before you file a new document.

Get the PDF or the XML of an issued document

Get the printed PDF or the signed XML of one issued document. Send the PDF to the customer, or store the XML for your records.

Keep the SUNAT receipt of each accepted document

Get the SUNAT receipt (CDR) of one document. The receipt is an XML answer from SUNAT that shows the document was accepted.

Preview an invoice layout before you file it

Render a PDF preview of a document from its JSON. The preview has no number and nothing goes to SUNAT.

File a new invoice or receipt with SUNAT

Check the series, preview the layout, then file a new invoice or a receipt with SUNAT. Filing cannot be undone.

Changes data

Correct a filed document with a note or a voiding summary

Adjust an earlier invoice or receipt with a credit note or a debit note, or send a voiding summary. Each one needs a reason. Check the voiding summary later with the status tool.

Changes data

How do I connect tefacturo?

Before you connect

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

Your company's tefacturo account owner or the Close2u team creates the user and the clave. This server uses the login only to call the tefacturo API for your company and to derive a private account id. The clave is sent only to tefacturo's login endpoint.

Claude claude.ai · Desktop

Open Customize → Connectors, then click + Add → Add custom connector.
Enter the name tefacturo and this URL, then click Add:
https://tefacturo.usefulapi.io/mcp
Claude opens the login page: enter your RUC of the company (11 digits), tefacturo user email and tefacturo clave (password).
In a chat, click + → Connectors and turn on tefacturo.

Team and Enterprise: an Owner adds the connector for the organization first.

ChatGPT chatgpt.com

Open Plugins, click +, then Add custom MCP server.
Enter the name tefacturo and this URL, choose OAuth as the authentication, confirm the warning and create it:
https://tefacturo.usefulapi.io/mcp
ChatGPT opens the login page: enter your RUC of the company (11 digits), tefacturo user email and tefacturo clave (password).
In Plugins, install tefacturo, then choose it in a chat.

No Add custom MCP server option? It depends on your account or workspace settings: see OpenAI's guide.

Claude Code

Run this command, then run /mcp in Claude Code to log in:

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

Cursor

Add to Cursor or add this to ~/.cursor/mcp.json:

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

VS Code

Add to VS Code or add this to .vscode/mcp.json:

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

Codex

Run these commands. The second one opens the login page:

codex mcp add tefacturo --url https://tefacturo.usefulapi.io/mcp

codex mcp login tefacturo

Other clients

Windsurf, Cline, Zed and other MCP clients: add this URL as a remote MCP server (Streamable HTTP). The client then opens the login page in your browser.

https://tefacturo.usefulapi.io/mcp

Add only the URL. Do not add an Authorization header or an API key to the client config. The server signs you in with OAuth: the login page asks for your RUC of the company (11 digits), tefacturo user email and tefacturo clave (password). If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.

Pricing

Plan	Price	Limit
Free	$0	50 tool calls / month
Proper user	$9/mo · $90/yr	10,000 tool calls / month
Pro+per user	$39/mo · $390/yr	100,000 tool calls / month

Each paid plan covers this tefacturo server only. Ask your AI to run tefacturo_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with tefacturo_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with tefacturo_upgrade before then undoes the cancel. Or write to [email protected].

Tools 14

Show all 14 tools (the AI picks them for you)

Read only · 5

Get document statustefacturo_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.
Get document XMLtefacturo_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.
Get document PDFtefacturo_get_pdf
Get the printed PDF of one issued document, as a base64 string (decode it to a .pdf file). Read-only.
Get SUNAT receipt (CDR)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.
Preview a documenttefacturo_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.

Changes data · 5

Emit an invoice (files with SUNAT)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.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC.
Emit a receipt (files with SUNAT)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's RUC; the tool sets it and rejects another RUC.
Emit a credit note (files with SUNAT)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 RUC; the tool sets it and rejects another RUC.
Emit a debit note (files with SUNAT)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 login's RUC; the tool sets it and rejects another RUC.
Void documents (files with SUNAT)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, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC.

Your usefulapi plan · 4

Usage status (free-tier meter)tefacturo_usage_status
Report the caller's current usage: the plan, calls used this month, the limit of the plan (the free monthly cap or the Pro fair use limit), remaining, and whether the limit is reached. Read-only; does not count against the meter.
Request a missing featuretefacturo_request_feature
Tell usefulapi that the user needs something the tefacturo tools cannot do yet (a missing tool, field or filter). Call it only when the user asks for something none of the tools can do, and tell the user that you send the request. Do not call it for errors or for normal requests. Do not include personal data, credentials or customer records. Stored with the product name and the client type (for example Claude or Cursor), without the user's account. At most 5 requests per day. Does not count against the meter.
Upgrade to Pro or Pro+tefacturo_upgrade
Get a paid plan for tefacturo (the free tier caps monthly usage). Pro: 10,000 tool calls a month, for normal use — plan "monthly" ($9/month) or "yearly" ($90/year, 2 months free). Pro+: 100,000 tool calls a month, for automations and heavy use — plan "plus" ($39/month) or "plus_yearly" ($390/year). Without a plan it returns both Pro and Pro+, each with a payment link, for the user to choose; with a plan, one link. An existing Pro subscription changes to Pro+ in place: call without confirm first, as the reply states the exact charge for this account (the price difference for the rest of the period, or in a free Pro trial the full Pro+ price, as the trial ends); then call with confirm: true. Cancel any time: the plan then runs to the end of the paid period, so it also suits a one-time job. A link opens Stripe Checkout in the browser; after payment the account upgrades automatically. Does not count against the meter.
Cancel the Pro subscriptiontefacturo_cancel_subscription
Cancel the caller's tefacturo Pro subscription at the end of the paid period (no refund for the current period; Pro continues until then, then the free tier applies). Requires confirm: true. Run tefacturo_upgrade later to undo the cancel before the period ends. Does not count against the meter.

FAQ

What can I do with tefacturo in Claude or ChatGPT?

Check the SUNAT status of a document before resending it. Get the PDF or the XML of an issued document. Keep the SUNAT receipt of each accepted document. Preview an invoice layout before you file it. File a new invoice or receipt with SUNAT. Correct a filed document with a note or a voiding summary. See what you can do for the details.

Is this an official tefacturo product?

No. usefulapi is an independent service. It is not affiliated with or endorsed by tefacturo. The server calls the tefacturo API with your own tefacturo access, so it sees only the data that your account can see.

Can I connect tefacturo to Claude or ChatGPT?

Yes. In Claude, add this server's URL as a custom connector. In ChatGPT, add it as a custom MCP server in Plugins. Then log in once. Cursor, VS Code, Claude Code and Codex work too. See the setup steps.

What do I need to connect?

The login page asks for your RUC of the company (11 digits), tefacturo user email and tefacturo clave (password). See Before you connect for where to find them.

Do I put my tefacturo key or an Authorization header in the client config?

No. Add only the URL. Do not add an Authorization header or an API key to the client config. The server signs you in with OAuth: the login page asks for your RUC of the company (11 digits), tefacturo user email and tefacturo clave (password). If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.

How do you keep my tefacturo credentials?

The login stores them encrypted in the authorization grant of your connection. The server uses them to call the tefacturo API for you and to derive a private account id for usage metering. usefulapi does not show them on any page or in any reply. To stop all access, remove the connector and change or delete these credentials in tefacturo.

Can the AI change my tefacturo data?

Yes, if you approve it. 5 of the 10 tefacturo tools can create or change data. The other 5 are marked read-only. Most MCP clients ask you to approve a tool call before it runs.

What does it cost?

The Free plan gives 50 tool calls / month. Pro costs $9/mo or $90/yr, with 10,000 tool calls / month. Pro+ costs $39/mo or $390/yr, with 100,000 tool calls / month. Each subscription covers this tefacturo server only. Cancel any time: your paid plan then runs to the end of the paid period. Run tefacturo_usage_status to see how many calls you used.

How do I subscribe or cancel?

Ask the AI to run tefacturo_upgrade and choose Pro or Pro+, billed monthly or yearly: it returns a Stripe Checkout link. If you already have Pro, ask to change it to Pro+. After you confirm, your existing subscription changes in place, keeps its billing interval and charges the price difference for the rest of the period immediately. To cancel, run tefacturo_cancel_subscription. Your paid plan continues to the end of the paid period.

What if a tefacturo tool that I need is missing?

Tell the AI what you wanted to do. It can send the request with tefacturo_request_feature. We store the text with the server name, the type of AI client and the tool you tried, not with your account, and read every request when we plan new tools. You can send up to 5 requests per day.

Which AI clients can I use?

Any client that supports remote MCP servers (Streamable HTTP) with OAuth login: Claude (web and desktop), Claude Code, ChatGPT, Codex, Cursor, VS Code, Windsurf and others.

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.

Need a tool this server does not have, or a connection to another system? We build custom integrations and MCP servers.

More Payments & Billing MCP servers

All Payments & Billing servers →