keycae-mcp 🔌

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

Let AI agents emit invoices, manage credentials, and handle delegations directly.

⚡ Quick Start

npx keycae-mcp

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

⚠️ 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

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_live_..."
      }
    }
  }
}

Cursor / Windsurf

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

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

🛠️ Available Tools

| Tool | Description | |------|-------------| | emit_invoice | Emit an Argentine electronic invoice (A, B, C, M, E) | | get_invoice | Get details of a previously emitted invoice | | list_invoices | List recent invoices | | list_credentials | List digital certificates for the CUIT | | create_credential | Generate RSA keypair + CSR for ARCA | | check_delegation | Check ARCA delegation status | | request_delegation | Request ARCA delegation for invoicing | | lookup_taxpayer | Look up taxpayer by CUIT | | get_billing_status | Check billing plan and usage | | keycae_health | Health check |

💡 Example Usage

1. Check if ready to invoice

User: ¿Puedo facturar con el CUIT 20254459306?

Agent calls check_delegation → confirms delegation is active, then list_credentials → confirms certificate is valid.

2. Request delegation (if not done)

User: Necesito delegar mi facturación a KeyCAE

Agent calls request_delegation → starts the delegation process.

3. Emit a Factura B

User: Emití una factura B al CUIT 20333444555 por $15.000 ARS por "Servicios de consulting"

Agent calls emit_invoice:

{
  "cuit_emisor": "20254459306",
  "punto_de_venta": 3,
  "tipo_comprobante": "B",
  "receptor": { "tipo_doc": "CUIT", "nro_doc": "20333444555" },
  "conceptos": [{ "descripcion": "Servicios de consulting", "precio": 15000 }]
}

📋 Invoice Types

| Type | Description | When to use | |------|-------------|-------------| | A | IVA discriminado | RI → RI | | B | IVA incluido | RI → Consumidor Final | | C | Exento | No genera IVA | | M | Monotributo | Monotributo emitter | | E | Exportación | International clients |

🔗 Links

• 🌐 keycae.ar — API & Dashboard
• 📖 docs.keycae.ar — Documentation
• 📄 llms.txt — AI Agent Reference
• 🔌 mcp.so — MCP Directory
• 🤖 glama.ai — Glama Directory

📦 Related Packages

• keycae-ts — TypeScript SDK
• keycae-cli — CLI tool

📄 License

MIT