io.github.cyanheads/ensembl-mcp-server
v0.6.1Look up genes, sequences, variants, homologs, and cross-database xrefs from Ensembl REST.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:03 AM
- Latency
- 264 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Fensembl-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/ensembl-mcp-server": {
"url": "https://ensembl.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
7 shown · authentication unknown
Get Gene Homologs
ensembl_get_homology
Find orthologs and/or paralogs of a gene across species. Returns each homolog's stable ID, species, homology type (ortholog_one2one, ortholog_one2many, paralog_many2many, etc.), percId and percPos (percent identical and positive positions, over the target protein's length), and taxonomy level. Essential for cross-species research — for example, "what is the mouse equivalent of human TP53?" or "how conserved is BRCA2 across mammals?". Provide either symbol + species or a stable gene ID. Target species can be filtered to a single species or left open to return all available homologs. Homologs keep Ensembl's own order, which starts with the closest relatives, and are returned max_results at a time (default 25); totalCount reports every homolog, and when more follow, nextOffset is the offset for the next page. A target_species outside the comparison Ensembl runs for the source species is answered from Ensembl's pan-taxonomic comparison when that comparison holds both species. Includes targetProteinId when available for ensembl_get_sequence with type="protein". targetSymbol is best-effort: a secondary gene lookup shares ten seconds across the returned rows and the remaining call deadline; missing names never remove homologs.
Schema valid · SHA-256 66ff8e43c6cf…
View input schema
{ "type": "object", "properties": { "symbol": { "description": "Gene symbol in the source species (e.g. BRCA2, TP53). Species defaults to homo_sapiens; set species for other organisms. Cannot be combined with id.", "type": "string" }, "id": { "description": "Ensembl stable gene ID (e.g. ENSG00000139618). A version suffix (ENSG00000139618.17) is accepted and dropped before the query. Use ensembl_lookup_gene to get the stable ID from a symbol. Cannot be combined with symbol.", "type": "string" }, "species": { "default": "homo_sapiens", "description": "Source species (the species the query gene belongs to) in Ensembl internal format. Default is homo_sapiens. Use ensembl_list_species with nameContains (a genus or common name, e.g. mouse) to find valid values.", "type": "string", "minLength": 1 }, "target_species": { "description": "Filter to homologs in a single target species (e.g. mus_musculus for mouse). Omit to return homologs across all available species. Use ensembl_list_species with nameContains (a genus or common name) to find valid values.", "type": "string" }, "type": { "default": "orthologues", "description": "Type of homologs to return. orthologues: genes related by speciation (cross-species equivalents). paralogues: genes related by duplication (within or across species). all: both orthologs and paralogs.", "type": "string", "enum": [ "orthologues", "paralogues", "all" ] }, "max_results": { "default": 25, "description": "Maximum number of homologs to return, counted from offset. Default 25. Broad orthology queries (e.g. BRCA2 across all species) can return 150+ homologs. Set to 0 to return every homolog from offset to the end, uncapped. totalCount always reports the full number available before offset and this cap.", "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "offset": { "default": 0, "description": "0-based position in Ensembl's homolog order where the returned page starts. Default 0. Pass nextOffset from a previous response to fetch the following page; an offset at or past totalCount returns no homologs.", "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://ensembl.caseyjhand.com/mcp