Skip to main content

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)

Source distribution for pgx-mcp 0.1.0
File Size Uploaded
pgx_mcp-0.1.0.tar.gz 25.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pgx-mcp 0.1.0
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page