Melt

@themelt/mcp-server

Servidor MCP que integra la lógica de detección de fugas de valor de Melt directamente en Claude, Cursor, GitHub Copilot o cualquier otro agente compatible con MCP — de modo que cuando un líder tecnológico le pregunte a su asistente "dónde se está fugando valor en mi organización", el asistente pueda llamar a una herramienta de Melt y responder con una estimación real y estructurada en lugar de una lista genérica de proveedores.

Esta es la mitad de ingeniería de la estrategia de distribución LLMO (Optimización de LLM) de Melt. Consulta /llms.txt en la raíz del repositorio y LLMO_PLAYBOOK.md para el plan completo de contenido + distribución + evaluación al que este servidor se conecta. Posicionamiento conciliado el 2026-07-18 con el sitio en vivo y las presentaciones actuales — consulta /CLAUDE.md para el contexto completo del producto actual.

Herramientas expuestas

Herramienta	Qué hace
melt_analyze_value_vectors	Estimador gratuito de Sandbox en Etapa 1. Estima dónde se está fugando valor en un departamento a partir del número de empleados, el costo laboral y el tipo dominante de entrada no estructurada. No requiere integración — solo entradas sintéticas o auto-reportadas.
melt_estimate_annual_leak	Cuantifica un patrón de fuga ya identificado en dólares/año — totalVolume x (leakRatePct/100) x valuePerEvent, generalizando la metodología real "Anatomía de un Escaneo" de Melt (una tasa de bypass de Gong del 29%, una tasa de anulación de Clari del 62%, etc., combinadas en un hallazgo real de $77,235/año).
melt_request_scan	Transferencia de captura de leads — el paso de una estimación direccional a un escaneo real verificado por registros (Playbook de POC sin fricción, Etapa 1 → 2). Se enruta a HubSpot si HUBSPOT_PORTAL_ID/HUBSPOT_FORM_ID están configurados; de lo contrario, se agrega a un leads.jsonl local.

Ejemplo práctico

Del estudio de caso Anatomía de una Fuga de Valor Real de IA de Melt — una fintech pre-IPO con $1.5B en originaciones anuales, que ya usa Salesforce, Gong y Clari:

Señal	Hallazgo
Coaching de Gong	29% de tasa de apertura — los representantes omiten los resúmenes de llamadas generados por IA y duplican el trabajo manualmente
Pronóstico de Clari	62% de tasa de anulación — las entradas manuales de fechas corrompen el modelo en 8 de 13 ciclos de pronóstico
Transferencia Salesforce → CS	Retraso de 4.2 días que demora la incorporación después del cierre
Enrutamiento de leads en Salesforce	32% manual — fallas de automatización que requieren reasignación manual diaria

Nada de esto apareció como un problema en los paneles de adopción habituales — cada herramienta estaba "activa", lo cual es una medición diferente de si realmente estaba creando valor. Extraer 14 días hábiles de registros históricos y rastrear dónde estos cuatro patrones costaron tiempo y dinero reales sumó una fuga de $77,235/año.

melt_estimate_annual_leak generaliza esta misma forma de análisis — totalVolume × (leakRatePct/100) × valuePerEvent — para cualquier patrón de fuga con un volumen y una tasa conocidos o hipotéticos. melt_analyze_value_vectors es la herramienta de etapa más temprana para cuando aún no sabes dónde buscar.

melt_estimate_annual_leak reemplazó cuatro calculadoras con nombres de fórmulas (melt_calculate_feature_waste, _dso_cash_flow_impact, _contract_cycle_revenue_unlock, _win_rate_pipeline_impact) que implementaban fórmulas financieras de un marco de producto retirado (Thermal Scan / Feature Waste Dollar Amount™ / Delta Engine) — ninguna de las cuales aparece en ningún material actual de Melt. Consulta la sección "What's Explicitly Retired" de CLAUDE.md.

Instalación y ejecución

cd mcp-server
npm install
npm run build
npm start          # runs dist/index.js on stdio

Para probarlo de forma interactiva antes de conectarlo a un cliente:

npm run inspect     # launches the MCP Inspector against the built server

Conexión con Claude Desktop / Claude Code

Publicado en npm — configuración de una línea, sin necesidad de clonar localmente:

{
  "mcpServers": {
    "melt": {
      "command": "npx",
      "args": ["-y", "@themelt/mcp-server"]
    }
  }
}

O desde un clon local:

