paleobiology-mcp-server: diversity through time
paleobiology_get_diversityCompute a diversity / origination / extinction curve for a clade across geologic time, binned by period, epoch, or age — answers "plot dinosaur genus diversity across the Mesozoic." Pass a clade-inclusive base_name (or base_id, the same clade by resolved taxon id — exactly one of the two) and bound the span by a named interval (e.g. "Mesozoic") or a max_ma/min_ma range; choose what to count (genera, species, or families) and the bin resolution. The full bin set returns inline — a diversity series is a bounded set of geologic intervals — so you read the curve, the turnover, and the per-bin origination/extinction directly. Counts reflect SAMPLED diversity, biased by collection effort and rock availability, not true past diversity.
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": "paleobiology_get_diversity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | What to count per bin: "genera" (default), "species", or "families". | genera |
| latmax | No | Northern latitude edge in degrees; valid alone as a half-plane. PBDB normalizes inverted latitude bounds. | |
| latmin | No | Southern latitude edge in degrees; valid alone as a half-plane. | |
| lngmax | No | Eastern longitude edge in degrees; requires lngmin. | |
| lngmin | No | Western longitude edge in degrees; requires lngmax. A pair may cross the antimeridian. | |
| max_ma | No | Older bound of the span in millions of years ago. Alternative to interval. When paired with min_ma it must be strictly greater — max_ma is the deeper-time end of the span. | |
| min_ma | No | Younger bound of the span in millions of years ago. Alternative to interval. When paired with max_ma it must be strictly smaller — min_ma is the nearer-to-present end of the span. | |
| recent | No | When true, extend taxa PBDB knows are extant to the present instead of ending their ranges at the latest selected fossil. Default false preserves fossil-only counts; selection-boundary effects still apply. | |
| base_id | No | Clade-inclusive taxon to count, by PBDB taxon id — use accepted_no from paleobiology_get_taxon or an occurrence row for an accepted-clade search. Supply this or base_name (exactly one is required, never both). | |
| country | No | PBDB country or continent codes, e.g. "US", "NOA,^US", or "!EUR,^IS". | |
| interval | No | Named geologic interval bounding the span, e.g. "Mesozoic". Alternative to max_ma/min_ma. | |
| base_name | No | Clade-inclusive taxon to count, e.g. "Dinosauria" or "Ammonoidea" — this taxon and all descendants. Supply this or base_id (exactly one is required, never both). | |
| formation | No | Stored formation name, e.g. "Hell Creek"; comma lists and SQL wildcards are passed unchanged. Do not append Formation unless it is part of the stored name. | |
| resolution | No | Bin resolution: "period" (default, coarse), "epoch", or "age" (finest). | period |
| environment | No | Depositional environment: marine, terrestrial, or freshwater (lacustrine + fluvial). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bins | No | Per-interval diversity bins over the span, ordered oldest-first (oldest geologic interval, highest max_ma, first). | |
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Sampled-turnover interpretation, effective extant-range policy, selection-boundary guidance, empty-result selectors and ignored-filter warnings. | |
| totalCount | No | Number of geologic-interval bins returned. | |
| attribution | No | CC-BY data attribution for the Paleobiology Database. |