# ensembl-mcp-server

Access Ensembl REST API from your assistant to look up genes, retrieve genomic sequences, predict variant consequences, and find orthologs.

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

## What it does

This server integrates the Ensembl REST API into MCP environments via STDIO or HTTP. It exposes 7 tools to inspect genes by symbol or stable ID, pull DNA, cDNA, CDS, or protein sequences, query genomic regions, run VEP variant effect predictions, and retrieve external references across databases like HGNC, UniProt, and RefSeq.

Beyond tools, the package includes four resources under `ensembl://` URIs for direct gene, transcript, and species lookups, alongside a structured prompt named `ensembl_gene_dossier` for compiling multi-source biological reports.

Ensembl endpoints fail when requested with trailing version suffixes like `.19`, so the server trims them automatically from `ENS...` inputs. When running batch lookups via `ensembl_lookup_gene`, only the first 20 distinct queries get processed, while remaining items are marked omitted and need resubmission.

## Requirements
- Remote server: `https://ensembl-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http ensembl-mcp-server https://ensembl-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add ensembl-mcp-server --url https://ensembl-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ensembl-mcp-server": {
            "url": "https://ensembl-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ensembl-mcp-server": {
            "type": "http",
            "url": "https://ensembl-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http ensembl-mcp-server https://ensembl-mcp-server--cyanheads.run.tools
```

## When to use it
- resolve gene symbols and aliases to Ensembl genomic coordinates
- download DNA or peptide sequences for transcripts and proteins
- evaluate sequence variant consequences using Ensembl VEP
- identify gene orthologs and percent identity across species
- fetch cross-database identifiers from UniProt, RefSeq, and OMIM

## Example prompts
- Fetch the genomic coordinates and transcripts for gene BRCA2 using `ensembl_lookup_gene`
- Build a complete biological profile for TP53 using the `ensembl_gene_dossier` prompt
- Run `ensembl_predict_variant` for HGVS variant `ENST00000380152.8:c.2T>A`

## Similar
- [ensembl-database](https://affpapa.org/en/nevibecode/skills/ensembl-database.md) — skill · 2400 installs
- [ensembl-skill](https://affpapa.org/en/nevibecode/skills/ensembl-skill.md) — skill · 13 installs
- [tooluniverse-sequence-analysis](https://affpapa.org/en/nevibecode/skills/tooluniverse-sequence-analysis.md) — skill · 241 installs
- [tooluniverse-plant-genomics](https://affpapa.org/en/nevibecode/skills/tooluniverse-plant-genomics.md) — skill · 240 installs
- [cbioportal-skill](https://affpapa.org/en/nevibecode/skills/cbioportal-skill.md) — skill · 13 installs
- [genomic-intelligence](https://affpapa.org/en/nevibecode/skills/genomic-intelligence.md) — skill · 1200 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
