Servidor MCP HEORAgent

Agente de Economía de la Salud e Investigación de Resultados (HEOR) impulsado por IA como servidor del Protocolo de Contexto de Modelos (MCP).

Automatiza la revisión bibliográfica en 41 fuentes de datos, modelado de costo-efectividad de vanguardia, preparación de expedientes de HTA para NICE / EMA / FDA / IQWiG / HAS / JCA de la UE, y una base de conocimientos de proyectos persistente; todo invocable como herramientas MCP desde Claude.ai, Claude Code y cualquier host compatible con MCP.

Creado para equipos farmacéuticos, biotecnológicos, CRO y de asuntos médicos que necesitan flujos de trabajo de HEOR rigurosos y auditables sin construir la infraestructura desde cero.

Inicio rápido

Claude Code

claude mcp add heor-agent -- npx heor-agent-mcp

Luego reinicia Claude Code.

Claude Desktop / claude.ai

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "heor-agent": {
      "command": "npx",
      "args": ["heor-agent-mcp"]
    }
  }
}

Verificar

> Run a literature search for semaglutide cost-effectiveness in T2D using PubMed and NICE TAs

Herramientas

literature_search

Busca en 41 fuentes en paralelo. Cada llamada devuelve una tabla de selección de fuentes que muestra cuáles de las 41 fuentes se utilizaron y por qué, esencial para las pistas de auditoría de HTA.

Ejemplo de llamada:

{
  "query": "semaglutide cardiovascular outcomes type 2 diabetes",
  "sources": ["pubmed", "clinicaltrials", "nice_ta", "cadth_reviews", "icer_reports"],
  "max_results": 20,
  "output_format": "text"
}

cost_effectiveness_model

Modelo de Markov multiestado (predeterminado) o Análisis de Supervivencia Particionado (oncología), siguiendo las buenas prácticas de ISPOR y el caso de referencia de NICE (tasa de descuento del 3.5%, corrección de medio ciclo). Incluye:

• PSA — 1,000–10,000 iteraciones de Monte Carlo, probabilidad de costo-efectividad en umbrales de DAP (Disposición a Pagar)

• OWSA — análisis de sensibilidad unidireccional con resumen de tornado

• CEAC — curva de aceptabilidad de costo-efectividad

• EVPI — valor esperado de información perfecta

• Evaluación de DAP — veredicto frente al NHS (£25–35K/QALY, actualizado en abril de 2026), pagador de EE. UU. ($100–150K), umbrales sociales

Ejemplo de llamada:

{
  "intervention": "Semaglutide 1mg SC weekly",
  "comparator": "Sitagliptin 100mg daily",
  "indication": "Type 2 Diabetes Mellitus",
  "time_horizon": "lifetime",
  "perspective": "nhs",
  "model_type": "markov",
  "clinical_inputs": { "efficacy_delta": 0.5, "mortality_reduction": 0.15 },
  "cost_inputs": { "drug_cost_annual": 3200, "comparator_cost_annual": 480 },
  "utility_inputs": { "qaly_on_treatment": 0.82, "qaly_comparator": 0.76 },
  "run_psa": true,
  "output_format": "docx"
}

hta_dossier_prep

Redacta secciones listas para presentar para seis marcos de HTA con análisis de brechas:

Acepta la salida canalizada de literature_search y cost_effectiveness_model.

Herramientas de base de conocimientos

Los proyectos residen en ~/.heor-agent/projects/{project-id}/ con:

• raw/literature/ — resultados de búsqueda bibliográfica poblados automáticamente

• raw/models/ — ejecuciones de modelos pobladas automáticamente

• raw/dossiers/ — borradores de expedientes poblados automáticamente

• reports/ — archivos DOCX generados

• wiki/ — markdown curado manualmente, compatible con Obsidian con [[wikilinks]]

Pasa project: "project-id" a cualquier herramienta y los resultados se guardarán automáticamente.

Fuentes de datos

