arca-agent-skills 🤖

Configuración de Agentic AI para facturar en ARCA (ex AFIP) a través de la API de KeyCAE.ar.

Dos cosas en un paquete: el prompt maestro que le enseña a tu agente a operar, y el servidor MCP con los nombres de las tools en español.

1 · SKILL.md — el prompt maestro

Copiá su contenido dentro de tu .cursorrules, tu CLAUDE.md, o el equivalente de Windsurf. Le enseña al agente las cuatro cosas que hace mal sin contexto:

• Delegación directa (zero-certificate): no tiene que generar ni pedir certificados.
• Idempotency-Key: cómo no emitir dos veces el mismo comprobante. Si se omite, la llamada funciona igual y queda sin protección contra un reintento — que es el escenario peligroso.
• Auto-sanación con ai_action_hint: cada error de la API le dice cómo corregirse.
• Envío del PDF por correo, con Reply-To configurable por emisor o por comprobante.

Trae además un cheat-sheet con seis casos resueltos: inicializar el cliente, validar un CUIT, chequear si puede emitir, emitir con idempotencia, listar, y ver el estado de facturación.

2 · Servidor MCP con nombres en español

npx arca-agent-skills

{
  "mcpServers": {
    "arca": {
      "command": "npx",
      "args": ["-y", "arca-agent-skills"],
      "env": { "KEYCAE_API_KEY": "sk_test_public_sandbox_cuit_20999999999" }
    }
  }
}

Expone las 15 tools de keycae-mcp con nombres en español: emitir_factura, validar_cuit, registrar_delegacion, consultar_delegacion, consultar_factura, listar_facturas, listar_credenciales, crear_credencial, consultar_emision, estado_facturacion, listar_puntos_de_venta, health_check, reporte_ventas, condiciones_iva, cotizacion.

Los schemas y las descripciones son exactamente los mismos que en keycae-mcp, porque se importan de ahí en lugar de reescribirse. Lo único que cambia es el nombre.

Si preferís los nombres en inglés, usá keycae-mcp directamente. Los dos paquetes hablan con la misma API y exponen las mismas herramientas.

Cambios en 2.0.0

Antes este paquete definía sus propias 12 tools contra la misma API, con schemas y descripciones escritos aparte de los de keycae-mcp. Las dos copias se corrieron. Ahora importa las definiciones, así que:

• Las 15 tools, no 12. Se suman reporte_ventas, condiciones_iva y cotizacion.
• emitir_factura pasó de 21 a 28 campos. Faltaban iva_incluido, los cuatro emisor_* y los dos isib_caba_*, todos aceptados por la API.
• Las descripciones dejaron de contradecir a las de keycae-mcp. En un servidor MCP la descripción es la interfaz: el agente no lee el código, lee ese texto y actúa. La copia vieja afirmaba que idempotency_key era obligatoria en producción, no aclaraba que fecha_emision es en hora de Argentina, y omitía que el período facturado no está limitado por la ventana de fecha_emision.

Es una mayor porque las tools cambian de forma y de texto. La API es la misma y no hace falta tocar nada del lado del servidor.

Licencia

MIT