`get_species`

Pack: gbif · Endpoint: https://gateway.pipeworx.io/gbif/mcp

Get complete taxonomic classification for a species (kingdom through subspecies). Requires taxon key from search_species. Returns all ranks and accepted name status.

Parameters

Name	Type	Required	Description
`key`	number	yes	GBIF taxon key (integer)

Example call

Arguments

{
  "key": 2436436
}

curl

curl -X POST https://gateway.pipeworx.io/gbif/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_species","arguments":{"key":2436436}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_species', {
  "key": 2436436
});

Response shape

Always returns: key, scientific_name, canonical_name, rank, taxonomic_status, authorship, name_type, kingdom, phylum, class, order, family, genus, species, num_descendants, num_occurrences, extinct, marine, freshwater, terrestrial, habitats

Field	Type	Description
`key`	number	GBIF taxon key identifier
`scientific_name`	string \| null	Full scientific name
`canonical_name`	string \| null	Canonical form of scientific name
`rank`	string \| null	Taxonomic rank
`taxonomic_status`	string \| null	Status (accepted, synonym, etc.)
`authorship`	string \| null	Author(s) who named the taxon
`name_type`	string \| null	Type of name (scientific, vernacular)
`kingdom`	string \| null	Kingdom classification
`phylum`	string \| null	Phylum classification
`class`	string \| null	Class classification
`order`	string \| null	Order classification
`family`	string \| null	Family classification
`genus`	string \| null	Genus classification
`species`	string \| null	Species classification
`num_descendants`	number \| null	Number of descendant taxa
`num_occurrences`	number \| null	Number of occurrence records
`extinct`	boolean \| null	Whether species is extinct
`marine`	boolean \| null	Whether species occurs in marine environments
`freshwater`	boolean \| null	Whether species occurs in freshwater environments
`terrestrial`	boolean \| null	Whether species occurs in terrestrial environments
`habitats`	array	List of habitat types

Full JSON Schema

{
  "type": "object",
  "properties": {
    "key": {
      "type": "number",
      "description": "GBIF taxon key identifier"
    },
    "scientific_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full scientific name"
    },
    "canonical_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Canonical form of scientific name"
    },
    "rank": {
      "type": [
        "string",
        "null"
      ],
      "description": "Taxonomic rank"
    },
    "taxonomic_status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Status (accepted, synonym, etc.)"
    },
    "authorship": {
      "type": [
        "string",
        "null"
      ],
      "description": "Author(s) who named the taxon"
    },
    "name_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type of name (scientific, vernacular)"
    },
    "kingdom": {
      "type": [
        "string",
        "null"
      ],
      "description": "Kingdom classification"
    },
    "phylum": {
      "type": [
        "string",
        "null"
      ],
      "description": "Phylum classification"
    },
    "class": {
      "type": [
        "string",
        "null"
      ],
      "description": "Class classification"
    },
    "order": {
      "type": [
        "string",
        "null"
      ],
      "description": "Order classification"
    },
    "family": {
      "type": [
        "string",
        "null"
      ],
      "description": "Family classification"
    },
    "genus": {
      "type": [
        "string",
        "null"
      ],
      "description": "Genus classification"
    },
    "species": {
      "type": [
        "string",
        "null"
      ],
      "description": "Species classification"
    },
    "num_descendants": {
      "type": [
        "number",
        "null"
      ],
      "description": "Number of descendant taxa"
    },
    "num_occurrences": {
      "type": [
        "number",
        "null"
      ],
      "description": "Number of occurrence records"
    },
    "extinct": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether species is extinct"
    },
    "marine": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether species occurs in marine environments"
    },
    "freshwater": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether species occurs in freshwater environments"
    },
    "terrestrial": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether species occurs in terrestrial environments"
    },
    "habitats": {
      "type": "array",
      "description": "List of habitat types",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "key",
    "scientific_name",
    "canonical_name",
    "rank",
    "taxonomic_status",
    "authorship",
    "name_type",
    "kingdom",
    "phylum",
    "class",
    "order",
    "family",
    "genus",
    "species",
    "num_descendants",
    "num_occurrences",
    "extinct",
    "marine",
    "freshwater",
    "terrestrial",
    "habitats"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "gbif": {
      "url": "https://gateway.pipeworx.io/gbif/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_species