Gbif Biodiversity MCP Server

by cyanheads Your server? Claim it

answering

Gbif Biodiversity MCP Server is answering right now. Last checked 14 min ago. 105 installs a week from npm. It exposes 13 tools. Last commit 25 Aug 2026.

Search GBIF species taxonomy, occurrence records, datasets, and publishers.

Installs per day peak 155 · avg 21 · +105% w/w

a month agotoday

Uptime history 47 days of history · worst day 0%

47 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

321 ms

Response time

average over 24h

105

Installs / week

npm and PyPI

What changed 14

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 25 August 2026. No other catalogue keeps this.

25 Aug 13 tools changed the parameters they ask for gbif_bulk_match_species, gbif_count_occurrences, gbif_get_dataset and 10 more

25 Aug a tool changed version

Nothing serious here today

Today is the operative word: we check Gbif Biodiversity MCP Server every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 14 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add gbif-biodiversity-mcp-server --transport http https://gbif-biodiversity.caseyjhand.com/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gbif-biodiversity-mcp-server": {
      "url": "https://gbif-biodiversity.caseyjhand.com/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.gbif-biodiversity-mcp-server]
url = "https://gbif-biodiversity.caseyjhand.com/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "gbif-biodiversity-mcp-server": {
      "url": "https://gbif-biodiversity.caseyjhand.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "gbif-biodiversity-mcp-server": {
      "url": "https://gbif-biodiversity.caseyjhand.com/mcp"
    }
  }
}

This one needs environment variables set before it will start: MCP_HTTP_HOST (The hostname for the HTTP server.), MCP_HTTP_PORT (The port to run the HTTP server on.), MCP_HTTP_ENDPOINT_PATH (The endpoint path for the MCP server.), MCP_AUTH_MODE (Authentication mode to use: 'none', 'jwt', or 'oauth'.), MCP_LOG_LEVEL (Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').), GBIF_BASE_URL (Base URL every GBIF API request is built from. Override to route through a proxy or a mirror of the GBIF v1 API.), GBIF_REQUEST_TIMEOUT_MS (Milliseconds a single GBIF API request may take before it is aborted. Aborted attempts fall to the service's retry policy.), GBIF_USER_AGENT (Sent as the User-Agent header on every GBIF API request. GBIF asks integrators to identify themselves with a contact URL or email. Unset or blank sends the server name, version, and repository URL.). The author declared them in the registry entry; get the values from the project itself.

Available tools 13

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

gbif

gbif_bulk_match_species

Resolve up to 50 scientific names to GBIF backbone taxon keys in one call — the batch counterpart to gbif_match_species for checklist, inventory, and species-list workflows that would otherwise need one round trip per name. Each name is matched independently and results are returned in input order, one entry per name. A name with no backbone match yields matchType NONE (no taxonKey) instead of failing the batch; a per-name lookup failure yields matchType ERROR carrying that name's error message and, when the failure was classified, a machine-readable reason — the rest of the batch is unaffected, and the call as a whole still succeeds. When a queried name is a synonym, taxonKey is the accepted taxon it resolves to and matchedTaxonKey carries the synonym's own key. Common names are not supported — use gbif_search_species for vernacular searches. Below confidence 80, review the match.

gbif_count_occurrences

Count occurrences matching a taxon + location filter without fetching records. Use for quick totals ("how many Aves records in Sweden?") or before deciding whether to paginate a full search. Accepts taxonKey, country (uppercase ISO 3166-1 alpha-2), publishingCountry, stateProvince, isGeoreferenced, datasetKey, year, occurrenceStatus, and iucnRedListCategory. Counts sightings only by default, matching gbif_search_occurrences — GBIF also indexes absence records, and for some taxa they are the overwhelming majority. A count above 100,001 is the signal to partition rather than page: gbif_search_occurrences cannot reach past that offset, so split the query by DATASET_KEY via gbif_occurrence_facets and search each dataset separately.

gbif_get_dataset

Fetch full dataset metadata by UUID key — title, description, citation text, contacts, license, DOI, record count, numConstituents (sub-datasets), and temporal/geographic coverage. Use after gbif_search_datasets or when an occurrence record's datasetKey needs provenance detail. Contacts are capped by contactLimit (default 10); contactsTotal and contactsReturned report the full count.

