Saltar al contenido
firmo

Servidor MCP

Que 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.

Próximamente
Obtener API key de pruebaReferencia de herramientas

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/mcp y lee tu key de FIRMO_API_KEY. No hay que instalar nada más.
{
  "mcpServers": {
    "firmo": {
      "command": "npx",
      "args": ["-y", "@firmo/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

23 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 de un e-CF en error.
  • 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.

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 14 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.