mcp-afip

@codespar/mcp-afip

MCP server for AFIP, the Argentine tax authority (Administracion Federal de Ingresos Publicos), for electronic invoicing (Factura Electronica) with CAE authorization

Alpha release — published under the alpha npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during 0.x.x-alpha. Install with npm install @codespar/mcp-afip@alpha.

Quick Start

# Set your credentials
export AFIP_CERT_PATH="/path/to/cert.crt"
export AFIP_KEY_PATH="/path/to/key.key"
export AFIP_CUIT="20123456789"

# Run via stdio
npx -y @codespar/mcp-afip@alpha

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-afip@alpha

Environment Variables

Variable	Required	Description
AFIP_CERT_PATH	Yes	Path to AFIP certificate (.crt)
AFIP_KEY_PATH	Yes	Path to AFIP private key (.key)
AFIP_CUIT	Yes	CUIT number of the taxpayer
AFIP_ENV	No	"production" or "homologation" (default: homologation)
MCP_HTTP	No	Set to "true" to enable HTTP transport
MCP_PORT	No	HTTP port (default: 3000)

Tools (20)

Tool	Purpose
create_invoice	Create an electronic invoice (Factura Electrónica) via AFIP
get_invoice	Get invoice details by type, point of sale, and number
get_last_invoice_number	Get last authorized invoice number for a point of sale and type
get_cae_status	Check CAE authorization status for an invoice
list_invoice_types	List available invoice types (Factura A, B, C, etc.)
list_tax_types	List available tax types (IVA, percepciones, retenciones, etc.)
get_server_status	Check AFIP web-service availability (WSFE status)
get_authorized_points_of_sale	List authorized puntos de venta for the CUIT
create_invoice_batch	Create a batch of invoices in a single CAE request (FECAESolicitar, up to 250)
create_credit_note	Issue a credit note (Nota de Crédito A/B/C: types 3, 8, 13) referencing an original invoice
create_debit_note	Issue a debit note (Nota de Débito A/B/C: types 2, 7, 12) referencing an original invoice
cancel_invoice	Cancel/void an authorized invoice (FECancel — limited to certain types/conditions)
get_invoice_total_x_request	Max number of records allowed per FECAESolicitar request (FECompTotXRequest)
list_concept_types	List available concept types (FEParamGetTiposConcepto: 1=Products, 2=Services, 3=Both)
list_doc_types	List document/identifier types (FEParamGetTiposDoc: 80=CUIT, 86=CUIL, 96=DNI, 99=Consumer Final)
list_iva_types	List IVA tax aliquots (FEParamGetTiposIva: 21%, 10.5%, 27%, 0%, etc.)
list_currency_types	List supported currencies (FEParamGetTiposMonedas)
get_currency_rate	Get FX rate (cotización) for a currency vs ARS (FEParamGetCotizacion)
lookup_taxpayer	Padrón lookup by CUIT (WS_SR_PADRON A4/A5/A13 — fiscal status, name, address)
get_registration_certificate	Get constancia de inscripción (registration certificate) for a CUIT

Auth

Uses certificate-based WSAA authentication (SOAP). The MCP server wraps AFIP's SOAP services (WSFE) internally using a REST approach. You need a valid certificate issued by AFIP. For testing, use the homologation environment.

API Reference

• AFIP Web Services Documentation

---

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

• AFIP_CERT_PATH (required) — Path to AFIP certificate (.crt)
• AFIP_KEY_PATH (required, secret) — Path to AFIP private key (.key)
• AFIP_CUIT (required) — CUIT number

Issue credentials at the provider's developer portal: https://www.afip.gob.ar/ws.

License

MIT