gbif_get_occurrence

Fetch a single occurrence record by its GBIF occurrence key. Returns the complete Darwin Core record — all coordinates, administrative geography (GADM levels 0–3), dates, collections metadata, collector identifiers, conservation status, media links, and quality issue flags. Check occurrenceStatus before reading the record as a sighting: ABSENT means a survey looked for the taxon and did not find it. Use the occurrence key from gbif_search_occurrences results.

gbif_get_species

Fetch a single backbone taxon by its GBIF taxon key. Returns full classification, authorship, taxonomic status, vernacular name, descendant count, and publication reference. Use after gbif_match_species when you need the complete record rather than the match summary. When taxonomicStatus is SYNONYM, acceptedKey and accepted fields identify the accepted taxon. The extinct field is absent (not false) on most records — only present on explicitly flagged taxa.

gbif_get_species_children

List direct children of a backbone taxon — genera within a family, species within a genus, subspecies within a species. Paginated. Use gbif_match_species to get the taxonKey first, then iterate with offset for large groups.

gbif_get_species_classification

Return the parent chain for a taxon — from kingdom (or domain) down to the immediate parent of the queried taxon — as an ordered array. Each entry has its rank, canonical name, and taxon key. The array is returned root-first (kingdom → phylum → class → … → immediate parent of the queried taxon); the queried taxon itself is not included — call gbif_get_species for its own record. Useful for building taxonomic trees or understanding placement without navigating the backbone level-by-level.

gbif_match_species

Match a scientific name against the GBIF backbone taxonomy. Returns the best-matching taxon with full classification and a confidence score (0–100). This is the mandatory first step for any GBIF workflow — it returns the backbone taxonKey required by gbif_search_occurrences, gbif_count_occurrences, and gbif_occurrence_facets. When the queried name is a synonym, taxonKey is the accepted taxon it resolves to and matchedTaxonKey carries the synonym's own key; occurrence counts differ sharply between the two, so pass taxonKey. Below confidence 80, the match should be reviewed. matchType NONE means no usable match was found — try removing the strict flag or broadening the name.

gbif_occurrence_facets

Aggregate occurrence counts across a dimension (COUNTRY, STATE_PROVINCE, YEAR, BASIS_OF_RECORD, DATASET_KEY, KINGDOM_KEY, etc.). Returns one page of facet values ranked by count descending — the top facetLimit at facetOffset 0, a later slice of the same ranking past that. No record payloads returned. Core tool for distribution analysis and trend queries: "which countries have the most records for this species?", "how has observation volume changed since 2010?". Scope the aggregation with taxonKey, country (uppercase ISO 3166-1 alpha-2), publishingCountry, stateProvince, year, geometry, basisOfRecord, datasetKey, occurrenceStatus, or iucnRedListCategory filters. Also the way to split a result set too large for gbif_search_occurrences to page (offset+limit caps at 100,001): facet by DATASET_KEY, then search each datasetKey on its own. Aggregates sightings only by default, matching gbif_search_occurrences and gbif_count_occurrences; to measure the presence/absence split itself, pass facet OCCURRENCE_STATUS with occurrenceStatus ANY.

gbif_search_datasets

Search GBIF datasets by keyword, type, publishing country (uppercase ISO 3166-1 alpha-2), publishing organization, or hosting organization. The two organization filters answer different questions — publishingOrg matches the organization whose data it is, hostingOrg the organization whose installation serves it — and an organization key from gbif_search_publishers usually wants publishingOrg. Returns dataset title, description, license, record count, and DOI. Use to find the source dataset behind a set of records, or to explore what data collections are available for a taxon, country, or organization.

gbif_search_occurrences

