`occurrences_near`

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

Find species occurrence records NEAR a location (latitude/longitude + radius). PREFER for “what species/wildlife are found near here”, “what birds/plants occur around these coordinates”, “is recorded near this spot”. Optionally filter by a GBIF taxon key (from search_species) to a group or species — e.g. 212 = birds, 6 = plants, 359 = mammals. Returns georeferenced records with species name, date, locality, and source.

Parameters

Name	Type	Required	Description
`latitude`	number	yes	Latitude in decimal degrees (e.g., 40.785).
`longitude`	number	yes	Longitude in decimal degrees (e.g., -73.968).
`radius_km`	number	no	Search radius in km (default 10, max 200).
`taxon_name`	string	no	Optional scientific name to restrict to, e.g. “Danaus plexippus”. Resolved to a GBIF backbone taxon key automatically. Alternative to taxon_key.
`taxon_key`	number	no	Optional GBIF backbone taxon key to restrict to a species or group (e.g., 212 = birds, 6 = plants, 359 = mammals).
`limit`	number	no	Maximum records to return (1-300, default 20).

Example call

Arguments

{
  "latitude": 40.785,
  "longitude": -73.968
}

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":"occurrences_near","arguments":{"latitude":40.785,"longitude":-73.968}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('occurrences_near', {
  "latitude": 40.785,
  "longitude": -73.968
});

More examples

{
  "latitude": -33.865,
  "longitude": 151.209,
  "radius_km": 25,
  "taxon_key": 212,
  "limit": 50
}

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.

occurrences_near