BioMCP
Provides access to biomedical literature through PubMed, enabling search and retrieval of articles, and citation data via the article_search and article_get tools.
Integrates with Semantic Scholar for federated literature search and citation analysis, supporting article search and citation graph data.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BioMCPget info on BRCA1 gene"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BioMCP
A high-performance MCP server that gives LLMs access to 25 biomedical tools federated across 50+ upstream APIs — genes, variants, drugs, diseases, literature, clinical trials, and structural biology in a single integration.
Adapted from the BioMCP Rust with agent-first development approach and enhancements. Kudos to the original authors.
Highlights
25 tools across 8 domains — search, retrieve, and cross-reference biomedical entities
50+ upstream sources — MyGene, MyVariant, MyChem, MyDisease, ClinVar, gnomAD, UniProt, Reactome, OpenTargets, CIViC, OncoKB, DisGeNET, GTEx, STRING, DGIdb, ClinicalTrials.gov, PubMed, EuropePMC, Semantic Scholar, PubTator, LitSense, Monarch Initiative, OpenFDA, NIH Reporter, AlphaGenome, and more
Section-based fetching —
entityGet(id, sections)fans out to multiple sources with per-section timeouts and graceful degradation (failed sections return{ _error }instead of crashing)Federated article search — queries 5 literature backends simultaneously with PMID/PMCID/DOI deduplication
Zero-config startup — works out of the box; optional API keys unlock higher rate limits and premium data
350+ unit tests (mocked) + 90+ integration tests (live APIs via in-process MCP client, with automatic retry on 429 rate limits)
Related MCP server: BioBTree
Quick Start
Install and build
git clone <repo-url> && cd biomcp-ts
make install buildConfigure with Claude Desktop
Add to your Claude Desktop claude_desktop_config.json:
{
"mcpServers": {
"biomcp": {
"command": "npx",
"args": ["biomcp"]
}
}
}Or from a local checkout:
{
"mcpServers": {
"biomcp": {
"command": "node",
"args": ["/path/to/biomcp-ts/dist/bundle.js"]
}
}
}Direct stdio
npm startAny MCP-compatible client
BioMCP speaks standard MCP over stdio. Point any MCP client at the biomcp binary or node dist/bundle.js.
Available Tools
Gene (7)
Tool | Description |
| Search genes by symbol, name, or keyword with type/chromosome filters |
| Get detailed gene info by HGNC symbol with optional sections (core, pathways, protein, ontology, GO, interactions, expression, protein_atlas, constraint, druggability, dosage_sensitivity, clinical evidence, disease associations, diseases, funding). Set |
| Get diseases associated with a gene (DisGeNET / OpenTargets) |
| Find drugs targeting a gene (OpenTargets) |
| Find clinical trials for a gene |
| Find articles about a gene |
| Pathway enrichment analysis for a gene list (Reactome) |
Variant (4)
Tool | Description |
| Search variants by rsid, HGVS, gene, ClinVar significance, frequency, CADD |
| Get detailed variant info with optional sections (frequency, predictions, clinical, alphagenome_scores) |
| Get OncoKB cancer variant annotations (requires |
| Find clinical trials for a variant |
Drug (3)
Tool | Description |
| Search drugs by name, mechanism, or keyword |
| Get detailed drug info with optional sections (us_regulatory, eu_regulatory, who_regulatory, safety, targets, indications) |
| Find clinical trials for a drug |
Disease (4)
Tool | Description |
| Search diseases by name, phenotype, or keyword |
| Get detailed disease info by ID (DOID, MONDO, OMIM, etc.) with optional sections (gene_associations, phenotypes, pathways, survival) |
| Get drugs for a disease (OpenTargets) |
| Get clinical trials for a disease (ClinicalTrials.gov) |
Article (2)
Tool | Description |
| Federated literature search across PubMed, EuropePMC, Semantic Scholar, PubTator, and LitSense with optional date range filtering. Accepts |
| Get detailed article info by identifier (PMID, PMCID, or DOI) with optional sections: |
Trial (2)
Tool | Description |
| Search clinical trials by condition, intervention, status, or phase. Uses cursor-based pagination via |
| Get detailed trial info by NCT ID with optional sections (eligibility, locations, outcomes) |
Utility (2)
Tool | Description |
| Free-text concept resolution across all entity types |
| Retrieve multiple entities in parallel |
Structural Biology (1)
Tool | Description |
| Search PDB structures, get entry metadata with optional sections (polymer entities, ligands, assembly, experiment, citation), and download structure files (mmCIF/PDB) |
Citation Module
Modes:
Fast (default): Europe PMC, Semantic Scholar, Crossref (~4s)
Returns: Citations with title, authors, journal, year when available
Note: Crossref requires DOI; Europe PMC auto-resolves DOI/PMCID to PMID
Full (
citation_mode="full"): All 5 providers (~15-30s)Adds: PubMed (PMID only) and OpenCitations (DOI only)
Use for: Comprehensive citation analysis
Provider Data Coverage:
Provider | Forward | Backward | Count | Required ID |
Europe PMC | ✓ | ✓ | ✓ | PMID/DOI/PMCID |
Semantic Scholar | ✓ | ✓ | ✓ | PMID/DOI/PMCID |
Crossref | ✓ | ✓ | ✓ | DOI only |
PubMed | ✓ | ✓ | ✓ | PMID only |
OpenCitations | ✓ | ✓ | ✓ | DOI only |
Automatic Fallback: Fast mode automatically queries PubMed when other providers return counts but no items (requires PMID).
Development
make # Show available targets
make install # Install dependencies
make build # Compile and bundle into dist/bundle.js
make typecheck # Type-check without emitting
make test # Run unit tests (fast, mocked)
make test-integration # Run integration tests (live APIs, ~60s)
make test-all # Run all tests
make clean # Remove build artifactsLocal Testing with npx
After building, you can test the MCP server locally via npx:
make build # Creates dist/bundle.js
npx . # Runs the bundled MCP serverThis is the recommended workflow for local development and testing.
Environment Variables
All keys are optional. BioMCP works without any keys — they unlock higher rate limits and additional data sources.
Variable | Source | Benefit |
| Higher PubMed / NCBI rate limits | |
| Semantic Scholar API key (prevents 429 rate limits) | |
| OpenFDA API access | |
| NCI Clinical Trials API | |
| OncoKB cancer variant annotations | |
| Disease-gene associations | |
| UMLS terminology services | |
| AlphaGenome variant scores |
License
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/yeyuan98/biomcp-ts'
If you have feedback or need assistance with the MCP directory API, please join our Discord server