Skip to main content
Glama
melt-ai

@themelt/mcp-server

@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 pregunte a su asistente «¿dónde se está fugando valor de 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 ver el plan completo de contenido + distribución + evaluación al que se conecta este servidor. 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 la etapa 1 en sandbox. 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 autoinformadas.

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 de Melt «Anatomy of a Scan» (una tasa de omisión 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 clientes potenciales: el paso de una estimación direccional a un escaneo real verificado por registros (Frictionless POC Playbook, etapa 1 → 2). Se enruta a HubSpot si HUBSPOT_PORTAL_ID/HUBSPOT_FORM_ID están configurados; de lo contrario, se añade a un leads.jsonl local.

Related MCP server: agentladle-mcp-reoi

Ejemplo práctico

Del estudio de caso de Melt Anatomy of a Real AI Value Leak — una fintech pre-IPO con $1.5B en originaciones anuales, que ya utiliza Salesforce, Gong y Clari:

Señal

Hallazgo

Gong coaching

Tasa de apertura del 29%: los representantes omiten los resúmenes de llamadas generados por IA y duplican el trabajo manualmente

Clari forecasting

Tasa de anulación del 62%: las entradas manuales de fechas corrompen el modelo en 8 de 13 ciclos de pronóstico

Salesforce → CS handoff

Retraso de 4.2 días que demora la incorporación después del cierre

Salesforce lead routing

32% manual: fallos de automatización que requieren reasignación manual diaria

Nada de esto aparecía como un problema en los paneles de adopción habituales: cada herramienta estaba «activa», lo cual es una métrica diferente de si realmente estaba creando valor. Extraer 14 días hábiles de registros históricos y rastrear dónde estos cuatro patrones costaban 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 inicial para cuando aún no sabes dónde buscar.

melt_estimate_annual_leak reemplazó a 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 formato MCP Bundle de Anthropic) se instala con un doble clic: sin terminal, sin editar archivos de configuración. Descarga el .mcpb desde la última versión 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 la matriz 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 (no configurada por defecto): si no está configurada, el endpoint permanece completamente abierto, el límite de confianza adecuado para lo que esto expone hoy (calculadoras de solo lectura más un formulario de captura de clientes potenciales, el mismo límite que un formulario de contacto de un sitio web público). Configúrala 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 /mcp necesita entonces Authorization: Bearer some-long-random-value; una clave faltante o incorrecta devuelve un 401. Se compara con crypto.timingSafeEqual, no con una simple cadena ===, para que el tiempo de respuesta no pueda usarse para adivinar la clave byte a byte. Aún no está desplegado en ningún sitio; esto es el código, no una URL en vivo; desplegarlo (Vercel/Fly/Render/etc.) es una decisión separada y posterior.

Analíticas de llamadas a herramientas

Cada llamada a una herramienta (éxito o error) añade 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 de la PII de leads.jsonl. Esto es lo que responde a «¿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

Obligatoria

Propósito

HUBSPOT_PORTAL_ID

No

