ensembl-mcp-server — Claude Code MCP server: setup guide
Access Ensembl REST API from your assistant to look up genes, retrieve genomic sequences, predict variant consequences, and find orthologs.
Apache-2.0 934 installs ★ 3 updated 2026-10-19
claude mcp add --transport http ensembl-mcp-server https://ensembl-mcp-server--cyanheads.run.toolsWhat ensembl-mcp-server 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.
What it helps with
- 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 for the agent
- Fetch the genomic coordinates and transcripts for gene BRCA2 using
ensembl_lookup_gene - Build a complete biological profile for TP53 using the
ensembl_gene_dossierprompt - Run
ensembl_predict_variantfor HGVS variantENST00000380152.8:c.2T>A
How to install ensembl-mcp-server
Platform CLI: remote server
claude mcp add --transport http ensembl-mcp-server https://ensembl-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add ensembl-mcp-server --url https://ensembl-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"ensembl-mcp-server": {
"url": "https://ensembl-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"ensembl-mcp-server": {
"type": "http",
"url": "https://ensembl-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http ensembl-mcp-server https://ensembl-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ensembl-mcp-server
How to install ensembl-mcp-server in Claude Code?
Run claude mcp add --transport http ensembl-mcp-server https://ensembl-mcp-server--cyanheads.run.tools in your terminal.
What does ensembl-mcp-server do?
It gives your coding assistant access to Ensembl REST API tools for retrieving gene details, biological sequences, variant effects, and ortholog mappings.
How does ensembl-mcp-server handle versioned Ensembl IDs?
It strips trailing version numbers such as .19 from stable IDs prior to querying Ensembl, preventing not-found responses from the API.