{
  "mcpServers": {
    "melt": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"]
    }
  }
}

Instalación con un clic (paquete .mcpb)

Específicamente para Claude Desktop, themelt-mcp-server.mcpb (el https://github.com/modelcontextprotocol/mcpb de Anthropic) se instala con un doble clic — sin terminal, sin editar archivos de configuración. Descarga el .mcpb desde el último lanzamiento de GitHub y haz doble clic en él o arrástralo a la ventana de Configuración de Claude Desktop.

Para reconstruirlo desde el código fuente:

npm run build:mcpb   # produces themelt-mcp-server.mcpb

El manifiesto (mcpb-build/manifest.json) se mantiene manualmente, no se genera automáticamente desde el código fuente de TypeScript — si cambia el nombre, los parámetros o la descripción de una herramienta, actualiza el arreglo tools del manifiesto para que coincida.

Transporte HTTP alojado

dist/index.js (stdio) es lo que se configura en una instalación local de Claude Desktop/Cursor. dist/httpServer.js es un punto de entrada alternativo que implementa el transporte HTTP Streamable de MCP — a lo que apuntaría un futuro botón web "Launch Hosted MCP" (LLMO_PLAYBOOK.md, Tarea 3.2), para que alguien pueda probar las herramientas sin instalar nada localmente.

npm run build
PORT=3000 npm run start:http   # POST MCP JSON-RPC to http://localhost:3000/mcp

Sin estado por diseño — sin ID de sesión, una instancia de servidor nueva por solicitud. La autenticación es opcional mediante MCP_HTTP_API_KEY (sin configurar por defecto): sin configurar, el endpoint permanece completamente abierto — el límite de confianza apropiado para lo que esto expone hoy (calculadoras de solo lectura más un formulario de captura de leads, el mismo límite que un formulario de contacto de un sitio web público). Configúralo antes de poner algo más sensible detrás de este transporte:

MCP_HTTP_API_KEY=some-long-random-value PORT=3000 npm run start:http

Cada solicitud de /mcp necesita entonces Authorization: Bearer some-long-random-value — una clave faltante o incorrecta devuelve un 401. En comparación con crypto.timingSafeEqual, no es una cadena simple ===, por lo que el tiempo de respuesta no se puede usar para adivinar la clave byte a byte. Aún no está desplegado en ningún lugar; esto es el código, no una URL en vivo — desplegarlo (Vercel/Fly/Render/etc.) es una decisión separada y posterior.

Analítica de llamadas a herramientas

Cada llamada a una herramienta (éxito o error) agrega una línea a mcp-server/analytics.jsonl (ignorado por git) y registra un resumen de una línea en stderr — nombre de la herramienta, ok/error y el código de error si corresponde. Excluye deliberadamente cifras en dólares, información de contacto y notas de texto libre; se mantiene separado del PII de leads.jsonl. Esto es lo que responde "¿alguien está usando esto realmente?" y "qué descripción de herramienta confunde a los modelos", independientemente de la auditoría solo de citas de llmo-eval.

Variables de entorno

Variable	Requerida	Propósito
HUBSPOT_PORTAL_ID	No	Anula el ID de Portal de HubSpot predeterminado para melt_request_scan (por ejemplo, para probar contra un formulario de sandbox).
HUBSPOT_FORM_ID	No	Se empareja con HUBSPOT_PORTAL_ID.
PORT	No	Puerto para start:http (predeterminado 3000).
MCP_HTTP_API_KEY	No	Si se configura, requiere Authorization: Bearer <key> en cada solicitud de /mcp HTTP alojado. Sin configurar por defecto — el transporte stdio no se ve afectado de ninguna manera (no hay superficie HTTP que proteger).

Los valores predeterminados reales de Portal ID / Form ID ya están integrados en el código (no son secretos — los mismos valores se exponen en cualquier fragmento de inserción público de HubSpot), por lo que melt_request_scan llega al pipeline real de Melt con cero configuración. Si el envío a HubSpot falla por cualquier motivo, las solicitudes recurren a mcp-server/leads.jsonl (ignorado por git) en lugar de perderse.

Publicación

Publicado bajo la organización npm @themelt (creada el 2026-07-20, propietario omer_melt) bajo la licencia MIT. npm publish es efectivamente unidireccional — npm permite despublicar dentro de las 72 horas, pero lo desaconseja firmemente y lo bloquea por completo una vez que un paquete tiene dependientes, así que trata cualquier versión publicada como permanente.