GBIF Biodiversity

live Science

Search species, retrieve taxonomic data, and browse occurrence records from the Global Biodiversity Information Facility

3 tools
0ms auth
free tier 50 calls/day

Tools

search_species required: query

Search GBIF species backbone by name or keyword. Returns matched taxa with rank, status, and classification.

Parameters
Name Type Description
query req string Species name or keyword (e.g., "Homo sapiens", "oak")
limit opt number Maximum results to return (1-100, default 20)
▶ Try it
get_species required: key

Get full taxonomic details for a GBIF species by its integer taxon key. Use search_species first to find the key.

Parameters
Name Type Description
key req number GBIF taxon key (integer)
▶ Try it
get_occurrences required: key

Retrieve georeferenced occurrence records for a taxon. Optionally filter by ISO 3166-1 alpha-2 country code.

Parameters
Name Type Description
key req number GBIF taxon key (integer)
limit opt number Maximum records to return (1-300, default 20)
country opt string ISO 3166-1 alpha-2 country code to filter occurrences (e.g., "US", "DE")
▶ Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash 
curl -X POST https://gateway.pipeworx.io/gbif/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash 
curl -X POST https://gateway.pipeworx.io/gbif/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_species","arguments":{"query": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript 
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_species", {"query":"example"});
ask_pipeworx 
// Or ask in plain English:
const answer = await px.ask("search species, retrieve taxonomic data, and browse occurrence records from the global biodiversity information facility");