Saltar al contenido
firmo
Docs / MCP

MCP

Herramientas del servidor MCP de Firmo y cómo conectarlo a tu agente de IA: Claude Desktop, Claude Code, Cursor o la configuración remota.

Disponible

El servidor MCP de Firmo deja que un agente de IA (Claude, Cursor u otro cliente compatible con el Model Context Protocol) emita, consulte y administre e-CF con tu API key. Usa las mismas reglas y permisos que la API. Más contexto en firmo.do/mcp.

Conectarlo#

Local (stdio)

Se ejecuta con npx -y @firmo-ecf/mcp y lee la key de la variable FIRMO_API_KEY.

Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "firmo": {
      "command": "npx",
      "args": ["-y", "@firmo-ecf/mcp"],
      "env": { "FIRMO_API_KEY": "sk_test_…" }
    }
  }
}
Claude Code
claude mcp add firmo --env FIRMO_API_KEY=sk_test_… -- npx -y @firmo-ecf/mcp
Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "firmo": {
      "command": "npx",
      "args": ["-y", "@firmo-ecf/mcp"],
      "env": { "FIRMO_API_KEY": "sk_test_…" }
    }
  }
}

Remoto (HTTP)

Si tu cliente admite servidores remotos, usa https://api.firmo.do/mcp con tu API key como token Bearer.

Configuración remota
{
  "mcpServers": {
    "firmo": {
      "type": "http",
      "url": "https://api.firmo.do/mcp",
      "headers": { "Authorization": "Bearer sk_test_…" }
    }
  }
}

El servidor MCP (local y remoto) llama a la API con el header Firmo-Channel: mcp, así que los e-CF emitidos desde un asistente quedan con canal: "mcp". Es un dato declarado por el cliente. Ver el header Firmo-Channel.

Empieza con una key sk_test_. Un agente con una key sk_live_ puede emitir e-CF con validez fiscal.

Herramientas#

e-CF emitidos

HerramientaQué hace
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

HerramientaQué hace
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

HerramientaQué hace
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

HerramientaQué hace
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)

HerramientaQué hace
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.