MCP · Documentación

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/mcp y lee la key de la variable FIRMO_API_KEY.

Claude Desktop · claude_desktop_config.json

{
  "mcpServers": {
    "firmo": {
      "command": "npx",
      "args": ["-y", "@firmo/mcp"],
      "env": { "FIRMO_API_KEY": "sk_test_…" }
    }
  }
}

Claude Code

claude mcp add firmo --env FIRMO_API_KEY=sk_test_… -- npx -y @firmo/mcp

Cursor · .cursor/mcp.json

{
  "mcpServers": {
    "firmo": {
      "command": "npx",
      "args": ["-y", "@firmo/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_…" }
    }
  }
}

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

Herramientas#

e-CF emitidos

Herramienta	Qué hace
`emitir_ecf`	Emite un e-CF (POST /v1/ecf).
`obtener_ecf`	Obtiene un e-CF por id o e-NCF.
`listar_ecf`	Lista e-CF con filtros de estado, tipo y fechas.
`descargar_xml_ecf`	Descarga el XML firmado.
`reenviar_ecf`	Reintenta el envío de un e-CF en error.
`enviar_ecf_por_correo`	Envía la representación impresa por correo.
`anular_secuencias`	Anula rangos de e-NCF no usados (ANECF).

Recibidos

Herramienta	Qué hace
`listar_recibidos`	Lista los e-CF recibidos de suplidores.
`aprobar_recibido`	Aprueba comercialmente un e-CF recibido.
`rechazar_recibido`	Rechaza comercialmente un e-CF recibido, con motivo.
`consultar_estado_dgii`	Consulta en la DGII el estado de un e-CF, propio o de terceros.

Empresa y configuración

Herramienta	Qué hace
`ver_empresa`	Muestra los datos del emisor, el ambiente y el certificado.
`actualizar_empresa`	Actualiza datos del emisor o el ambiente.
`listar_secuencias`	Lista los rangos de e-NCF.
`registrar_secuencia`	Registra un rango autorizado por la DGII.
`listar_webhooks`	Lista los webhooks.
`crear_webhook`	Crea un webhook.
`eliminar_webhook`	Elimina un webhook.
`listar_empresas`	Lista las empresas de la cuenta (integradores).
`crear_empresa`	Crea una empresa hija (integradores).
`progreso_certificacion`	Muestra el progreso de los 15 pasos de certificación.

Locales (sin red)

Herramienta	Qué hace
`calcular_totales`	Calcula subtotales, ITBIS y total de una lista de ítems, sin llamar a la API.
`explicar_tipo_ecf`	Explica cuándo se usa cada tipo de e-CF.