Saltar al contenido
firmo

Servidor MCP para e-CFQue tu agente de IA facture.

MCP (Model Context Protocol) es el estándar con el que Claude, Cursor y otros asistentes usan herramientas externas. Con el servidor de Firmo, tu agente puede emitir, consultar, aprobar y anular e-CF con tu API key.

Disponible

Ejemplo

  1. TúFactúrale a Ferretería El Puente, RNC 131000000, 20 sacos de cemento a RD$500. Crédito fiscal.
  2. calcular_totales → RD$10,000 + ITBIS RD$1,800 = RD$11,800

  3. emitir_ecf → E310000000001 · aceptado

  4. AgenteListo. La factura E310000000001 fue aceptada por RD$11,800. ¿Se la envío por correo?

Configuración

Conéctalo en un minuto.

El servidor local corre con npx -y @firmo-ecf/mcp y lee tu key de FIRMO_API_KEY. No hay que instalar nada más.
{
  "mcpServers": {
    "firmo": {
      "command": "npx",
      "args": ["-y", "@firmo-ecf/mcp"],
      "env": { "FIRMO_API_KEY": "sk_test_…" }
    }
  }
}
Empieza con una key sk_test_. Con una key sk_live_, el agente emite e-CF con validez fiscal.

MCP remoto

O sin instalar nada.

Para clientes que admiten servidores remotos por HTTP, usa https://api.firmo.do/mcp con tu API key.
Configuración remota
{
  "mcpServers": {
    "firmo": {
      "type": "http",
      "url": "https://api.firmo.do/mcp",
      "headers": { "Authorization": "Bearer sk_test_…" }
    }
  }
}

Herramientas

36 herramientas, las mismas reglas que la API.

Cada herramienta llama a la API de Firmo con tu key, salvo dos que calculan en local sin usar la red.

e-CF emitidos

  • emitir_ecfEmite un e-CF (POST /v1/ecf).
  • obtener_ecfObtiene un e-CF por id o e-NCF.
  • listar_ecfLista e-CF con filtros de estado, tipo y fechas.
  • descargar_xml_ecfDescarga el XML firmado.
  • reenviar_ecfReintenta el envío del mismo XML de un e-CF en error o pendiente sin avanzar.
  • reporte_facturasReporte de un periodo (hoy, ayer, semana, mes o rango): totales por estado y canal, monto e ITBIS.
  • facturas_que_requieren_atencionLista lo que está en error, rechazado sin corregir o sin avanzar, con la acción sugerida.
  • reintentar_envioReintenta el envío a la DGII de un e-CF en error o pendiente sin avanzar.
  • consultar_estado_dgii_ecfConsulta en la DGII el estado real de un e-CF propio por id y lo actualiza.
  • corregir_ecf_rechazadoReemite un rechazado corregido: mismo e-NCF si la DGII lo permite, si no uno nuevo enlazado.
  • reenviar_pendientesReenvía en lote lo pendiente o con error (máx. 100). Pide confirmación al usuario.
  • enviar_ecf_por_correoEnvía la representación impresa por correo.
  • anular_secuenciasAnula rangos de e-NCF no usados (ANECF).

Recibidos

  • listar_recibidosLista los e-CF recibidos de suplidores.
  • aprobar_recibidoAprueba comercialmente un e-CF recibido.
  • rechazar_recibidoRechaza comercialmente un e-CF recibido, con motivo.
  • consultar_estado_dgiiConsulta en la DGII el estado de un e-CF, propio o de terceros.

Reportes contables DGII

  • reporte_606Formato 606 (compras) del mes: totales, advertencias y filas; o el TXT oficial. Borrador para el contador.
  • reporte_607Formato 607 (ventas) del mes, con el resumen de facturas de consumo.
  • reporte_608Formato 608 (comprobantes anulados) del mes.
  • reporte_609Formato 609 (pagos al exterior) del mes.
  • resumen_fiscalDatos para el IT-1 (ITBIS) y el IR-17 (retenciones de ISR) del mes.
  • listar_compras_manualesLista las compras con comprobante de papel anotadas para el 606.
  • registrar_compra_manualAnota una compra con comprobante de papel para el 606.

Empresa y configuración

  • ver_empresaMuestra los datos del emisor, el ambiente y el certificado.
  • actualizar_empresaActualiza datos del emisor o el ambiente.
  • listar_secuenciasLista los rangos de e-NCF.
  • registrar_secuenciaRegistra un rango autorizado por la DGII.
  • listar_webhooksLista los webhooks.
  • crear_webhookCrea un webhook.
  • eliminar_webhookElimina un webhook.
  • listar_empresasLista las empresas de la cuenta (integradores).
  • crear_empresaCrea una empresa hija (integradores).
  • progreso_certificacionMuestra el progreso de los 16 pasos de certificación.

Locales (sin red)

  • calcular_totalesCalcula subtotales, ITBIS y total de una lista de ítems, sin llamar a la API.
  • explicar_tipo_ecfExplica cuándo se usa cada tipo de e-CF.