alterlab-ensembl

Query Ensembl REST API for genes, sequences, variants, and orthologs.

58|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-ensembl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alterlab-ensembl
Source: https://github.com/AlterLab-IEU/AlterLab-Academic-Skills/tree/main/skills/databases/alterlab-ensembl
Command: npx skills add https://github.com/AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-ensembl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Streamlines access to Ensembl genomic data by programmatically querying gene annotations, sequences, variants, and comparative genomics data across 250+ species.

Core Features & Use Cases

  • Gene Information Retrieval: look up genes by symbol or Ensembl ID to fetch coordinates, transcripts, and cross-references.
  • Sequence Retrieval: obtain genomic, transcript, and protein sequences for genes or regions in multiple formats.
  • Variant Analysis: run Variant Effect Predictor (VEP) predictions and retrieve variant-level data.
  • Comparative Genomics: discover orthologs/paralogs and map conservation across species.
  • Assembly & Region Utilities: map coordinates between assemblies (GRCh37/GRCh38) and query features in defined genomic regions.

Quick Start

Query Ensembl for a gene by symbol or Ensembl ID to retrieve core annotations and sequence data.

Frequently Asked Questions about alterlab-ensembl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Ensembl REST API for gene annotations and sequences?

You can query the Ensembl REST API by gene symbol or Ensembl ID to retrieve core gene annotations, coordinates, transcripts, and genomic, transcript, or protein sequences across 250+ species. The Skill applies rate limiting and error handling for robust data retrieval.

Can I run Variant Effect Predictor (VEP) analysis using the Ensembl REST API?

Yes, you can run Variant Effect Predictor (VEP) predictions and retrieve variant-level data directly through the Ensembl REST API. The Skill manages VEP requests with built-in rate limiting and error handling to ensure robust variant annotation retrieval.

What is the best way to find orthologs and paralogs across species in Ensembl?

The best way to find orthologs and paralogs is querying Ensembl comparative genomics REST endpoints to discover cross-species mappings. The Skill retrieves ortholog and paralog data across 250+ species to support comparative genomics and conservation analysis.

Does the Ensembl REST API support assembly mapping between GRCh37 and GRCh38?

Yes, the Ensembl REST API supports assembly mapping to convert genomic coordinates between assemblies like GRCh37 and GRCh38. The Skill includes region utilities to map coordinates and query genomic features within defined regions.

Do I need the requests library to access Ensembl REST data across 250+ species?

Yes, the requests library is required as a dependency to access Ensembl REST data. The Skill uses Python requests to query REST endpoints for genes, sequences, variants, and orthologs across 250+ species with built-in rate limiting and error handling.

Why does my Ensembl REST API query fail when retrieving variant data?

Ensembl REST API queries may fail due to rate limiting or network errors during variant data retrieval. The Skill implements rate limiting and error handling to ensure robust data retrieval, preventing failed requests when querying VEP results and variant-level annotations.