41 fuentes en 9 categorías. Cada llamada a literature_search incluye una tabla de selección de fuentes que muestra el estado de utilizado/no utilizado y la razón de cada una.

• PubMed — 35M+ citas biomédicas (NCBI E-utilities)

• ClinicalTrials.gov — Registro de ensayos NIH/NLM (API CT.gov v2)

• bioRxiv / medRxiv — Preprints de ciencias de la vida y medicina

• ChEMBL — Bioactividad de fármacos, mecanismos, ADMET (EMBL-EBI)

• WHO GHO — Observatorio Mundial de la Salud de la OMS

• World Bank — Demografía, macroeconomía, gasto en salud

• OECD Health — Estadísticas de salud de la OCDE (gasto, fuerza laboral, resultados)

• IHME GBD — Carga Mundial de Enfermedades (AVAD, prevalencia en 204 países)

• All of Us — Cohorte de medicina de precisión de los NIH

• FDA Orange Book — Aprobaciones de fármacos y equivalencia terapéutica

• FDA Purple Book — Biológicos autorizados y biosimilares

• NICE TAs (Reino Unido) · CADTH (Canadá) · ICER (EE. UU.) · PBAC (Australia)

• G-BA AMNOG (Alemania) · IQWiG (Alemania) · HAS (Francia)

• AIFA (Italia) · TLV (Suecia) · INESSS (Quebec, Canadá)

• CMS NADAC (Costos de adquisición de fármacos en EE. UU.)

• PSSRU (Costos unitarios del Reino Unido) · NHS National Cost Collection · BNF (Precios de fármacos en el Reino Unido)

• PBS Schedule (Australia)

• DATASUS · CONITEC · ANVISA (Brasil)

• OPS (Regional Panamericana) · IETS (Colombia) · FONASA (Chile)

• HITAP (Tailandia)

• ISPOR — Metodología HEOR y resúmenes de conferencias

Formatos de salida

Todas las herramientas admiten output_format:

• text (predeterminado) — Markdown con tablas y encabezados formateados

• json — Objetos estructurados para herramientas posteriores

• docx — Documento de Microsoft Word, guardado en disco, ruta devuelta en la respuesta

Los archivos DOCX se guardan en ~/.heor-agent/projects/{project}/reports/ (cuando se establece un proyecto) o ~/.heor-agent/reports/ (global). La respuesta de la herramienta contiene la ruta absoluta, lista para adjuntar a presentaciones o compartir con las partes interesadas.

Pista de auditoría

Cada llamada a la herramienta devuelve un registro de auditoría completo:

• Tabla de selección de fuentes — las 41 fuentes con estado de utilizado/no utilizado y razón

• Fuentes consultadas — consultas enviadas, recuentos de respuestas, estado, latencia

• Inclusiones / exclusiones — recuentos con razones

• Metodología — estilo PRISMA para literatura, ISPOR/NICE para economía

• Suposiciones — cada suposición registrada con justificación

• Advertencias — indicadores de calidad de datos, claves API faltantes, fuentes fallidas

Adecuado para su inclusión en los apéndices de presentación de HTA.

Configuración

# Optional — enterprise data sources
ELSEVIER_API_KEY=...        # Embase + ScienceDirect
COCHRANE_API_KEY=...        # Cochrane Library
CITELINE_API_KEY=...        # Citeline
PHARMAPENDIUM_API_KEY=...   # Pharmapendium
CORTELLIS_API_KEY=...       # Cortellis
SERPAPI_KEY=...             # Google Scholar

# Optional — knowledge base location
HEOR_KB_ROOT=~/.heor-agent  # Default

# Optional — localhost proxy for enterprise APIs behind corporate VPN
HEOR_PROXY_URL=http://localhost:8787

# Optional — hosted tier (future)
HEOR_API_KEY=...

Interfaz Web

Una interfaz de chat complementaria está disponible en:

https://web-michael-ns-projects.vercel.app

