@codespar/mcp-afip 0.2.0-alpha.1 → 0.2.0-alpha.3

package/README.md

@@ -1,5 +1,8 @@
 # MCP AFIP
 
+
+> **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`.
+
 MCP server for **AFIP** — Argentine tax authority (Administracion Federal de Ingresos Publicos) for electronic invoicing (Factura Electronica) with CAE authorization.
 
 ## Quick Start
@@ -28,18 +31,30 @@ npx tsx packages/argentina/afip/src/index.ts --http
 | `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport |
 | `MCP_PORT` | No | HTTP port (default: 3000) |
 
-## Tools
+## Tools (20)
 
-| Tool | Description |
-|------|-------------|
-| `create_invoice` | Create an electronic invoice (Factura Electronica) |
-| `get_invoice` | Get invoice details by type, POS, and number |
-| `get_last_invoice_number` | Get last authorized invoice number for a POS |
-| `get_cae_status` | Check CAE authorization status |
-| `list_invoice_types` | List available invoice types (A, B, C, etc.) |
-| `list_tax_types` | List available tax types (IVA, percepciones, etc.) |
-| `get_server_status` | Check AFIP web-service availability |
-| `get_authorized_points_of_sale` | List authorized puntos de venta |
+| 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
 
@@ -51,4 +66,20 @@ Uses **certificate-based WSAA authentication** (SOAP). The MCP server wraps AFIP
 
 ---
 
-**Enterprise?** Contact us at [codespar.com](https://codespar.com) for dedicated support, custom integrations, and SLAs.
+## Enterprise
+
+Need 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.
+
+## 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

package/dist/index.js

@@ -60,7 +60,10 @@ async function afipRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-afip", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT = "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+const server = new Server({ name: "mcp-afip", version: "0.2.0-alpha.2" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -455,7 +458,7 @@ async function main() {
                 const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
                 t.onclose = () => { if (t.sessionId)
                     transports.delete(t.sessionId); };
-                const s = new Server({ name: "mcp-afip", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-afip", version: "0.2.0-alpha.2" }, { capabilities: { tools: {} } });
                 server._requestHandlers.forEach((v, k) => s._requestHandlers.set(k, v));
                 server._notificationHandlers?.forEach((v, k) => s._notificationHandlers.set(k, v));
                 await s.connect(t);

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@codespar/mcp-afip",
-  "version": "0.2.0-alpha.1",
+  "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"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js"
@@ -20,6 +22,13 @@
     "typescript": "^5.8.0"
   },
   "license": "MIT",
-  "keywords": ["afip", "tax", "argentina", "factura-electronica", "cae", "mcp"],
+  "keywords": [
+    "afip",
+    "tax",
+    "argentina",
+    "factura-electronica",
+    "cae",
+    "mcp"
+  ],
   "mcpName": "io.github.codespar/mcp-afip"
 }