paleobiology-mcp-server: search fossil collections
paleobiology_search_collectionsFind fossil collections (localities) by area and geologic time — "what has been dug up here, and from what rock." Each locality returns its location, age (named interval and Ma), formation and strata, lithology, depositional environment, and the count of co-occurring fossils. Filter by a clade-inclusive base_name (or base_id, the same clade by resolved taxon id), a named interval or max_ma/min_ma range, a lng/lat bounding box, a formation or lithology name, and/or an environment. Results page inline via limit/offset (the response discloses when more remain). Take a collection_no from a row and pass it — or the same bbox+interval — to paleobiology_search_occurrences to see the actual fauna found together.
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_search_collections"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum localities to return per page, up to 10000, subject to PBDB_MAX_OCCURRENCES. Every fetched row is returned; the notice discloses a lower configured cap. | |
| latmax | No | Northern edge of the bounding box, decimal degrees (−90…90). Valid on its own — a lone latitude edge filters as a half-plane. | |
| latmin | No | Southern edge of the bounding box, decimal degrees (−90…90). Valid on its own — a lone latitude edge filters as a half-plane. | |
| lngmax | No | Eastern edge of the bounding box, decimal degrees (−180…180). Longitude is a closed pair — supply lngmin with it or neither. | |
| lngmin | No | Western edge of the bounding box, decimal degrees (−180…180). Longitude is a closed pair — supply lngmax with it or neither. | |
| max_ma | No | Older age bound in millions of years ago. When paired with min_ma it must be strictly greater — max_ma is the deeper-time end of the window. | |
| min_ma | No | Younger age bound in millions of years ago. When paired with max_ma it must be strictly smaller — min_ma is the nearer-to-present end of the window. | |
| offset | No | Number of localities to skip — page with limit by advancing offset. | |
| base_id | No | Clade-inclusive taxon filter by PBDB taxon id — the accepted_no from paleobiology_get_taxon or an occurrence row. Same semantics as base_name, but unambiguous where a name is not (homonyms, synonyms, unresolved spellings). Supply this or base_name, never both. | |
| country | No | PBDB country/continent codes, comma-separated; ! excludes a list and ^ subtracts a code, e.g. NOA,^US. | |
| interval | No | Named geologic interval bounding the age, e.g. "Maastrichtian". Alternative to max_ma/min_ma. | |
| base_name | No | Clade-inclusive taxon filter — localities yielding this taxon or its descendants, e.g. "Dinosauria". Supply this or base_id, never both. | |
| formation | No | Stored geologic formation name or PBDB list/wildcard expression, e.g. "Hell Creek"; passed unchanged, without stripping Formation, Group, or Member. | |
| lithology | No | Lithology (rock type) to filter by, e.g. "sandstone". | |
| environment | No | Depositional environment: "marine", "terrestrial", or "freshwater" (lacustrine + fluvial). Omit for all. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The per-page limit that was applied (set when truncated). | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of localities returned in this page (set when truncated). | |
| notice | No | Applied filters and guidance when no locality matched, localities remain past this page, offset ran past the match set, or PBDB ignored a filter value. | |
| truncated | No | True when localities remain past this page — advance offset for more. | |
| totalCount | No | Total localities matching the filters upstream, across all pages. | |
| attribution | No | CC-BY data attribution for the Paleobiology Database. | |
| collections | No | Matching localities for this page. |