MCP 服务器

keycae-mcp

Argentine electronic invoicing (facturación electrónica) MCP Server for ARCA/AFIP. Emit invoices, manage credentials, check delegations, and look up taxpayers. 10 tools.

README

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:

Ingresá a ARCA Clave Fiscal
Buscá el servicio "Facturación Electrónica" (ws://wsfe)
Delegá al CUIT representante: 20254459306 (Amilcar Waldemar Serra)
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 }]
}