pgx-mcp
Click on "Deploy 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., "@pgx-mcpWhat are the CPIC guidelines for clopidogrel and CYP2C19?"
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.
pgx-mcp
An open-source MCP server that gives Claude real-time access to pharmacogenomics databases — turning genetic variant lookups and drug interaction checks from a 45-minute manual workflow into a single conversation.
Features
ClinVar: Variant clinical significance and pathogenicity
PharmGKB: Drug-gene interactions, clinical annotations, CPIC/DPWG dosing guidelines
gnomAD: Population allele frequencies across ancestries
Open Targets: Drug-target-disease associations, pharmacogenomics evidence
ClinicalTrials.gov: Clinical trial search (US and international)
Related MCP server: GenomeMCP
Installation
pip install pgx-mcpOr with uvx:
uvx pgx-mcpClaude Desktop Configuration
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"pgx-mcp": {
"command": "uvx",
"args": ["pgx-mcp"]
}
}
}For local development:
{
"mcpServers": {
"pgx-mcp": {
"command": "uv",
"args": ["--directory", "/path/to/mcp-pharmacogenomics", "run", "pgx-mcp"]
}
}
}Available Tools
Tool | Source | Description |
| ClinVar | Variant clinical significance |
| ClinVar | List variants in a gene |
| PharmGKB | Clinical annotations for drug-gene pairs |
| PharmGKB | Drug details and cross-references |
| PharmGKB | CPIC/DPWG dosing recommendations |
| Open Targets | Drug mechanisms, indications, PGx evidence |
| gnomAD | Population allele frequencies |
| ClinicalTrials.gov | Trial search with filters |
| ClinicalTrials.gov | Full trial details |
| All | Comprehensive PGx consultation report |
Example Usage
Ask Claude:
"My patient is a CYP2D6 poor metabolizer (*4/*4) and needs pain management. What should I prescribe?"
"What are the CPIC guidelines for clopidogrel and CYP2C19?"
"Are there any recruiting pharmacogenomics clinical trials in Germany?"
Configuration
All settings are optional and configured via environment variables (or a .env file):
Variable | Default | Description |
| None | NCBI API key for higher ClinVar rate limits (3/s → 9/s) |
| 3600 | Cache duration in seconds |
Development
git clone https://github.com/Julius-Schmidt/mcp-pharmacogenomics.git
cd mcp-pharmacogenomics
pip install -e ".[dev]"
pytestRoadmap
Demo video/GIF in README
EU Clinical Trials Register integration (currently no public API — European trials are covered through ClinicalTrials.gov registrations)
PharmVar star-allele nomenclature lookups
FDA Pharmacogenomic Biomarkers table integration
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Bioinformatics MCP for genomic variant interpretation, gene-disease evidence and literature.
Medical RAG: semantic search for clinical guidelines, drug interactions, diagnoses & EHR data.
Medical RAG: semantic search for clinical guidelines, drug interactions, diagnoses & EHR data.
Knowledge graph ingestion, entity search, ontology analysis, and CoPass scoring.
Related MCP Servers
- AlicenseCqualityFmaintenanceProvides AI-powered access to major biological databases for GWAS and bioinformatics research. Enables natural language queries for protein, gene, variant, pathway, and drug discovery analysis.441MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query clinical genomics databases, retrieve supporting literature, analyze population genetics, and visualize biological pathways.19MIT
- AlicenseAqualityDmaintenanceEnables AI-driven pharmacogenomic analysis by querying structured genetic variant, drug response, and disease risk data. Supports natural language questions about medications, traits, and health risks based on user genome data, with privacy-first local execution.161911MIT
- AlicenseNot gradedqualityCmaintenanceA local-first MCP server that annotates whole-genome VCF files and lets you query pharmacogenomics, disease risk, and carrier status through natural language.4MIT