# Genomics MCP

Genomics MCP is a Claude Code MCP server for retrieving genomic datasets and reference records. An agent can request a specific locus from an archive or an indexed file.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: rewire-bio
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rewire-bio/genomics-mcp
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/genomics-mcp

## What it does

Genomics MCP retrieves genomic regions and attaches source details to its results. Its tools cover dataset searches, sample comparisons and reference lookups. It supports archives such as EGA and ENCODE alongside indexed files. Clinical interpretation and variant calling are outside its scope.

Region requests must name the genome assembly and use coordinates counted from 0, excluding the end boundary. Assemblies are not converted. Partial reads depend on format and server support; downloading an entire file is a separate action with a transfer budget. Local access is restricted to permitted folders.

The container needs Docker and is tested on Linux x86_64. Building from source requires Python 3.12, `uv`, a C compiler, plus development files for libcurl and zlib; pyBigWig is compiled with remote access support. AlphaGenome Atlas needs a personal key. EGA test access uses `GENOMICS_MCP_EGA_PUBLIC_TEST_ACCOUNT=1`. The unreleased SRA-to-FASTQ conversion requires SRA Toolkit. Local Streamable HTTP connections require a bearer token.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add genomics-mcp -- docker run -i --rm ghcr.io/rewire-bio/genomics-mcp:0.1.0
```

### Codex

**Platform CLI**
```bash
codex mcp add genomics-mcp -- docker run -i --rm ghcr.io/rewire-bio/genomics-mcp:0.1.0
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "genomics-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/rewire-bio/genomics-mcp:0.1.0"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "genomics-mcp": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/rewire-bio/genomics-mcp:0.1.0"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add genomics-mcp docker run -i --rm ghcr.io/rewire-bio/genomics-mcp:0.1.0
```

## When to use it
- Locate public genomic datasets and their files
- Extract a selected region from BAM or VCF
- Compare genotypes between samples
- Retrieve ClinVar entries for a variant
- Trace reference results to their sources and versions

## Example prompts
- Ask Genomics MCP for ClinVar entries associated with `7-140753336-A-T` on GRCh38, separating the classification categories.
- With Genomics MCP, calculate the average signal for `ENCFF792QDS` using assembly GRCh38 and interval `chr1:[1000000, 1001000)`.
- Have Genomics MCP locate ENA accession `DQ285577.1` and download its sequence as FASTA.

## Similar
- [personal-genomics](https://affpapa.org/en/nevibecode/skills/personal-genomics.md) — skill · ★ 173 repo stars
- [clinvar-database](https://affpapa.org/en/nevibecode/skills/clinvar-database.md) — skill · 2400 installs
- [tooluniverse-acmg-variant-classification](https://affpapa.org/en/nevibecode/skills/tooluniverse-acmg-variant-classification.md) — skill · 232 installs
- [tiledbvcf](https://affpapa.org/en/nevibecode/skills/tiledbvcf.md) — skill · 2100 installs
- [polars-bio](https://affpapa.org/en/nevibecode/skills/polars-bio.md) — skill · 2100 installs
- [tooluniverse-regulatory-genomics](https://affpapa.org/en/nevibecode/skills/tooluniverse-regulatory-genomics.md) — skill · 247 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
