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

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

{
  "mcpServers": {
    "peru-invoice": {
      "type": "http",
      "url": "https://inv-pe.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

git clone https://github.com/junter1989k-ai/peru-invoice-mcp && cd peru-invoice-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

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. Aggregation layer: two interchangeable OSE/PSE backends — Nubefact and APISUNAT (PSE cloud) — behind the same tools. 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.

Or use APISUNAT (second backend)

Prefer APISUNAT? Send its headers instead — the server auto-selects the backend from whichever credential you send (or force it with the tool's optional provider field: "nubefact" / "apisunat"):

"headers": {
  "x-apisunat-persona-id": "<your-persona-id>",
  "x-apisunat-persona-token": "<your-persona-token>",
  "x-apisunat-ruc": "<your-11-digit-RUC>"
}

Free self-signup at apisunat.com; a DEV persona lets you test without sending to SUNAT before switching the persona to production (mode: "apisunat-account"). APISUNAT signs and sends your CPE with your persona's certificate (PSE model); this server only forwards the credentials.

Tools

⚠️ 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 the chosen backend (Nubefact or APISUNAT, 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.