list_species
Retrieve available species and genome assemblies from Ensembl's genomic database to identify organisms for biological research and data analysis.
Instructions
Get list of available species and assemblies
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| division | No | Ensembl division (e.g., vertebrates, plants, fungi) |
Implementation Reference
- src/index.ts:1501-1522 (handler)The handler function that implements the list_species tool. It makes a GET request to the Ensembl REST API '/info/species' endpoint, optionally filtering by division, and returns the JSON response containing available species and assemblies.
private async handleListSpecies(args: any) { try { const params: any = {}; if (args.division) { params.division = args.division; } const response = await this.apiClient.get('/info/species', { params }); return { content: [ { type: 'text', text: JSON.stringify(response.data, null, 2), }, ], }; } catch (error) { return this.handleError(error, 'listing species'); } } - src/index.ts:869-870 (registration)Registration of the list_species tool handler in the CallToolRequestSchema switch statement.
case 'list_species': return this.handleListSpecies(args); - src/index.ts:765-775 (schema)Tool schema definition including name, description, and input schema (optional division parameter) registered in ListToolsRequestSchema response.
// Species & Assembly Information { name: 'list_species', description: 'Get list of available species and assemblies', inputSchema: { type: 'object', properties: { division: { type: 'string', description: 'Ensembl division (e.g., vertebrates, plants, fungi)' }, }, required: [], }, - src/index.ts:108-117 (schema)TypeScript interface defining the structure of Ensembl species data returned by the list_species tool.
interface EnsemblSpecies { name: string; display_name: string; taxonomy_id: number; assembly: string; release: number; division: string; strain?: string; strain_collection?: string; }