{"_id":"@codespar/mcp-afip","_rev":"5-4f162b59613e04dfcba9f061a3ffad45","name":"@codespar/mcp-afip","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-afip","version":"0.1.0","keywords":["afip","tax","argentina","factura-electronica","cae","mcp"],"license":"MIT","_id":"@codespar/mcp-afip@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-afip":"dist/index.js"},"dist":{"shasum":"de1031ed97cfa76a48c694707820884eb3e5f9be","tarball":"https://registry.npmjs.org/@codespar/mcp-afip/-/mcp-afip-0.1.0.tgz","fileCount":4,"integrity":"sha512-iMriqJNC1ypotdcL3Ml53nOC2z1Gn/4gvdLzRbaWRyeSJYOpbX23foqBTgB7RkxF6G/kFIxwf1XYKbwPkf5fKw==","signatures":[{"sig":"MEUCIFDwgHFu05cpMhZ1vSmv65Khyph3DV2OINg6UsTfI3tUAiEAu2qTQpi1S9VhnzD1SnteP4dzX/2XchYgnYYhelgqjo0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15702},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"459fc3c9039fafd260f0a7c105571a27b9be61cf","mcpName":"io.github.codespar/mcp-afip","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for AFIP — Argentine tax authority, electronic invoicing (Factura Electrónica)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-afip_0.1.0_1776012070640_0.23332694386712993","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-afip","version":"0.2.0-alpha.1","keywords":["afip","tax","argentina","factura-electronica","cae","mcp"],"license":"MIT","_id":"@codespar/mcp-afip@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-afip":"dist/index.js"},"dist":{"shasum":"0ff7d9fddafda5e2634513a2f972e0424639aeea","tarball":"https://registry.npmjs.org/@codespar/mcp-afip/-/mcp-afip-0.2.0-alpha.1.tgz","fileCount":4,"integrity":"sha512-Ny8ME5kS16O7RFkxtUgut1D+gP4/0Cw6H+fXNSMwTmmwh4aNx1ceUGGKDgFURDfaYr4lqG3H0OZVAkqTauH8hQ==","signatures":[{"sig":"MEUCIGiY/qMNt2RoxFHlHTJ4uy1qF6oRyFG7eRT4/CXLKtvoAiEApayaaIc46pVc1IqNnGKsFqaMYfwuVrHxyCn1f0pUFI4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30797},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a9ff36701206eb6feb7fffffc4cbb2a325757082","mcpName":"io.github.codespar/mcp-afip","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for AFIP — Argentine tax authority, electronic invoicing (Factura Electrónica)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-afip_0.2.0-alpha.1_1777115944564_0.6768452622216177","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-afip","version":"0.2.0-alpha.2","keywords":["afip","tax","argentina","factura-electronica","cae","mcp"],"license":"MIT","_id":"@codespar/mcp-afip@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-afip":"dist/index.js"},"dist":{"shasum":"810736d095b4c30921823041f4818f0fe1d8d8fb","tarball":"https://registry.npmjs.org/@codespar/mcp-afip/-/mcp-afip-0.2.0-alpha.2.tgz","fileCount":4,"integrity":"sha512-EFr0aeJyyu6EWFTjKGaAiAH5XdJrk0cXWDghCl0hwlVazvb8mhOwTeMQ0ldT7mN0poAHAiVdwQSDGHXHMS7tdQ==","signatures":[{"sig":"MEQCICVBlcGznmRq6Amu4tmCFqREEAnvsNvvigxFZv1i89asAiAVxpAyJVOL4Q1Xdk/BJCScZtf3zMrxEsBf0aWvID3vBw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32464},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b8f7e5b70db9046319ed757225e0eae8f2dc4451","mcpName":"io.github.codespar/mcp-afip","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for AFIP — Argentine tax authority, electronic invoicing (Factura Electrónica)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-afip_0.2.0-alpha.2_1777122879394_0.3392841235972861","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-afip","version":"0.2.0-alpha.3","description":"MCP server for AFIP — Argentine tax authority, electronic invoicing (Factura Electrónica)","type":"module","main":"dist/index.js","bin":{"mcp-afip":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["afip","tax","argentina","factura-electronica","cae","mcp"],"mcpName":"io.github.codespar/mcp-afip","_id":"@codespar/mcp-afip@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-N9XDHKV+ASA9L3IPBLsMjfgz+rteVYfJTQSFjTu2ULQd6n3hfC32AmbYgVQ1p9VjmSic9V9dU+yosRPL/NlvGQ==","shasum":"8f7e66fb8a44bf43f4c001b7e83979fd28099787","tarball":"https://registry.npmjs.org/@codespar/mcp-afip/-/mcp-afip-0.2.0-alpha.3.tgz","fileCount":4,"unpackedSize":33422,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDe+zW3FXqhsdPBLfQA3Ow8G9wjYAmOLyY0CvY3A9FC4AIhAMijqghPSTEyhGvRVSP7fjf+RUQJVuQrCMgvIk6af5lA"}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-afip_0.2.0-alpha.3_1782153335175_0.1602295169785053"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-12T16:41:10.412Z","modified":"2026-06-22T18:35:35.479Z","0.1.0":"2026-04-12T16:41:10.795Z","0.2.0-alpha.1":"2026-04-25T11:19:04.694Z","0.2.0-alpha.2":"2026-04-25T13:14:39.528Z","0.2.0-alpha.3":"2026-06-22T18:35:35.332Z"},"license":"MIT","keywords":["afip","tax","argentina","factura-electronica","cae","mcp"],"description":"MCP server for AFIP — Argentine tax authority, electronic invoicing (Factura Electrónica)","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# MCP AFIP\n\n\n> **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 <pkg>@alpha`.\n\nMCP server for **AFIP** — Argentine tax authority (Administracion Federal de Ingresos Publicos) for electronic invoicing (Factura Electronica) with CAE authorization.\n\n## Quick Start\n\n```bash\n# Set your credentials\nexport AFIP_CERT_PATH=\"/path/to/cert.crt\"\nexport AFIP_KEY_PATH=\"/path/to/key.key\"\nexport AFIP_CUIT=\"20123456789\"\n\n# Run via stdio\nnpx tsx packages/argentina/afip/src/index.ts\n\n# Run via HTTP\nnpx tsx packages/argentina/afip/src/index.ts --http\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `AFIP_CERT_PATH` | Yes | Path to AFIP certificate (.crt) |\n| `AFIP_KEY_PATH` | Yes | Path to AFIP private key (.key) |\n| `AFIP_CUIT` | Yes | CUIT number of the taxpayer |\n| `AFIP_ENV` | No | `\"production\"` or `\"homologation\"` (default: homologation) |\n| `MCP_HTTP` | No | Set to `\"true\"` to enable HTTP transport |\n| `MCP_PORT` | No | HTTP port (default: 3000) |\n\n## Tools (20)\n\n| Tool | Purpose |\n|---|---|\n| `create_invoice` | Create an electronic invoice (Factura Electrónica) via AFIP |\n| `get_invoice` | Get invoice details by type, point of sale, and number |\n| `get_last_invoice_number` | Get last authorized invoice number for a point of sale and type |\n| `get_cae_status` | Check CAE authorization status for an invoice |\n| `list_invoice_types` | List available invoice types (Factura A, B, C, etc.) |\n| `list_tax_types` | List available tax types (IVA, percepciones, retenciones, etc.) |\n| `get_server_status` | Check AFIP web-service availability (WSFE status) |\n| `get_authorized_points_of_sale` | List authorized puntos de venta for the CUIT |\n| `create_invoice_batch` | Create a batch of invoices in a single CAE request (FECAESolicitar, up to 250) |\n| `create_credit_note` | Issue a credit note (Nota de Crédito A/B/C: types 3, 8, 13) referencing an original invoice |\n| `create_debit_note` | Issue a debit note (Nota de Débito A/B/C: types 2, 7, 12) referencing an original invoice |\n| `cancel_invoice` | Cancel/void an authorized invoice (FECancel — limited to certain types/conditions) |\n| `get_invoice_total_x_request` | Max number of records allowed per FECAESolicitar request (FECompTotXRequest) |\n| `list_concept_types` | List available concept types (FEParamGetTiposConcepto: 1=Products, 2=Services, 3=Both) |\n| `list_doc_types` | List document/identifier types (FEParamGetTiposDoc: 80=CUIT, 86=CUIL, 96=DNI, 99=Consumer Final) |\n| `list_iva_types` | List IVA tax aliquots (FEParamGetTiposIva: 21%, 10.5%, 27%, 0%, etc.) |\n| `list_currency_types` | List supported currencies (FEParamGetTiposMonedas) |\n| `get_currency_rate` | Get FX rate (cotización) for a currency vs ARS (FEParamGetCotizacion) |\n| `lookup_taxpayer` | Padrón lookup by CUIT (WS_SR_PADRON A4/A5/A13 — fiscal status, name, address) |\n| `get_registration_certificate` | Get constancia de inscripción (registration certificate) for a CUIT |\n\n## Auth\n\nUses **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.\n\n## API Reference\n\n- [AFIP Web Services Documentation](https://www.afip.gob.ar/ws/)\n\n---\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## Authentication\n\nSet these environment variables before launching the server:\n\n- `AFIP_CERT_PATH` *(required)* — Path to AFIP certificate (.crt)\n- `AFIP_KEY_PATH` *(required, secret)* — Path to AFIP private key (.key)\n- `AFIP_CUIT` *(required)* — CUIT number\n\nIssue credentials at the provider's developer portal: <https://www.afip.gob.ar/ws>.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}