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)
Installation
pip install pgx-mcp
Or with uvx:
uvx pgx-mcp
Claude 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 |
|---|---|---|
lookup_variant_clinvar |
ClinVar | Variant clinical significance |
search_gene_variants_clinvar |
ClinVar | List variants in a gene |
get_drug_gene_interactions |
PharmGKB | Clinical annotations for drug-gene pairs |
get_drug_info |
PharmGKB | Drug details and cross-references |
get_dosing_guideline |
PharmGKB | CPIC/DPWG dosing recommendations |
search_drug_targets |
Open Targets | Drug mechanisms, indications, PGx evidence |
get_variant_frequency |
gnomAD | Population allele frequencies |
search_clinical_trials |
ClinicalTrials.gov | Trial search with filters |
get_trial_details |
ClinicalTrials.gov | Full trial details |
pgx_consultation |
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:
| Variable | Default | Description |
|---|---|---|
PGX_MCP_NCBI_API_KEY |
None | NCBI API key for higher ClinVar rate limits |
PGX_MCP_CACHE_TTL_SECONDS |
3600 | Cache duration in seconds |
Development
git clone https://github.com/Julius-Schmidt/mcp-pharmacogenomics.git
cd mcp-pharmacogenomics
pip install -e ".[dev]"
pytest
License
MIT
Metadata
Release files for pgx-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pgx_mcp-0.1.0.tar.gz | 25.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pgx_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 52.6 kB
Release files / pgx_mcp-0.1.0.tar.gz
| Download URL | pgx_mcp-0.1.0.tar.gz |
|---|---|
| Size | 25.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c1bb7a223cd7bf17bcd93c424c6544dbfda463536488c472dc81f00be3aa960a
|
|
BLAKE2b-256 checksum How to use checksums |
5fa6fd2bf0c9cbfeae82cce479389702c733f444aad6856a80c4cbb48db6db94
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.18
|
Release files / pgx_mcp-0.1.0-py3-none-any.whl
| Download URL | pgx_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 27.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
24cbb946588726cb6c1069e22405039d9efb44f97e7246badfe51f273d6d11c3
|
|
BLAKE2b-256 checksum How to use checksums |
d4bdb7fbb4d3fd9ddd19b53a5462207fc3c8b29ae62a69985b7a792dd689bad3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.18
|