Argentina Invoices (factura electrónica CAE via WSFE)

Official3 toolsLive

by junter1989k-ai · JavaScript

Argentina AFIP/ARCA electronic invoices for AI agents - issue & query facturas, get CAE via WSFE.

Topics

ai-agentargentinaclaudeinvoicemcpmcp-serverwishpool

Captured live from the server via tools/list.

create_invoice

Issue an Argentina AFIP/ARCA electronic invoice (factura electrónica) and get the CAE (Código de Autorización Electrónico) via WSFE, through the Afip SDK. Bring your own Afip SDK access_token via header x-afipsdk-token (sign up free at app.afipsdk.com — 1000 requests/month). Header x-afip-mode: dev (default, no AFIP certificate needed — test CUIT 20409378472) or prod. Header x-afip-cuit: the 11-digit issuer CUIT (defaults to the test CUIT in dev). In prod, pass your AFIP X.509 certificate + private key per-request as afip_cert / afip_key (PEM strings) — they are forwarded to Afip SDK for this request only and never stored or logged. Give flat fields (invoice_type, point_of_sale, customer doc, line items with net_price + iva_rate) and this server COMPUTES the WSFE amounts: ImpNeto, ImpIVA (grouped AlicIva array), ImpTotal — IVA is discriminated for Factura A/B and not discriminated for Factura C (monotributo). The next invoice number is fetched automatically (FECompUltimoAutorizado) unless you pass invoice_number. Returns cae, cae_expiry and invoice_number.

Parameters11

invoice_type	string	optional	Factura type: C (default, monotributo — IVA not discriminated, CbteTipo 11), B (final consumer, CbteTipo 6), A (registered VAT buyer, CbteTipo 1). A/B discriminate IVA per line.
point_of_sale	number	optional	Punto de venta (PtoVta) registered at AFIP for electronic invoicing. Default 1.
concept	string	optional	Concepto: PRODUCTS (default), SERVICES, or BOTH.
customer_doc_type	string	optional	Buyer document type: CUIT (80), DNI (96), or CF = Consumidor Final unidentified (99, doc number 0). Default CF for Factura B/C, CUIT for Factura A.
customer_doc_number	string	optional	Buyer document number (digits only). For CF use 0 or omit. Required (non-zero) for Factura A.
customer_iva_condition	number	optional	CondicionIVAReceptorId (AFIP RG 5616): 1 IVA Responsable Inscripto, 4 Exento, 5 Consumidor Final (default), 6 Responsable Monotributo.
currency	string	optional	Currency code (MonId). Default PES (Argentine peso). Use with foreign currency only if your AFIP setup allows it.
invoice_number	number	optional	Optional explicit invoice number (CbteDesde/Hasta). If omitted, the server queries FECompUltimoAutorizado and uses last+1.
afip_cert	string	optional	Optional AFIP X.509 certificate (PEM) for prod mode. Forwarded per-request to Afip SDK, never stored or logged. Not needed in dev.
afip_key	string	optional	Optional AFIP private key (PEM) for prod mode. Forwarded per-request to Afip SDK, never stored or logged. Not needed in dev.
items	array	required	Line items. Each: description, net_price (unit price in ARS, tax-EXCLUSIVE), optional quantity (default 1) and iva_rate (VAT percent: 0, 10.5, 21, 27; default 21; IGNORED for Factura C which does not discriminate IVA).

Raw schema