• Chatea con Claude Opus 4.6 + las 7 herramientas HEOR

• BYOK (Trae tu propia clave) — pega tu clave API de Anthropic en la configuración; permanece en el localStorage de tu navegador y nunca se almacena en nuestros servidores

• Renderizado de Markdown con tablas estilizadas, tarjetas de llamada de herramientas con temporizadores de progreso en vivo

• Ejemplos de prompts para flujos de trabajo HEOR comunes

La interfaz web llama al servidor MCP alojado en Railway para la ejecución de herramientas. No requiere configuración: solo añade tu clave API y comienza a consultar.

Autoalojamiento de la interfaz web

cd web
npm install
echo "ANTHROPIC_API_KEY=sk-ant-..." > .env.local  # optional server-side fallback
npm run dev -- -p 3456

Establece MCP_SERVER_URL para apuntar a tu propia instancia de servidor MCP (predeterminado: el despliegue público de Railway).

Transporte HTTP

El servidor admite tanto stdio (predeterminado, para clientes MCP locales) como HTTP transmitible (para despliegue alojado).

# Stdio mode (default — for Claude Code, Claude Desktop)
npx heor-agent-mcp

# HTTP mode — for hosted deployment, Smithery, web UI backend
npx heor-agent-mcp --http                    # port 8787
MCP_HTTP_PORT=3000 npx heor-agent-mcp        # custom port

Endpoints HTTP:

• POST/GET/DELETE /mcp — Protocolo HTTP transmitible de MCP

• GET /health — verificación de estado

• GET /.well-known/mcp/server-card.json — descubrimiento de Smithery

Desarrollo

git clone https://github.com/neptun2000/heor-agent-mcp
cd heor-agent-mcp
npm install
npm test          # 244 tests across 66 suites
npm run build     # Compile TypeScript to dist/
npm run dev       # Run with tsx (no build step)

Requiere: Node.js ≥ 20.

Arquitectura

┌────────────────────────────────────────────┐
│  MCP Host (Claude.ai / Claude Code / etc.) │
└────────────────┬───────────────────────────┘
                 │ stdio
┌────────────────▼──────────────────────────┐
│  heor-agent-mcp server                    │
│  ┌──────────────────────────────────────┐ │
│  │ 7 MCP tools (Zod-validated)          │ │
│  ├──────────────────────────────────────┤ │
│  │ DirectProvider (default)             │ │
│  │   ├─ 41 source fetchers              │ │
│  │   ├─ Audit builder + PRISMA trail    │ │
│  │   ├─ Markov / PartSA economic models │ │
│  │   ├─ Markdown + DOCX formatters      │ │
│  │   └─ Knowledge base (YAML + MD)      │ │
│  └──────────────────────────────────────┘ │
└───────────────────────────────────────────┘
                 │
    ┌────────────┴─────────────┐
    ▼                          ▼
┌────────────┐         ┌──────────────────┐
│ ~/.heor-   │         │ External APIs    │
│ agent/     │         │ (PubMed, NICE,   │
│ projects/  │         │  ICER, CADTH, …) │
└────────────┘         └──────────────────┘

Licencia

MIT — ver LICENSE.

Descargo de responsabilidad

Todos los resultados son preliminares y solo para orientación de investigación. Los resultados requieren la validación de un economista de la salud calificado antes de su uso en cualquier presentación de HTA, negociación con pagadores, presentación regulatoria o decisión clínica. Esta herramienta no reemplaza la experiencia profesional en HEOR.

Distribución

Enlaces

• npm: https://www.npmjs.com/package/heor-agent-mcp

• GitHub: https://github.com/neptun2000/heor-agent-mcp

• Smithery: https://smithery.ai/servers/neptun2000-70zu/heor-agent-mcp

• Interfaz Web: https://web-michael-ns-projects.vercel.app

• Problemas: https://github.com/neptun2000/heor-agent-mcp/issues