Search 3.9B+ GBIF occurrence records with Darwin Core filters. Use taxonKey from gbif_match_species for reliable results — it resolves synonyms automatically. Accepts country (uppercase ISO 3166-1 alpha-2, where the record was observed), publishingCountry (the publishing organization's country — a different question), stateProvince, bounding box (decimalLatitude/decimalLongitude ranges), WKT polygon geometry, year range, month, basis of record, coordinate filter, and dataset key. Returns sightings only by default — GBIF also indexes absence records (surveys that looked and found nothing), and occurrenceStatus controls whether they are included. Pagination is capped at offset+limit=100,001 and GBIF offers no cursor or scroll, so a larger result set is covered only by partitioning it — facet it by DATASET_KEY with gbif_occurrence_facets and search each datasetKey separately. This server cannot download a result set in bulk; that needs the GBIF Download API with a GBIF.org account, or the GBIF snapshot on AWS Open Data.

gbif_search_publishers

Search organizations registered with GBIF by name fragment or country. Returns organization key, title, and country — sufficient to chain into gbif_search_datasets as publishingOrg for the datasets an organization published, or as hostingOrg for the ones its own installation serves, or to understand who publishes data for a region. publishingOrg is the usual chain: most organizations publish through an installation someone else runs, so hostingOrg matches nothing for them.

gbif_search_species

Search or browse the GBIF backbone taxonomy. Accepts scientific name fragments, rank filters, and higher-taxon constraints. Useful for exploring what species exist under a higher taxon (e.g., "list all families of Coleoptera"), for simple name-fragment searches, or when gbif_match_species returns too narrow a result. kingdom, family, and genus scope the browse to a higher taxon: each is resolved to its backbone key before the search runs, so the narrowest one supplied is what scopes, an alternative name resolves to the taxon it is a synonym of, and a name that matches no backbone taxon at that rank fails rather than returning the whole index. Names are capitalized as GBIF writes them ("Paridae", not "paridae") and are matched exactly, not fuzzily. Paginated — use limit and offset to walk through results.

Endpoints

URL	Transport	State	Latency	Checked
https://gbif-biodiversity.caseyjhand.com/mcp	streamable-http	answering	405 ms	14 min ago

Alternatives to Gbif Biodiversity MCP Server

same job, measured the same way

Paleobiology MCP Server

by cyanheads

Search fossil occurrences, taxon ranges, diversity through deep time, and the geologic time scale.

75 installs/wk 7 tools answering

Loreboard

by loreboard

Search curated Lorcana resources, evidence, taxonomies, and public change history.

4 tools answering

GuideDoc Documentary Database

by guidedoc

Search public documentary film reference pages and check which titles stream on GuideDoc.

2 tools answering

Mostly Right

by mostlyright

Search, sample and query open reproducible datasets published as immutable Parquet with schemas.

38 tools answering

Namefi

by namefi

Search, buy, and manage domains, DNS records, orders, and NFSC balance on Namefi.

answering

Public Official Asset Disclosure (공직자 재산공개)

by yujiseok

Korean public official asset disclosure data (공직자 재산공개) - search and retrieve assets

31 installs/wk local only

MCP Ashby

by smeet666

Search public Ashby job boards: resolve a company, read its openings and the pay it publishes.

66 installs/wk local only

MCP Recipes

by smeet666

Search six recipe sites at once, in French, English and Spanish, and scale quantities.

80 installs/wk local only

Gbif Biodiversity MCP Server — questions

Answers built from our own checks of this server.

What can Gbif Biodiversity MCP Server do?

It exposes 13 tools, read directly from the server on our last check. Among them: gbif_bulk_match_species, gbif_count_occurrences, gbif_get_dataset, gbif_get_occurrence, gbif_get_species, gbif_get_species_children and 7 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Gbif Biodiversity MCP Server working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 321 ms. The bar chart above shows every period we have measured.

How do I connect Gbif Biodiversity MCP Server?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Gbif Biodiversity MCP Server need an API key?

No. Gbif Biodiversity MCP Server completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 13 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Gbif Biodiversity MCP Server?

It answers our handshake in 321 ms on average, which is faster than 47% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use Gbif Biodiversity MCP Server?

The npm package @cyanheads/gbif-biodiversity-mcp-server was installed 105 times in the last week. Week over week that is +105%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Gbif Biodiversity MCP Server open source?

Yes — it is published under the Apache-2.0 licence, written in TypeScript, 1 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.