{
  "type": "object",
  "properties": {
    "invoice_type": {
      "type": "string",
      "enum": [
        "A",
        "B",
        "C"
      ],
      "description": "Factura type: C (default, monotributo — IVA not discriminated, CbteTipo 11), B (final consumer, CbteTipo 6), A (registered VAT buyer, CbteTipo 1). A/B discriminate IVA per line."
    },
    "point_of_sale": {
      "type": "number",
      "description": "Punto de venta (PtoVta) registered at AFIP for electronic invoicing. Default 1."
    },
    "concept": {
      "type": "string",
      "enum": [
        "PRODUCTS",
        "SERVICES",
        "BOTH"
      ],
      "description": "Concepto: PRODUCTS (default), SERVICES, or BOTH."
    },
    "customer_doc_type": {
      "type": "string",
      "enum": [
        "CUIT",
        "DNI",
        "CF"
      ],
      "description": "Buyer document type: CUIT (80), DNI (96), or CF = Consumidor Final unidentified (99, doc number 0). Default CF for Factura B/C, CUIT for Factura A."
    },
    "customer_doc_number": {
      "type": "string",
      "description": "Buyer document number (digits only). For CF use 0 or omit. Required (non-zero) for Factura A."
    },
    "customer_iva_condition": {
      "type": "number",
      "description": "CondicionIVAReceptorId (AFIP RG 5616): 1 IVA Responsable Inscripto, 4 Exento, 5 Consumidor Final (default), 6 Responsable Monotributo."
    },
    "currency": {
      "type": "string",
      "description": "Currency code (MonId). Default PES (Argentine peso). Use with foreign currency only if your AFIP setup allows it."
    },
    "invoice_number": {
      "type": "number",
      "description": "Optional explicit invoice number (CbteDesde/Hasta). If omitted, the server queries FECompUltimoAutorizado and uses last+1."
    },
    "afip_cert": {
      "type": "string",
      "description": "Optional AFIP X.509 certificate (PEM) for prod mode. Forwarded per-request to Afip SDK, never stored or logged. Not needed in dev."
    },
    "afip_key": {
      "type": "string",
      "description": "Optional AFIP private key (PEM) for prod mode. Forwarded per-request to Afip SDK, never stored or logged. Not needed in dev."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "description": "Line items. Each: description, net_price (unit price in ARS, tax-EXCLUSIVE), optional quantity (default 1) and iva_rate (VAT percent: 0, 10.5, 21, 27; default 21; IGNORED for Factura C which does not discriminate IVA).",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "net_price": {
            "type": "number",
            "description": "Tax-exclusive unit price in ARS."
          },
          "quantity": {
            "type": "number",
            "description": "Default 1."
          },
          "iva_rate": {
            "type": "number",
            "description": "VAT rate percent: 0, 10.5, 21 (default), or 27. Ignored for Factura C."
          }
        },
        "required": [
          "description",
          "net_price"
        ]
      }
    }
  },
  "required": [
    "items"
  ]
}

query_invoice

Look up an issued Argentina electronic invoice at AFIP/ARCA by its number (FECompConsultar via WSFE). Give invoice_number, point_of_sale and invoice_type; returns the CAE, cae_expiry, total and Resultado (A = authorized/approved, R = rejected/authorized). Safe to call anytime.

Parameters3

invoice_number	number	required	The invoice number (CbteNro) returned by create_invoice.
point_of_sale	number	optional	Punto de venta (PtoVta). Default 1.
invoice_type	string	optional	Factura type A/B/C (must match how it was issued). Default C.

Raw schema

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "type": "number",
      "description": "The invoice number (CbteNro) returned by create_invoice."
    },
    "point_of_sale": {
      "type": "number",
      "description": "Punto de venta (PtoVta). Default 1."
    },
    "invoice_type": {
      "type": "string",
      "enum": [
        "A",
        "B",
        "C"
      ],
      "description": "Factura type A/B/C (must match how it was issued). Default C."
    }
  },
  "required": [
    "invoice_number"
  ]
}

get_last_invoice_number

Get the last authorized invoice number (FECompUltimoAutorizado via WSFE) for a given point of sale and invoice type — the next invoice is this number + 1. Useful to compute the next number before issuing, or to reconcile. Returns last_number and next_number.

Parameters2

point_of_sale	number	optional	Punto de venta (PtoVta). Default 1.
invoice_type	string	optional	Factura type A/B/C. Default C.

Raw schema

{
  "type": "object",
  "properties": {
    "point_of_sale": {
      "type": "number",
      "description": "Punto de venta (PtoVta). Default 1."
    },
    "invoice_type": {
      "type": "string",
      "enum": [
        "A",
        "B",
        "C"
      ],
      "description": "Factura type A/B/C. Default C."
    }
  },
  "required": []
}

README.md6 KBView on GitHub

Argentina Invoice MCP 🇦🇷 — How can my AI agent issue a factura electrónica (CAE) in Argentina?

Use it in 60 seconds

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

json

