heor-agent-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SERPAPI_KEY | No | API key for Google Scholar (enterprise data source) | |
| HEOR_API_KEY | No | API key for future hosted tier | |
| HEOR_KB_ROOT | No | Path to the knowledge base directory (default ~/.heor-agent) | |
| MCP_HTTP_PORT | No | Port for HTTP mode (default 8787) | |
| HEOR_PROXY_URL | No | URL of a localhost proxy for enterprise APIs behind corporate VPN | |
| CITELINE_API_KEY | No | API key for Citeline (enterprise data source) | |
| COCHRANE_API_KEY | No | API key for Cochrane Library (enterprise data source) | |
| ELSEVIER_API_KEY | No | API key for Embase and ScienceDirect (enterprise data sources) | |
| CORTELLIS_API_KEY | No | API key for Cortellis (enterprise data source) | |
| PHARMAPENDIUM_API_KEY | No | API key for Pharmapendium (enterprise data source) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| literature_searchA | Search PubMed, ClinicalTrials.gov, bioRxiv/medRxiv, ChEMBL, FDA Orange Book, FDA Purple Book, enterprise sources (Embase, ScienceDirect, Cochrane, Citeline, Pharmapendium, Cortellis), HTA cost reference sources (CMS NADAC, PSSRU, NHS National Cost Collection, BNF, PBS Schedule), LATAM sources (DATASUS, CONITEC, ANVISA, PAHO, IETS, FONASA), APAC sources (HITAP), and HTA appraisal/guidance sources (NICE TAs, CADTH CDR/pCODR, ICER, PBAC PSDs, G-BA AMNOG, HAS Transparency Committee, IQWiG, AIFA, TLV Sweden, INESSS Quebec) for evidence on a drug or indication. Returns structured results including HTA precedents and appraisal decisions with a full audit trail suitable for HTA submissions. |
| cost_effectiveness_modelA | Build a cost-utility analysis (ICER, QALY, PSA, sensitivity analysis) for a drug vs comparator. Follows ISPOR good practice guidelines and NICE reference case. Includes probabilistic sensitivity analysis (PSA), one-way sensitivity, and cost-effectiveness acceptability curve (CEAC). |
| hta_dossier_prepA | Structure evidence into HTA body-specific submission format (NICE STA, EMA, FDA, IQWiG, HAS, EU JCA). Produces draft sections with gap analysis. Accepts output from literature_search and cost_effectiveness_model. |
| knowledge_searchA | Search a project's knowledge base (raw/ and wiki/) for text matches. Returns file paths with line numbers and snippets. Use this to find previously-retrieved literature, model runs, and compiled wiki content without re-querying external APIs. |
| knowledge_readA | Read a file from a project's raw/ or wiki/ tree. Path is relative to project root. Only raw/ and wiki/ subtrees accessible. |
| knowledge_writeA | Write a file to the project's wiki/ tree. Path MUST start with 'wiki/' and end with '.md'. Use this to compile/organize evidence from raw/ files into a structured knowledge base. Supports Obsidian-style [[wikilinks]]. |
| project_createA | Initialize a new HEOR project workspace with directory skeleton and project.yaml metadata. Idempotent — returns existing project if already created. Required before using the |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose with no overlap: cost-effectiveness modeling, HTA dossier preparation, knowledge base reading/searching/writing, literature searching, and project creation. The descriptions clearly differentiate their functions, making misselection unlikely.
Most tools follow a consistent verb_noun pattern (e.g., literature_search, project_create). The only minor deviation is 'knowledge_read/write/search' which uses a noun_verb format, but this is internally consistent within the knowledge tools and still readable.
With 7 tools, this is well-scoped for a Health Economics and Outcomes Research (HEOR) agent. Each tool earns its place by covering distinct aspects of the workflow: project setup, evidence gathering, analysis, and documentation.
The toolset provides complete coverage for the HEOR domain: project initialization, comprehensive literature searching, cost-effectiveness modeling, HTA dossier preparation, and knowledge management. There are no obvious gaps; it supports the full lifecycle from evidence collection to submission-ready outputs.