@codespar/mcp-afip MCP Server

@codespar/mcp-afip is an MCP (Model Context Protocol) server for AFIP, the Argentine tax authority (Administración Federal de Ingresos Públicos). It targets electronic invoicing (Factura Electrónica) with CAE authorization. It is published as an alpha release on npm, and its endpoint paths follow public docs and BACEN/provider conventions but have not been fully validated as live.

🛠️ Key Features

MCP server for AFIP
Electronic invoicing support (Factura Electrónica)
CAE authorization referenced in documentation
npm alpha release (alpha dist-tag)

🚀 Use Cases

Integrating AFIP electronic invoicing workflows via MCP
Automating steps that require CAE authorization for invoices

⚡ Developer Benefits

Uses Model Context Protocol (MCP) for tool integration
Identified by topics including mcp, llm-tools, and fintech
MIT-licensed package

⚠️ Limitations

Alpha release; not fully live-validated
Endpoint paths follow conventions but may require version pinning

@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.

# 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

"production" or "homologation" (default: homologation)

MCP_HTTP

Set to "true" to enable HTTP transport

MCP_PORT

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

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.

Install

Configuration

Environment variables

AFIP_CERT_PATHrequired

Path to AFIP certificate (.crt)

AFIP_KEY_PATHrequiredsecret

Path to AFIP private key (.key)

AFIP_CUITrequired

CUIT number

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-afip": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-afip@0.2.0-alpha.3"
      ],
      "env": {
        "AFIP_CERT_PATH": "<YOUR_AFIP_CERT_PATH>",
        "AFIP_KEY_PATH": "<YOUR_AFIP_KEY_PATH>",
        "AFIP_CUIT": "<YOUR_AFIP_CUIT>"
      }
    }
  }
}

io.github.codespar/mcp-afip

@codespar/mcp-afip MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

@codespar/mcp-afip

Quick Start

Environment Variables

Tools (20)

Auth

API Reference

Enterprise

Authentication

License

Install

Configuration

Related servers