Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http ensembl-mcp-server https://ensembl-mcp-server--cyanheads.run.tools
Open on GitHub

What 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_dossier prompt
  • Run ensembl_predict_variant for HGVS variant ENST00000380152.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.tools

Step 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.

Similar MCP servers

All MCP servers for Science and research →

Project sponsors

Companies that keep this analytics open