Skip to main content
Glama
junter1989k-ai

peru-invoice-mcp

Peru Invoice MCP 🇵🇪 — How can my AI agent issue a factura o boleta electrónica in Peru?

Remote MCP server that lets any AI agent issue Peru electronic CPE (comprobante de pago electrónico — factura for B2B, boleta for consumers), declared to SUNAT via Nubefact. Stateless, bring-your-own credentials, never stores anything.

Live endpoint: https://inv-pe.wishpool.app/mcp · Registry: app.wishpool/peru-invoice-mcp

Quick start

{
  "mcpServers": {
    "peru-invoice": {
      "type": "http",
      "url": "https://inv-pe.wishpool.app/mcp",
      "headers": {
        "x-nubefact-ruta": "https://api.nubefact.com/api/v1/<your-hash>",
        "x-nubefact-token": "<your-token>"
      }
    }
  }
}

A free DEMO account at nubefact.com gives you both a RUTA and a TOKEN (menu Api-Integración). The same credentials switch to production at the account level (numbering resets on go-live), so results report mode: "nubefact-account" honestly — verify demo vs production in your Nubefact dashboard.

Related MCP server: InvoiceXML

Tools

Tool

What it does

create_invoice

Issue a factura (buyer 11-digit RUC) or boleta (consumer DNI/none). You supply serie (F001/B001) and the next numero; item prices go in including IGV, and this layer computes valor_unitario, subtotal, IGV 18% and totals. Returns the SUNAT link + PDF/XML.

query_invoice

Status check by comprobante_type + serie + numero: ACCEPTED / PENDING / REJECTED, plus anulado and PDF/XML/CDR links.

cancel_invoice

Void (anular — comunicación de baja) a CPE at SUNAT with a motivo. Asynchronous: confirm later with query_invoice.

⚠️ Numbering is merchant-managed. This server is stateless and does not track sequences — the caller supplies serie and the next numero. Reusing a numero is rejected by SUNAT; skipping one leaves a gap.

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. The cap applies to the invoice total in PEN.

Develop

node test/serve.js   # local server on :3229
node test/e2e.js     # protocol + validation + IGV math + fake-cred live probes

Safety

Pure stateless translation layer. The SUNAT certification burden sits with Nubefact (OSE/PSE); credentials travel per-request in headers, nothing is stored. Privacy policy.

Sister servers

Local payments in 81 countries, one family: mcp.wishpool.app · Taiwan e-invoice 電子發票 included. Invoice family live: Mexico CFDI 4.0 (inv-mx.wishpool.app). More invoice countries coming: Brazil NF-e · Chile DTE · Colombia · India GST · Poland KSeF · Italy SdI.

MIT licensed.

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/junter1989k-ai/peru-invoice-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server