# heor-agent

AI-powered Health Economics and Outcomes Research (HEOR) MCP server. 14 tools for literature search (41 sources), cost-effectiveness modeling, budget impact, HTA dossiers.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add elvirchik/heor-agent

# Browse available tools
npx -y @smithery/cli@latest tool list elvirchik/heor-agent

# Get full schema for a tool
npx -y @smithery/cli@latest tool get elvirchik/heor-agent literature_search

# Call a tool
npx -y @smithery/cli@latest tool call elvirchik/heor-agent literature_search '{}'
```

## Direct MCP Connection

Endpoint: `https://heor-agent--elvirchik.run.tools`

## Tools (15)

- `literature_search` — Search PubMed, ClinicalTrials.gov, bioRxiv/medRxiv, ChEMBL, FDA Orange Book, FDA Purple Book, enterprise sources (Embas…
- `cost_effectiveness_model` — Build a cost-utility analysis (ICER, QALY, PSA, sensitivity analysis) for a drug vs comparator. Follows ISPOR good prac…
- `hta_dossier_prep` — Structure evidence into HTA body-specific submission format (NICE STA, EMA, FDA, IQWiG, HAS, EU JCA, or Global Value Do…
- `knowledge_search` — Search a project's knowledge base (raw/ and wiki/) for text matches. Returns file paths with line numbers and snippets.…
- `knowledge_read` — Read a file from a project's raw/ or wiki/ tree. Path is relative to project root. Only raw/ and wiki/ subtrees accessi…
- `knowledge_write` — Write a file to the project's wiki/ tree. Path MUST start with 'wiki/' and end with '.md'. Use this to compile/organize…
- `project_create` — Initialize a new HEOR project workspace with directory skeleton and project.yaml metadata. Idempotent — returns existin…
- `evidence_network` — Analyze literature search results to build an evidence network map. Extracts intervention-comparator pairs from titles …
- `indirect_comparison` — Compute indirect treatment comparisons using the Bucher method (single common comparator) or frequentist network meta-a…
- `budget_impact_model` — Estimate the total budget impact of adopting a new intervention over 1-5 years. Follows ISPOR Budget Impact Analysis go…
- `population_adjusted_comparison` — ⚠️ EXPERIMENTAL / orientation-only. Approximate population-adjusted indirect comparison using summary-level statistics …
- `survival_fitting` — ⚠️ EXPERIMENTAL. Fit parametric survival distributions (Exponential, Weibull, Log-logistic, Log-normal, Gompertz) to Ka…
- `screen_abstracts` — Screen literature search results using PICO criteria. Scores each abstract by relevance to the research question, class…
- `risk_of_bias` — Assess risk of bias for a set of studies using the appropriate Cochrane instrument: RoB 2 (RCTs), ROBINS-I (observation…
- `validate_links` — Validate URLs by making HEAD requests and checking HTTP status codes. Returns categorization: working (200), browser_on…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get elvirchik/heor-agent <tool-name>
```

## Prompts (5)

- `literature-review` (drug, indication) — Systematic literature review with PRISMA audit trail — runs literature_search across 41 sources then screens by PICO cr…
- `cost-effectiveness-analysis` (intervention, comparator, indication, perspective) — Full cost-effectiveness analysis: Markov/PartSA model with PSA, OWSA, CEAC, EVPI, EVPPI, and scenario analysis.
- `hta-dossier` (hta_body, drug, indication) — Generate a complete HTA submission dossier (NICE, EMA, FDA, IQWiG, HAS, EU JCA, or Global Value Dossier) with auto-GRAD…
- `budget-impact` (intervention, population, perspective) — 5-year budget impact analysis with Excel export for localization by market-access teams.
- `indirect-comparison` (intervention, comparator) — Indirect treatment comparison using Bucher method, Frequentist NMA, or MAIC/STC (population-adjusted).