List Ensembl Species
ensembl_list_speciesList species supported by Ensembl with display name, common name, assembly, taxon ID, and division. Required discovery step — species names like homo_sapiens are opaque to non-biologists and are the input format every other Ensembl tool expects. Use nameContains to find a species by partial name match; filter by division to select one. With no division, lists the endpoint default division — the vertebrates (~356 species on the default GRCh38 endpoint). Species are sorted by internal name and returned max_results at a time (default 25); totalCount reports every match, and when more follow, nextOffset is the offset for the next page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "ensembl_list_species"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | 0-based position in the name-sorted matches 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 species. | |
| division | No | Filter to a specific Ensembl division. EnsemblVertebrates includes human, mouse, zebrafish, and other vertebrates. EnsemblPlants covers crop and model plant genomes. EnsemblFungi, EnsemblMetazoa, EnsemblProtists cover non-vertebrate model organisms. Omit to return the endpoint default division (vertebrates). | |
| max_results | No | Maximum number of species to return, counted from offset. Default 25. Set to 0 to return every matching species from offset to the end, uncapped. totalCount always reports the full number of matches before this cap. | |
| nameContains | No | Case-insensitive substring filter applied locally after fetching. Matches against species name, display name, and common name. Example: "sapiens" matches homo_sapiens; "mouse" matches mus_musculus. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The max_results limit applied to this page. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of species returned on this page. | |
| notice | No | Guidance when the filter matches no species, the offset is past the end, or more species follow this page. | |
| species | No | Species matching the filter criteria, sorted by internal name: at most max_results entries starting at offset. | |
| truncated | No | True when more matching species follow this page; request nextOffset to continue. | |
| nextOffset | No | Offset of the first species after this page — pass it as offset to fetch the next page. Present only when more species follow. | |
| totalCount | No | Total number of matching species after local filtering, before offset and max_results. Exceeds the returned species count when the list was paged. |