mcp-afip — Claude Code MCP server: what it does, how to install
Connects AI coding tools to Argentina's AFIP tax web services for electronic invoicing and CAE authorization. Helpful when automating Argentine billing routines.
claude mcp add mcp-afip -e AFIP_CERT_PATH=<AFIP_CERT_PATH> -e AFIP_KEY_PATH=<AFIP_KEY_PATH> -e AFIP_CUIT=<AFIP_CUIT> -- npx -y @codespar/mcp-afipWhat mcp-afip does
This server exposes 20 tools allowing an assistant to communicate directly with AFIP services. It handles Factura Electrónica generation, queries last invoice numbers, checks CAE authorization codes, and sends batch submissions of up to 250 records.
Under the hood, it abstracts AFIP's SOAP and WSAA certificate authentication into clean tool calls. Connecting requires an official .crt certificate, a private .key file, and a taxpayer CUIT. By default, queries run against the homologation test environment.
Because endpoint paths are not fully live-tested in this alpha stage, pinning exact package versions avoids unexpected breaks. Transport works over stdio or HTTP via port 3000.
What it helps with
- issue electronic invoices with CAE authorization numbers
- look up taxpayer fiscal details using CUIT in Padrón
- generate debit or credit notes tied to past invoices
- submit batch invoice requests up to 250 items at once
Example prompts for the agent
- Look up taxpayer information in the Padrón for CUIT 20123456789
- Create a type B invoice for a final consumer and request the CAE
- Fetch the last authorized invoice number for point of sale 1
How to install mcp-afip
Platform CLI
claude mcp add mcp-afip -e AFIP_CERT_PATH=<AFIP_CERT_PATH> -e AFIP_KEY_PATH=<AFIP_KEY_PATH> -e AFIP_CUIT=<AFIP_CUIT> -- npx -y @codespar/mcp-afipReplace <…> with your own values
Platform CLI
codex mcp add afip --env AFIP_CERT_PATH=<AFIP_CERT_PATH> --env AFIP_KEY_PATH=<AFIP_KEY_PATH> --env AFIP_CUIT=<AFIP_CUIT> -- npx -y @codespar/mcp-afipReplace <…> with your own values
Config file
{
"mcpServers": {
"afip": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-afip"
],
"env": {
"AFIP_CERT_PATH": "<AFIP_CERT_PATH>",
"AFIP_KEY_PATH": "<AFIP_KEY_PATH>",
"AFIP_CUIT": "<AFIP_CUIT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"afip": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-afip"
],
"env": {
"AFIP_CERT_PATH": "<AFIP_CERT_PATH>",
"AFIP_KEY_PATH": "<AFIP_KEY_PATH>",
"AFIP_CUIT": "<AFIP_CUIT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e AFIP_CERT_PATH=<AFIP_CERT_PATH> -e AFIP_KEY_PATH=<AFIP_KEY_PATH> -e AFIP_CUIT=<AFIP_CUIT> afip npx -y @codespar/mcp-afipReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-afip
How to install mcp-afip in Claude Code?
Run `claude mcp add mcp-afip -e AFIP_CERT_PATH=<AFIP_CERT_PATH> -e AFIP_KEY_PATH=<AFIP_KEY_PATH> -e AFIP_CUIT=<AFIP_CUIT> -- npx -y @codespar/mcp-afip`. Replace the placeholders with your actual certificate path, key path, and CUIT.
What does mcp-afip do?
It provides MCP tools to interface with Argentina's tax agency, enabling billing agents to emit invoices, verify CAE status, and inspect taxpayer records.
What credentials does mcp-afip require?
You need a valid certificate .crt, a private key .key, and an AFIP CUIT number. Without these files configured in environment variables, authentication via WSAA will fail.
