paleobiology-mcp-server
Server Details
Search fossil occurrences, taxon ranges, diversity through deep time, and the geologic time scale.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cyanheads/paleobiology-mcp-server
- GitHub Stars
- 2
- Server Listing
- @cyanheads/paleobiology-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 8 tools
Each tool targets a distinct resource or action: occurrence search, collection search, taxon resolution, interval lookup, reference resolution, diversity computation, and SQL over staged data. The dataframe_describe/dataframe_query pair is clearly framed as a dependent workflow rather than an overlap with the search tools. Descriptions make boundaries explicit.
All names use the same paleobiology_ prefix and snake_case, with predictable verbs such as get, list, and search. The two dataframe tools use a noun_verb order (dataframe_describe, dataframe_query) instead of verb_noun, but they remain internally consistent and readable.
Eight tools is well within the appropriate range for a read-only paleobiology data server. Each tool covers a distinct workflow, and there are no filler or duplicate tools.
The surface covers the core domain well: occurrence and collection search, taxonomy, geologic intervals, references, diversity curves, and staged SQL analysis. Minor gaps exist, such as no direct collection lookup by collection_no and no broader taxon search beyond name/id resolution, but these are workable through other tools.
Available Tools
8 toolspaleobiology_dataframe_describepaleobiology-mcp-server: describe staged canvas tablesARead-onlyIdempotentInspect
List the tables and their columns staged on a DataCanvas by paleobiology_search_occurrences. Call this before paleobiology_dataframe_query to discover the exact table_name and column names to reference in SQL.
Inputs: canvas_id (required). Returns: error, tables
paleobiology_dataframe_querypaleobiology-mcp-server: query staged occurrences with SQLARead-onlyIdempotentInspect
Run a read-only SQL SELECT against occurrence result sets staged on a DataCanvas by paleobiology_search_occurrences. This is how you analyze a large fossil set without re-fetching it: count occurrences by early_interval, group by formation, country (cc), or accepted_name, or filter by a paleo/modern coordinate range. The classification column is JSON — roll up by rank with json_extract_string(classification, '$.family') (also $.phylum, $.class, $.order, $.genus). Staged rows are occurrences, so collection-only fields such as lithology are not present. Reference tables by the table_name that paleobiology_search_occurrences returned — call paleobiology_dataframe_describe first if you do not know the table or column names. Every row supplied by the canvas is returned; choose smaller pages with SQL LIMIT/OFFSET. Results exceeding the canvas row cap include a notice naming the stable ORDER BY … LIMIT/OFFSET continuation. SELECT only; writes and file-reading functions are rejected.
Inputs: sql (required), canvas_id (required). Returns: rows, error, notice, row_count, +1 more
paleobiology_get_diversitypaleobiology-mcp-server: diversity through timeARead-onlyIdempotentInspect
Compute 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.
Inputs: count, latmax, latmin, lngmax, +11 more. Returns: bins, error, notice, totalCount, +1 more
paleobiology_get_referencespaleobiology-mcp-server: get bibliographic referencesARead-onlyIdempotentInspect
Resolve PBDB reference_no values — the source publication on every paleobiology_search_occurrences and paleobiology_search_collections row — to full citations with authors, year, title, publication, volume, pages, and DOI. Pass the ids from a page of rows in one call: the first 500 distinct ids are resolved and any beyond that come back in remaining_reference_nos for a follow-up call. Ids PBDB has no reference for are listed in not_found. Results keep the order the ids were given.
Inputs: reference_nos (required). Returns: error, notice, not_found, references, +2 more
paleobiology_get_taxonpaleobiology-mcp-server: get taxon record and fossil rangeARead-onlyIdempotentInspect
Resolve a taxon by name (e.g. "Tyrannosaurus") or integer taxon_no. The matched name, rank, parent, occurrence count and first/last appearance range describe taxon_no; accepted_no, accepted_name and accepted_rank identify PBDB's accepted taxon separately, and status carries its taxonomic opinion verbatim. Pass accepted_no as base_id to paleobiology_search_occurrences, paleobiology_get_diversity or paleobiology_search_collections for accepted-clade searches. Set show_children to page immediate child taxa with their own ranks and statuses.
Inputs: name, taxon_no, show_children, children_offset. Returns: name, rank, error, extant, +16 more
paleobiology_list_intervalspaleobiology-mcp-server: list geologic intervalsARead-onlyIdempotentInspect
Look up the geologic time scale — eons, eras, periods, epochs, and ages with their absolute-age boundaries in millions of years (Ma) and nesting. This is the reference that grounds every temporal filter on the other tools and translates a named interval like "Late Cretaceous" to its 100.5–66.0 Ma boundaries (and back). Filter by a name substring, a Ma range (overlap match), and/or a level; call with no filters to browse the full scale. Browsing and every name on the bundled ICS international-scale snapshot are answered offline. A name the snapshot does not carry — the sub-stage and regional names that occurrence and collection rows report, such as "Late Maastrichtian" or "Lancian" — costs one PBDB lookup across its other time scales; the response names which source answered and which scale the interval belongs to.
Inputs: name, level, max_ma, min_ma. Returns: error, notice, source, intervals, +2 more
paleobiology_search_collectionspaleobiology-mcp-server: search fossil collectionsARead-onlyIdempotentInspect
Find 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.
Inputs: limit, latmax, latmin, lngmax, +11 more. Returns: cap, error, shown, notice, +4 more
paleobiology_search_occurrencespaleobiology-mcp-server: search fossil occurrencesARead-onlyIdempotentInspect
Search fossil occurrences by clade-inclusive base_name or base_id, exact taxon_name, interval or max_ma/min_ma, modern geographic bounds, country, formation, environment, or collection_no. At least one filter is required. Formation matches PBDB stored names and preserves list/wildcard syntax; suffixes are not removed. Resolve uncertain taxon names with paleobiology_get_taxon. Rows carry modern lng/lat, reconstructed paleolng/paleolat, age, strata, classification, and source reference_no; keep the coordinate systems distinct. Every served page row is returned, with total matches and the offset that continues the page. When this deployment has DataCanvas enabled, a first page with additional matches stages up to 50,000 occurrences on a canvas: use paleobiology_dataframe_describe for columns, then paleobiology_dataframe_query for SQL over the staged set; the notice distinguishes complete from partial coverage. Later offsets and complete pages stage nothing and leave any supplied canvas untouched.
Inputs: limit, latmax, latmin, lngmax, +13 more. Returns: error, notice, spilled, canvas_id, +5 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Paleobiology Database (PBDB) MCP — the global fossil record. Keyless.
Search GBIF species taxonomy, occurrence records, datasets, and publishers.
Search GBIF species taxonomy, occurrence records, datasets, and publishers.
Macrostrat MCP — geologic map / column / unit data for North America and beyond.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables querying the Paleobiology Database for global fossil records via natural language or direct tools, without requiring an API key.328 npmMIT
- AlicenseNot gradedqualityCmaintenanceMacrostrat MCP — geologic map / column / unit data for North America and beyond.82 npmMIT
- AlicenseBqualityBmaintenanceEnables AI assistants to query and retrieve biodiversity data from the Global Biodiversity Information Facility (GBIF), including species, occurrences, datasets, and literature.5892 npmMIT
- AlicenseBqualityBmaintenanceEnables researchers to query and reconcile taxonomic data from the Lacewing Digital Library and Neuropterida Species of the World, including accepted names, type localities, distributions, references, and phylogeny records.21MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.