Heor Agent

AI-powered Health Economics and Outcomes Research (HEOR) agent as a Model Context Protocol server.

> Try it now → HEORAgent on ChatGPT (ChatGPT Plus / Team)
> · Web UI (Claude, BYOK)
> · npx heor-agent-mcp for Claude Desktop / Claude Code

Automates literature review across 44 data sources, risk of bias assessment (RoB 2 / ROBINS-I / AMSTAR-2), EQ-5D value set impact estimation, state-of-the-art cost-effectiveness modelling, HTA dossier preparation for NICE / EMA / FDA / IQWiG / HAS / EU JCA, and a persistent project knowledge base — all callable as MCP tools from Claude.ai, Claude Code, and any MCP-compatible host.

Built for pharmaceutical, biotech, CRO, and medical affairs teams who need rigorous, auditable HEOR workflows without building infrastructure from scratch.

---

First 60 seconds

Verify your install works before wiring it into Claude / Cursor / Continue. Open two terminal tabs:

Tab 1 — start the server in HTTP mode:

MCP_HTTP_PORT=8080 npx heor-agent-mcp@latest

You should see:

HEORAgent MCP server running on HTTP port 8080

Tab 2 — confirm it responds:

curl -s http://localhost:8080/health

Expected output:

{"status":"ok","server":"heor-agent-mcp","version":"1.10.2"}

✅ If you see the JSON above, the npm package works on your machine. Any further issues are in your MCP client config (Claude Desktop / Cursor / Continue), not the server.

❌ If you see command not found, run node --version — you need Node ≥20. If you see a different error, file a quick issue at https://github.com/neptun2000/heor-agent-mcp/issues with the output.

Now stop Tab 1 (Ctrl+C) and pick your client below — you don't need the HTTP mode for the actual integration; Claude / Cursor / Continue all use stdio.

---

Quick Start (per client)

Pick your MCP host:

Claude Code

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

Then restart Claude Code.

Claude Desktop / claude.ai Desktop

Edit your MCP config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS) and add:

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

Then restart Claude Desktop.

Cursor / Continue / Cline

Same config shape as Claude Desktop above; the file path differs by client:
- Cursor: Settings → MCP → Add new MCP server
- Continue: ~/.continue/config.json under the mcpServers key
- Cline: Settings → MCP Servers → Edit MCP Settings

Hosted (no install)

- ChatGPT (Plus / Team): HEORAgent on ChatGPT — type /heor to use it; works on any conversation.
- Web UI (Claude, BYOK): web-michael-ns-projects.vercel.app — bring your Anthropic API key; runs the full v1.6.3 toolset.

---

Your first prompt

Once your MCP host is configured, paste any of these to verify end-to-end:

Run a literature search for semaglutide cost-effectiveness in T2D
using PubMed, NICE TAs, and ICER reports. Set runs=2.

Run irb_review for an industry-funded interventional Phase 2 trial in
relapsed MM — multi-site US+EU, pseudonymized data, greater-than-minimal
risk. I need the review tier, GDPR/HIPAA DMP, SAE framework, and the
ready-to-paste cover letter.

Run jca_pico_scope for osimertinib in EGFR-mutant 2L NSCLC across
DE/FR/IT/ES/NL. Then prepare an EU JCA dossier draft using the picos.

The first prompt exercises literature_search + validate_links (free, no API keys needed). The second exercises irb_review (pure decision tree, instant). The third exercises jca_pico_scope → hta_dossier pipeline.

---

What's new

See CHANGELOG.md for full version history. Current: v1.23.0 (45 tools, 44 data sources).

v1.17.0–v1.23.0 — Living Evidence Intelligence (review → reimbursement)

A connected RWE + cross-deliverable layer (see docs/FEATURES.md for the full table):

- RWE & real-world safety: rwe.method_select (study-design selection), pv.comparative_safety (class-level FAERS-style AE ranking), evidence.triangulation (per-outcome RCT↔RWE concordance).
- Governed social listening: rwe.social_listening_protocol + pv.social_listening_triage (GVP Module VI ICSR triage — no scraping).
- One source of truth: evidence.claim_registry (author/auto-import a figure once), evidence.consistency_check (detect drift across dossier/publication/payer), publication.draft (reuse claims; CONSORT/STROBE/PRISMA/CHEERS + GPP2022/ICMJE).
- Living orchestration: evidence.gap_analysis (iEGP), workflow.living_evidence (SLR → living KB → JCA/HTA runbook), hta.living_gvd (regenerate only the GVD sections whose figures changed).

v1.13.0 — AI Transparency Disclosure (ISPOR ELEVATE-GenAI aligned)

16 tools now accept an ai_disclosure_level parameter:

| Value | Behaviour |
|-------|-----------|
| "off" | No disclosure block appended |
| "standard" | Model ID · tools called · data sources · date · human-review reminder |
| "submission" | Standard block + ISPOR ELEVATE-GenAI full citation |

Default by tool tier: HTA/regulatory tools (hta_dossier, hta_workflow, jca_pico_scope, pv_classify, etc.) default to "submission"; analysis tools (risk_of_bias, cost_effectiveness_model, etc.) default to "standard". Pass ai_disclosure_level: "off" to suppress.

Environment-level default: set HEORAGENT_DISCLOSURE_LEVEL=off|standard|submission to override the built-in per-tool defaults globally.

Web UI persona defaults: payer and HTA-reviewer personas always use "submission"; analyst personas default to "standard" and switch to "off" for scratch / exploratory prompts.

v1.0.4 highlights (still in v1.6.3)

Pharmacovigilance + workflow orchestration:

…