ARCA Invoice MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ARCA Invoice MCP prepare an invoice for the sale to customer 20-30112223-4"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ARCA Invoice MCP
Local MCP server for preparing and issuing ARCA Factura C invoices through the official RCEL protocol.
Authentication uses direct HTTP by default, including the JSF login, JWT bridge, portal service grant, RCEL SSO, and taxpayer selection. Browser fallback is disabled: if direct authentication fails, the MCP returns the error without opening Chrome. A browser can only be enabled explicitly with ARCA_AUTH_FALLBACK=headless or ARCA_AUTH_FALLBACK=visible. The invoice flow itself always uses direct HTTP requests reconstructed from an observed HAR.
The server deliberately separates preview from issuance:
arca_prepare_invoicesends the four RCEL form requests, records a HAR, and returns a structured preview plus a one-time approval token.A human reviews the returned summary.
arca_issue_invoicerequires the exact token, re-reads the preview, emits once, downloads the official PDF, and flushes a full HAR.
arca_list_invoices queries issued Factura C records by date range directly from RCEL. Prepared or discarded previews never appear in that list because ARCA has not assigned them a number or CAE.
Security
Keep
CUILandPASSonly in.env; the file is ignored by Git.HAR, browser state, and PDFs are ignored by Git.
HAR files can contain session cookies and taxpayer/customer information. They are written with owner-only permissions and must be treated as credentials.
The client refuses to send ARCA data to hosts outside the official AFIP/ARCA domains.
Authentication requests are intentionally excluded from HAR so the password is never recorded. RCEL cookies are redacted in the generated HAR.
If issuance returns an uncertain result, do not retry. Check
Consultasin RCEL first.Use this project only with an ARCA account and taxpayer you are authorized to operate.
See SECURITY.md before sharing logs or reporting a vulnerability.
Related MCP server: keycae-mcp
Requirements
Node.js 20 or newer.
pdftotextfrom Poppler when invoices will be issued through the MCP.Google Chrome only if an explicit authentication fallback is enabled.
Why Poppler is needed
Poppler is not an ARCA requirement and is not needed to authenticate, list invoices or prepare a preview. After arca_issue_invoice sends the irreversible issuance request and downloads the official PDF, the MCP runs pdftotext to extract and verify the invoice number, CAE and CAE expiration date.
Install Poppler before using the issuance tool:
# macOS
brew install poppler
# Debian / Ubuntu
sudo apt-get install poppler-utilsIf pdftotext is unavailable at that point, ARCA may already have issued the invoice even though local verification fails. Do not retry the issuance request: check the invoice through arca_list_invoices or RCEL Consultas first.
Run
npm ci
cp .env.example .env
# Complete CUIL and PASS in .env without committing it.
npm startUse either npm ci or npm install; npm ci is recommended when using the committed lockfile.
The server uses Google Chrome on macOS by default. Override it with ARCA_CHROME_PATH. Set ARCA_HEADLESS=1 only after validating that ARCA accepts the environment.
Example Codex MCP configuration:
[mcp_servers.arca_invoice]
command = "node"
args = ["/absolute/path/to/arca-invoice-mcp/src/index.mjs"]
cwd = "/absolute/path/to/arca-invoice-mcp"Validate locally
These checks do not authenticate with ARCA or issue invoices:
npm run check
npm test
npm audit --omit=devOperational warning
arca_issue_invoice performs an irreversible external action. Always present the preview to a human, receive explicit approval for that exact preview, and call the issue tool only once. Never commit or share .env, .state, PDFs, HAR files, cookies, approval tokens, taxpayer data, or customer data.
Available Tools
5 toolsarca_discard_prepared_invoiceDiscard prepared invoiceB
Close the current preview without issuing an invoice.
Inputs: no named parameters.
arca_invoice_statusARCA invoice session statusA
Read whether the local ARCA session has a prepared invoice. Does not mutate ARCA.
Inputs: no named parameters.
arca_issue_invoiceIssue prepared ARCA invoiceA
Irreversibly issue the currently prepared invoice. Call only after showing the preview and receiving explicit user approval. Never retry automatically after an uncertain response.
Inputs: approvalToken (required).
arca_list_invoicesList issued ARCA invoicesA
Read issued Factura C records from official ARCA RCEL for a date range. This tool is read-only and does not include unissued previews.
Inputs: dateTo (required), dateFrom (required), pointOfSale, receiverCuit.
arca_prepare_invoicePrepare ARCA invoiceA
Prepare a Factura C through direct HTTP calls to official ARCA RCEL. Authentication is direct HTTP by default, with browser fallback only when explicitly configured. This tool never issues the invoice. Show the preview and obtain explicit approval before calling arca_issue_invoice.
Inputs: amount (required), dueDate (required), periodTo (required), periodFrom (required), +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool covers a distinct action: prepare, issue, list, discard, and status. These lifecycle stages are clearly separated, so an agent can unambiguously select the correct tool for a given need.
Four of the five tools follow the arca_verb_noun pattern (arca_prepare_invoice, arca_issue_invoice, arca_list_invoices, arca_discard_prepared_invoice). However, arca_invoice_status breaks this pattern by using a noun-like 'status' instead of a verb, causing a minor inconsistency.
With 5 tools, the server is well-scoped for its invoice lifecycle purpose. Each tool earns its place without redundancy or bloat, fitting the ideal 3-15 range.
The lifecycle of prepare, issue, discard, list, and local status covers the core workflow. However, after an uncertain issue response, there is no direct tool to verify the invoice status on the ARCA side (list_invoices requires knowing the date range and may not be real-time), leaving a minor gap in uncertainty resolution.
Related MCP Connectors
Argentina AFIP/ARCA electronic invoices for AI agents - issue & query facturas, get CAE via WSFE.
Facturas electrónicas ARCA (ex AFIP) para Argentina: alta de CUIT, facturas con CAE, PDF y mail.
Brazilian e-invoicing (NF-e, NFC-e, NFS-e): issue, cancel and query fiscal documents, plus AP/AR.
Issue and manage Brazilian fiscal documents: NF-e for goods, NFS-e for services.
Related MCP Servers
- AlicenseBqualityBmaintenanceModel Context Protocol (MCP) server for Spanish Electronic Invoicing. Provides tools to generate, validate, and submit invoices across VERI\*FACTU, Facturae/FACe, SII, TicketBAI, and Crea y Crece B2B.20169 PyPI3Apache 2.0
- AlicenseAqualityFmaintenanceArgentine electronic invoicing (facturación electrónica) MCP Server for ARCA/AFIP. Emit invoices, manage credentials, check delegations, and look up taxpayers. 10 tools.12378 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to submit Uruguay DGI e-Factura (CFE) documents to the DGI webservice as a stateless forwarder; signing stays merchant-side, and it supports test, homologation, and production endpoints.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server to issue ARCA/AFIP Factura C for monotributistas using Afip SDK, PostgreSQL, and a secure preview-before-emission flow.MIT