keycae-mcp 🔌

MCP Server for KeyCAE.ar — Argentine electronic invoicing (facturación electrónica) with ARCA/AFIP.

Let AI agents emit invoices, manage credentials, handle delegations, and more — directly from Claude, Cursor, Windsurf, or any MCP-compatible client.

⚡ Quick Start

npx keycae-mcp

That's it. Your AI agent now has 15 tools for Argentine invoicing.

☁️ Remote MCP Server (no installation required)

KeyCAE also exposes a Streamable HTTP MCP server — no npx, no local setup.

Endpoint: https://keycae.ar/v1/mcp

{
  "mcpServers": {
    "keycae-remote": {
      "url": "https://keycae.ar/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

⚠️ Requisito: Delegación en ARCA

ANTES de facturar, debés delegar la facturación electrónica al representante de KeyCAE en ARCA:

1. Ingresá a ARCA Clave Fiscal
2. Buscá el servicio "Facturación Electrónica" (ws://wsfe)
3. Delegá al CUIT representante: 20254459306 (Amilcar Waldemar Serra)
4. Aceptá la relación de representación

Sin esta delegación, no podés emitir facturas. El MCP server te permite verificar el estado con check_delegation y solicitarla con request_delegation.

🔧 Configuration

The MCP server requires a KEYCAE_API_KEY to run. You can configure it with:

• Sandbox Mode (No registration needed): Use the public sandbox key sk_test_public_sandbox_cuit_20999999999. Note that in Sandbox mode you must emit using CUIT 20999999999.
• Production Mode: Use your live API key sk_live_... generated when registering on keycae.ar.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "keycae": {
      "command": "npx",
      "args": ["-y", "keycae-mcp"],
      "env": {
        "KEYCAE_API_KEY": "sk_test_public_sandbox_cuit_20999999999"
      }
    }
  }
}

Cursor / Windsurf

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "keycae": {
      "command": "npx",
      "args": ["-y", "keycae-mcp"],
      "env": {
        "KEYCAE_API_KEY": "sk_test_public_sandbox_cuit_20999999999"
      }
    }
  }
}

🛠️ Available Tools (15)

| Tool | Description | |------|-------------| | emit_invoice | Emitir factura (24 tipos) y opcionalmente enviar el PDF por correo con email, enviar_email y email_respuesta. También soporta precios netos, tributos, moneda extranjera y datos del emisor. | | get_invoice | Consultar factura por ID | | list_invoices | Listar facturas recientes | | get_sales_report | Reporte mensual de ventas para el contador (por tipo y alícuota; NC restan, ND suman) | | list_credentials | Listar certificados digitales | | create_credential | Generar RSA keypair + CSR para ARCA | | check_delegation | Verificar delegación ARCA | | request_delegation | Solicitar delegación ARCA | | lookup_taxpayer | Buscar contribuyente por CUIT | | check_emission_capability | Verificar qué tipos de factura puede emitir un CUIT | | get_condiciones_iva | Tabla de 15 condiciones IVA del receptor (códigos oficiales ARCA) | | get_billing_status | Estado del plan y consumo | | list_puntos_de_venta | Listar puntos de venta habilitados | | get_cotizacion | Consultar cotización de una moneda extranjera contra el peso | | keycae_health | Health check de la API |

📖 Resources

The server also exposes a keycae://docs resource with inline documentation covering invoice types, common workflows, and ARCA/AFIP notes.

🔄 Workflow Típico

1. check_delegation  → Verificar que el CUIT esté delegado
2. list_credentials  → Verificar que el certificado esté activo
3. check_emission_capability → Saber qué tipos de factura puede emitir
4. emit_invoice      → Emitir la factura
5. get_invoice       → Consultar detalles

✉️ Enviar el comprobante por correo

En emit_invoice, usá:

{
  "email": "[email protected]",
  "enviar_email": true,
  "email_respuesta": "[email protected]"
}

email_respuesta es opcional. Si falta, KeyCAE usa el correo configurado por el emisor en Dashboard → Personalizar PDF → Correo para respuestas y luego el correo de acceso de su cuenta.

El destinatario ve la razón social del comercio como nombre del remitente sobre la dirección técnica verificada de KeyCAE, por ejemplo OSOBIG MARKET S.A.S <[email protected]>.

📋 Tipos de Comprobante

| Tipo | Descripción | Quién emite | |------|-------------|-------------| | A | IVA discriminado | Responsable Inscripto → RI | | B | IVA incluido | RI → Consumidor Final | | C | Exento (sin IVA) | Monotributo / Exento | | M | Monotributo | Monotributista | | E | Exportación | Exportadores |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | KEYCAE_API_KEY | ✅ | — | Your KeyCAE API key | | KEYCAE_API_URL | ❌ | https://keycae.ar | API base URL |

Licencia

MIT