{
  "mcpServers": {
    "argentina-invoice": {
      "type": "http",
      "url": "https://inv-ar.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:

bash

git clone https://github.com/junter1989k-ai/argentina-invoice-mcp && cd argentina-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 Argentina AFIP/ARCA electronic invoices (factura electrónica) — authorizing the invoice via WSFE to get the CAE (Código de Autorización Electrónico) plus its expiry — through the Afip SDK. Stateless, bring-your-own credentials, never stores anything.

Live endpoint: https://inv-ar.wishpool.app/mcp · Registry: app.wishpool/argentina-invoice-mcp

Quick start

json

{
  "mcpServers": {
    "argentina-invoice": {
      "type": "http",
      "url": "https://inv-ar.wishpool.app/mcp",
      "headers": {
        "x-afipsdk-token": "your-afip-sdk-access-token",
        "x-afip-mode": "dev"
      }
    }
  }
}

Sign up free at app.afipsdk.com for an access_token (1000 requests/month). In dev mode no AFIP certificate is needed — the test CUIT 20409378472 works out of the box. Switch x-afip-mode to prod and pass your AFIP X.509 certificate + key per-request (afip_cert / afip_key) to authorize real invoices.

Headers

Header	Purpose
`x-afipsdk-token`	Required. Your Afip SDK access_token (Bearer). Sign up at app.afipsdk.com.
`x-afip-mode`	`dev` (default, AFIP homologación — no certificate) or `prod`.
`x-afip-cuit`	Issuer CUIT, 11 digits. Defaults to the test CUIT `20409378472` in dev.

Certificates (prod) — never stored, never logged

In prod mode, pass your own AFIP X.509 certificate and private key as per-request tool params afip_cert and afip_key (PEM strings). They are forwarded to the Afip SDK for that single request only and are never stored, logged, or persisted — sensitive material exists only for the request lifecycle. This mirrors the Afip SDK's own per-request certificate design.

Tools

Tool	What it does
`create_invoice`	Authorize a factura electrónica at AFIP/ARCA (WSFE `FECAESolicitar`) and get the `cae` (+ `cae_expiry`, `invoice_number`). You send flat fields (invoice_type, point_of_sale, customer doc, line items with `net_price` + `iva_rate`); the server computes the WSFE amounts — per-line net, IVA grouped into the `AlicIva` array, `ImpNeto` / `ImpIVA` / `ImpTotal`. The next invoice number is fetched automatically unless you pass `invoice_number`.
`query_invoice`	Status check by number (WSFE `FECompConsultar`): `cae`, `cae_expiry`, `total`, `Resultado` (A = authorized).
`get_last_invoice_number`	Last authorized number (WSFE `FECompUltimoAutorizado`) for a point of sale + type — `next_number` is this + 1.

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 amount cap/threshold applies to the invoice total (ARS).

IVA / factura types (computed for you)

Factura A (CbteTipo 1) and Factura B (CbteTipo 6) discriminate IVA: line items are grouped by alícuota (0, 10.5, 21, 27%) into the AlicIva array; ImpNeto, ImpIVA and ImpTotal are computed and reconciled.
Factura C (CbteTipo 11, monotributo) does not discriminate IVA: ImpTotal = ImpNeto, ImpIVA = 0, no AlicIva.

Example: one line net_price 100 × 1 @ 21% on a Factura B → ImpNeto 100, ImpIVA 21, ImpTotal 121 (AlicIva Id 5). The same line at 10.5% → ImpIVA 10.5; at 27% → ImpIVA 27.

There is no WSFE cancel operation in Argentina — to reverse an invoice, issue a nota de crédito (credit note) for the same amount.

Develop

bash

node test/serve.js   # local server on :3242
node test/e2e.js     # protocol + IVA math unit check (A/B/C) + validation + policy + fake-token live probe

Safety

Pure stateless translation layer. The AFIP/ARCA WSAA + WSFE certification burden sits with the Afip SDK; the access_token and (in prod) the AFIP certificate + key travel per-request in headers/params, nothing is stored. Privacy policy.

Sister servers

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

MIT licensed.

Install

Tools (3)

create_invoicequery_invoiceget_last_invoice_number

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://inv-ar.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "argentina-invoice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://inv-ar.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.