BioMCP
Enables searching and retrieving biomedical literature from PubMed, including articles, reviews, and citations.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
BioMCP · Biomedical MCP Server
One command grammar. 50+ biomedical databases. Zero learning curve.
Genes, variants, drugs, trials, papers, pathways, phenotypes — all through a single MCP endpoint.
BioMCP is a production-grade Model Context Protocol server that unifies PubMed, ClinicalTrials.gov, ClinVar, gnomAD, OncoKB, Reactome, KEGG, UniProt, PharmGKB, CPIC, OpenFDA, CDC VAERS, Monarch Initiative, GWAS Catalog, DisGeNET, AlphaGenome, cBioPortal, and 40+ other biomedical sources behind one consistent read-only API.
Quickstart
# Option A: Pull from Docker Hub (recommended)
docker pull jackgucci/biomcp:latest
docker compose up -d
# Option B: Build from source
git clone https://github.com/gucci10248/JEFFREY.git && cd JEFFREY
cp .env.example .env
bash build.sh
docker compose up -d
# Test
curl http://localhost:8080/health # → {"status":"ok"}Your MCP server is live at http://localhost:8080/mcp.
Related MCP server: BioMCP
MCP Client Setup
Claude Desktop
{
"mcpServers": {
"biomcp": {
"type": "streamableHttp",
"url": "http://localhost:8080/mcp"
}
}
}Hermes Agent
# ~/.hermes/config.yaml
mcp:
servers:
biomcp:
type: streamableHttp
url: http://localhost:8080/mcp
enabled: trueAny SSE/Streamable HTTP Client
Endpoint: http://localhost:8080/mcpCommand Reference
Genes
Command | Example |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Variants
Command | Example |
|
|
|
|
|
|
|
|
Drugs
Command | Example |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Diseases
Command | Example |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Articles (PubMed, Europe PMC, LitSense2)
Command | Example |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Clinical Trials
Command | Example |
|
|
|
|
|
|
|
|
|
|
Pathways & Enrichment
Command | Example |
|
|
|
|
|
|
|
|
Phenotypes
Command | Example |
|
|
|
|
GWAS
Command | Example |
|
|
|
|
|
|
Cross-Entity Search
Command | Example |
|
|
|
|
|
|
Protein & Structure
Command | Example |
|
|
|
|
Pharmacogenomics
Command | Example |
|
|
|
|
Adverse Events
Command | Example |
|
|
|
|
Operations
Command | Example |
| Check API connectivity |
| Print server version |
|
|
Data Sources
Source | Coverage |
PubMed | 36M+ biomedical citations |
Europe PMC | Full-text, preprints, patents |
ClinicalTrials.gov | 500K+ registered trials |
ClinVar | 3M+ variant-disease annotations |
gnomAD | Population allele frequencies |
OncoKB | Cancer variant clinical actionability |
OpenFDA | FDA drug/device adverse events |
UniProt | Protein function & structure |
KEGG | Metabolic & signaling pathways |
Reactome | Curated pathway database |
PharmGKB | Pharmacogenomics knowledge |
CPIC | Clinical pharmacogenetics guidelines |
Monarch Initiative | Cross-species phenotype ontology |
GWAS Catalog | Genome-wide association studies |
cBioPortal | Cancer genomics datasets |
DDInter | Drug-drug interaction database |
CDC VAERS | Vaccine adverse events |
EMA | European Medicines Agency data |
WHO Prequalification | Essential medicines quality |
NCBI GTR | Genetic testing registry |
AlphaGenome | Genomic variant predictions |
DisGeNET | Gene-disease associations |
Features
Read-only by design — no mutations to external data sources, safe for production
Single command grammar — one pattern for all entity types, no learning curve
Resilient — multi-source fallback, degraded responses with transparent source status
Non-root container — runs as unprivileged
biomcpuserRead-only root filesystem —
docker composeenforcesread_only: trueMinimal attack surface — single static binary, zero runtime dependencies
Zero telemetry — no outbound calls except to public biomedical APIs
SHA256-verified binary —
build.shverifies checksum from GitHub ReleasesAuto-updating data caches — EMA, WHO, GTR feeds auto-refresh on stale detection
Health & Monitoring
curl http://localhost:8080/health # → {"status":"ok"} — API connectivity
curl http://localhost:8080/readyz # → 200 — ready to serve traffic
curl http://localhost:8080/ # → Welcome page (HTML)Requirements
Docker 24+ & Docker Compose v2
~200MB disk (image + data volumes)
Outbound internet access to public biomedical APIs
Optional:
NCBI_API_KEY,S2_API_KEY,UNPAYWALL_EMAILfor higher rate limits
Contributing
See SECURITY.md for vulnerability reporting and CODEOWNERS for maintainer contacts.
License
Apache License 2.0 — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Auditable MCP server for PubMed, Europe PMC, ClinicalTrials.gov, and bioRxiv/medRxiv queries
MCP gateway federating 22 biomedical MCP servers behind one endpoint: gnomAD, ClinVar, HPO, VEP.
Pharma Intel MCP — Compound tools that chain ClinicalTrials.gov,
Monarch Initiative MCP — biomedical knowledge graph.
Related MCP Servers
- AlicenseBqualityDmaintenanceThis MCP server provides 16 intelligent tools for searching, retrieving, and linking biomedical literature from PubMed and PMC. It enables LLM applications to perform complex queries, batch processing, and cross-database linking.168MIT
- AlicenseAqualityBmaintenanceA high-performance MCP server that gives LLMs access to 25 biomedical tools federated across 50+ upstream APIs for genes, variants, drugs, diseases, literature, clinical trials, and structural biology.43161 npm12Apache 2.0
- AlicenseAqualityAmaintenanceAn MCP server that gives AI assistants access to biological and biomedical RDF databases via SPARQL at the RDF Portal, as well as selected REST APIs (NCBI E-utilities, UniProt, ChEMBL, PDB, Reactome, Rhea, MeSH, and more).22921MIT
- AlicenseNot gradedqualityBmaintenanceFederates 13 gene-related MCP backends (gnomAD, GTEx, etc.) behind a single Streamable HTTP endpoint with collision-free namespacing and search-based tool discovery.7MIT