Sobrescribe el ID de portal de HubSpot predeterminado para melt_request_scan (por ejemplo, para probar con 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 /mcp de HTTP alojado. No configurada por defecto; el transporte stdio no se ve afectado en ningún caso (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 se redirigen a mcp-server/leads.jsonl (ignorado por git) en lugar de perderse.

Publicación

Publicado bajo la organización @themelt de npm (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.

Available Tools

3 tools
melt_analyze_value_vectorsAnalyze AI Value VectorsA

Estimates where AI/software value is most likely leaking out of a single department, based on headcount, labor cost, and the type of chaotic/unstructured input it processes manually today. Use this when a tech leader asks where value is being lost or where AI would create the most immediate impact in their org, before any real data integration exists — this is Melt's free Stage-1 Sandbox estimate. Output is directional, from synthetic/self-reported inputs, not an audited figure — for a real finding tied to an actual system log, follow up with melt_request_scan. Also answers what earlier Melt materials called 'AI ROI leverage' or 'AI value vectors' — same estimate, older name.

NameRequiredDescriptionDefault
headcountYesTotal operational personnel in the target unit (not the whole company). Must be positive.
departmentTypeYesThe organizational unit being evaluated. Must be one of: Operations, Finance, Engineering, Legal, GBS, Customer Success. Map loosely-named teams to the closest primitive (e.g. RevOps -> Operations, AR/Billing -> Finance, IT -> Engineering, Compliance -> Legal, Shared Services -> GBS, Support/CS/Client Success -> Customer Success).
averageHourlyLaborCostNoBlended fully-loaded hourly labor cost for manual processors in this unit, in USD. Default of 45 is a reasonable US mid-market planning assumption if the caller doesn't know the real figure.
primaryUnstructuredDataInputYesThe dominant chaotic input the unit processes by hand today. Must be one of: PDF_INVOICES, CUSTOMER_TICKETS, LOGISTICS_DOCUMENTS, MANUAL_EXCEL. Choose the closest match: PDF_INVOICES for document-first bottlenecks, CUSTOMER_TICKETS for conversational/support-first bottlenecks, LOGISTICS_DOCUMENTS for shipping/customs/supply-chain paperwork, MANUAL_EXCEL for spreadsheet-driven reconciliation or reporting work.

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and does well: it discloses that the estimate is directional, derived from synthetic/self-reported inputs, not audited, and belongs to a free Stage-1 Sandbox tier. It does not mention auth/permission needs or rate limits, keeping it short of a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and usage are front-loaded in the first sentence, and each later sentence adds real value (limitations, fallback tool, alias). It is slightly dense and long, so it is efficient rather than exemplary.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema and no annotations, the description must stand alone, and it does explain the nature of the return (directional estimate, not an audited figure). Minor gaps remain around the response shape and any required permissions, but an agent has enough to call it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already fully documents headcount, departmentType, labor cost, and input type. The description only names those inputs generically and adds no syntax, enum, or edge-case detail beyond the schema, so baseline 3 is correct.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (estimates where AI/software value is leaking out of a single department) and names the inputs it depends on. It explicitly distinguishes itself from the melt_request_scan sibling and disambiguates a legacy alias ('AI ROI leverage'/'AI value vectors'), so an agent can route without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use ('tech leader asks where value is being lost... before any real data integration exists') and names the alternative with its selecting condition ('for a real finding tied to an actual system log, follow up with melt_request_scan'). Nothing is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

melt_estimate_annual_leakEstimate Annual Value LeakA

Quantifies a specific, already-identified value-leak pattern in dollars per year — e.g. reps bypassing a coaching tool's summaries, manual overrides corrupting a forecasting model, a manual handoff between two systems. Use this when a leak pattern and its rough volume/rate are already known or hypothesized. This mirrors Melt's real scan methodology (see the fintech case study: a 29% Gong bypass rate, a 62% Clari override rate, and a 4.2-day manual handoff combined into a $77,235/yr finding) — it is a directional estimate from self-reported numbers, not a scan against real system logs. For an audited figure, follow up with melt_request_scan. Covers what earlier Melt materials called 'Feature Waste Dollar Amount' (money leaking on licensed-but-unused software) and general 'AI ROI leverage' calculations — those are older names for this same value-leak math, not a different tool.

NameRequiredDescriptionDefault
leakRatePctYesPercentage of that volume exhibiting the leak behavior, between 0 and 100 (e.g. 29 for a 29% bypass rate, 62 for a 62% override rate).
totalVolumeYesTotal annual volume of the relevant event or transaction — e.g. total call briefs generated, total deals closed, total support tickets, total lead assignments.
valuePerEventYesDollar value at risk per leaking event, in USD — e.g. average deal value, loaded hourly cost of manual rework, cost of a delayed handoff day.
leakDescriptionYesPlain-language description of the leak pattern observed or hypothesized — e.g. 'reps bypassing Gong call summaries and logging notes from memory', 'manual Slack handoff between Sales and Customer Success', 'guessed close dates overriding the forecasting model'.

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description fully reveals behavior: it is a directional estimate based on self-reported numbers, not a scan against real logs. It references Melt's real scan methodology and a case study, setting clear expectations about accuracy and methodology.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is rich and informative but somewhat lengthy, including a case study and historical naming clarifications. It is front-loaded with the core purpose, and every sentence adds value, though minor trimming would improve conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given there is no output schema, the description adequately implies the output (dollar estimate per year) via the case study result ($77,235/yr). All parameters are explained, and usage context is fully addressed. The tool is simple and the description covers everything needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

All four parameters are described in the schema with 100% coverage. The description adds significant value by providing concrete examples (e.g., '29 for a 29% bypass rate' for leakRatePct) and context for leakDescription, making parameter meaning clearer than the schema alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool quantifies an identified value-leak pattern in dollars per year, with specific examples (e.g., reps bypassing coaching tools). It distinguishes itself from siblings by naming the follow-up tool melt_request_scan for audited figures and clarifies it is not a system scan but a directional estimate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states when to use: when a leak pattern and rough volume/rate are known or hypothesized. It informs that the estimate is directional from self-reported numbers, and advises following up with melt_request_scan for audited figures. Also clarifies that older terms like 'Feature Waste Dollar Amount' refer to the same functionality.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

melt_request_scanRequest a Melt ScanA

Submits a request for a Melt scan — the next step after Melt's free Stage-1 Sandbox estimate, moving to a real, log-verified value-leak finding tied to a dollar figure and a source system. Call this only after the user has explicitly asked to be connected with Melt or to book/request a scan — never submit contact details the user hasn't provided themselves. Earlier Melt materials called this a 'Thermal Scan' — same request, current name is just 'a scan' (no fixed 2-week/pricing claim attached anymore).

NameRequiredDescriptionDefault
notesNoAny free-text context from the conversation that would help a Melt rep prep the call — trigger event, tech stack, urgency.
companyNoThe prospect's company name. Needed to route the request — if omitted, the tool asks for it instead of failing schema validation.
contactNameNoName of the requester, if known.
contactEmailNoBusiness email of the requester, for scan scheduling follow-up. Needed to route the request — if omitted, the tool asks for it instead of failing schema validation.
departmentsOfInterestNoDepartments the requester wants scanned first, if they expressed a preference.

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden, and it does meaningfully: it discloses that this sends user contact data to Melt for rep follow-up and that consent must be user-initiated, plus clarifies naming history ('Thermal Scan') and that no fixed 2-week/pricing claim attaches. It still omits what happens after submission (confirmation, SLA, idempotency), so it falls short of a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads purpose, then constraints, then legacy naming context — a sensible ordering with no filler. The parenthetical about the old 'Thermal Scan' name is useful disambiguation but slightly tangential, keeping it just short of a 5.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-required-parameter submission tool with no annotations and no output schema, the description covers purpose, consent preconditions and downstream meaning well. Return/confirmation behavior is left unspecified, but the core invocation guidance is complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so every parameter is already documented in the schema (notes, company, contactName, contactEmail, departmentsOfInterest), setting the baseline at 3. The description adds only the consent rule about contact details, not syntax or format beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource ('Submits a request for a Melt scan') and immediately positions it relative to siblings by naming the Stage-1 Sandbox estimate as the prior step. An agent can distinguish this from melt_estimate_annual_leak and melt_analyze_value_vectors without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit precondition ('only after the user has explicitly asked to be connected with Melt or to book/request a scan') and an explicit prohibition ('never submit contact details the user hasn't provided themselves'). This is unusually strong when-to-use/when-not-to-use guidance, including who must initiate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv0.1.5
    • Changedmelt_analyze_value_vectors1 field changed
      • changedInput schema / properties / departmentType / description
        Previous value: -"The organizational unit being evaluated. Must be one of: Operations, Finance, Engineering, Legal, GBS. Map loosely-named teams to the closest primitive (e.g. RevOps -> Operations, AR/Billing -> Finance, IT -> Engineering, Compliance -> Legal, Shared Services -> GBS)."New value: +"The organizational unit being evaluated. Must be one of: Operations, Finance, Engineering, Legal, GBS, Customer Success. Map loosely-named teams to the closest primitive (e.g. RevOps -> Operations, AR/Billing -> Finance, IT -> Engineering, Compliance -> Legal, Shared Services -> GBS, Support/CS/Client Success -> Customer Success)."
    • Changedmelt_request_scan3 fields changed
      • changedInput schema / properties / company / description
        Previous value: -"The prospect's company name. Required."New value: +"The prospect's company name. Needed to route the request — if omitted, the tool asks for it instead of failing schema validation."
      • changedInput schema / properties / contactEmail / description
        Previous value: -"Business email of the requester, for scan scheduling follow-up. Required."New value: +"Business email of the requester, for scan scheduling follow-up. Needed to route the request — if omitted, the tool asks for it instead of failing schema validation."
      • changedInput schema / properties / departmentsOfInterest / items / enum
        Previous value: -[
        -  "Operations",
        -  "Finance",
        -  "Engineering",
        -  "Legal",
        -  "GBS",
        -  "Sales",
        -  "HR",
        -  "Marketing",
        -  "Product"
        -]New value: +[
        +  "Operations",
        +  "Finance",
        +  "Engineering",
        +  "Legal",
        +  "GBS",
        +  "Sales",
        +  "HR",
        +  "Marketing",
        +  "Product",
        +  "Customer Success"
        +]
  2. 3 tool updatesv0.1.2
    • First observedmelt_analyze_value_vectors
    • First observedmelt_estimate_annual_leak
    • First observedmelt_request_scan

TDQS

A4.3/5.0

Scored across 3 tools

Disambiguation3/5

melt_request_scan is clearly distinct as a contact/submission action, but melt_analyze_value_vectors and melt_estimate_annual_leak both return directional dollar estimates of value leaks, so an agent could easily pick the wrong one. The descriptions do draw a line (department-level Stage-1 sandbox vs. quantifying an already-identified leak pattern), but the boundary is subtle and relies on prior context to be sure which applies.

Naming Consistency5/5

All three tools follow a clean melt_<verb>_<noun> snake_case pattern with consistent verb usage (analyze, request, estimate). No style mixing, camelCase, or vague verbs.

Tool Count4/5

Three tools is on the thin side, but the domain is deliberately narrow — a free directional estimate, a specific-leak estimate, and a scan request form a coherent funnel. It is borderline-lean rather than bloated, so slightly under-provisioned but defensible.

Completeness4/5

The surface covers the apparent intent: preliminary estimate, targeted leak math, and escalation to a paid scan. No obvious dead ends, though there is no way to check scan-request status or retrieve results, a minor gap an agent can work around.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    Provides 48 revenue intelligence tools that let AI assistants search deals, forecast revenue, analyze pipeline risk, manage outreach, and track value delivery via natural language.
    12 npm
    -
  • A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to perform multi-stage residual income projections, discounting, and enterprise value bridging analysis using standardized financial data inputs.
    1
    30 PyPI
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to fetch live, dated prices for LLM models and cloud compute instances across providers, compare and recommend models, and estimate monthly costs based on workload-specific token shapes and constraints.
    MIT