Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CACHE_TTLNoCache entry time-to-live in milliseconds.3600000
LOG_LEVELNoLog verbosity written to stderr. One of: error, warn, info, debug.info
LOG_FORMATNoFormat of log output.json
GBIF_TIMEOUTNoTimeout in milliseconds for GBIF API requests.30000
CACHE_ENABLEDNoWhether response caching is enabled.true
GBIF_BASE_URLNoBase URL of the GBIF API.https://api.gbif.org/v1
GBIF_PASSWORDNoGBIF account password. Only needed for occurrence download requests; everything else works anonymously.
GBIF_USERNAMENoGBIF account username. Only needed for occurrence download requests; everything else works anonymously.
CACHE_MAX_SIZENoMaximum number of entries kept in the LRU cache.100
GBIF_USER_AGENTNoUser agent string sent with GBIF API requests.GBIF-MCP-Server/1.1.0
MCP_LEGACY_CLIENTSNoMCP protocol handling: 'serve' accepts both 2026-07-28 and 2025-era initialize clients; 'reject' accepts 2026-07-28 clients only, older clients receiving error -32022.serve
RESPONSE_MAX_SIZE_KBNoMaximum size of a tool result in KB; larger results are truncated to fit AI context windows.250
RATE_LIMIT_CONCURRENTNoMaximum number of concurrent requests.10
RESPONSE_WARN_SIZE_KBNoSize threshold in KB above which a response size warning is logged.200
RATE_LIMIT_MAX_REQUESTSNoMaximum number of requests allowed within the rate limiting window.100
RESPONSE_ENABLE_TRUNCATIONNoSet to false to disable truncation of oversized responses.true
RESPONSE_ENABLE_SIZE_LOGGINGNoWhether response size logging is enabled.true

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
gbif_species_searchB

Search for species in the GBIF taxonomic backbone. Supports filtering by rank, status, habitat, threat level, and more.

gbif_species_getB

Get detailed information about a specific species by its GBIF key.

gbif_species_suggestA

Get species name suggestions for autocomplete functionality.

gbif_species_matchB

Fuzzy match a species name against the GBIF backbone taxonomy.

gbif_species_vernacular_namesB

Get vernacular (common) names for a species in multiple languages. Returns preferred names when available.

gbif_species_synonymsA

Get all synonyms and alternative scientific names for a species. Useful for name resolution and historical name tracking.

gbif_species_childrenB

Get direct taxonomic children of a taxon (e.g., species under a genus, subspecies under a species). Useful for exploring taxonomy hierarchically.

gbif_species_parentsA

Get the complete taxonomic classification path from kingdom down to the specified taxon. Returns the full hierarchy including all parent taxa. Useful for breadcrumb navigation and understanding taxonomic position.

gbif_species_descriptionsA

Get textual descriptions for a species from various sources. Includes morphological descriptions, habitat information, behavior, and other narrative content.

gbif_species_distributionsB

Get known geographic distribution records for a species. Includes information about occurrence status, establishment means, and locality details.

gbif_species_mediaA

Get associated multimedia records for a species including images, sounds, and videos. Returns URLs and metadata for media resources from various sources.

gbif_species_metricsA

Get quick occurrence statistics for a species without running full searches. Returns total occurrence count, dataset count, country count, and basis of record breakdown. Fast endpoint perfect for species profile pages, dashboards, and quick data availability checks.

gbif_species_parse_namesA

Parse and standardize scientific names in batch using GBIF's name parser. Extracts genus, species, authorship, rank, and more from scientific name strings. Essential for data cleaning, quality checking, and standardizing names from spreadsheets or databases. Handles up to 1000 names per request.

gbif_species_relatedA

Get related species including siblings (same parent taxon), variants, and associated taxa. Useful for taxonomic exploration, "see also" functionality, discovering similar species, and understanding taxonomic relationships. Returns species at the same taxonomic level with shared higher classification.

gbif_occurrence_searchA

Search GBIF occurrence records (species observations and specimens) with comprehensive filtering by taxonomy, geography, time, data quality, and more. Returns paginated results with optional facets for aggregations.

gbif_occurrence_getA

Get complete details for a single occurrence record including verbatim fields, interpretation history, media, and data quality issues.

gbif_occurrence_countA

Fast endpoint for counting occurrences matching filters without retrieving full records. Useful for statistics, dashboards, and filter validation before running full searches.

gbif_occurrence_download_requestA

Request an asynchronous download for large occurrence datasets beyond pagination limits (100,000+ records). Returns a download key for checking status. REQUIRES AUTHENTICATION: Set GBIF_USERNAME and GBIF_PASSWORD environment variables.

gbif_occurrence_download_predicate_builderB

Helper tool to build a download predicate from simple search parameters. Converts occurrence search filters into the complex predicate format required by the download API.

gbif_occurrence_download_statusA

Check the status and retrieve metadata for an occurrence download request. Returns status, download link when ready, record count, and file size.

gbif_occurrence_verbatimA

Get the original, unprocessed occurrence record as provided by the publisher, before GBIF interpretation. Includes all original Darwin Core fields with full URIs.

gbif_occurrence_counts_by_basis_of_recordA

Get occurrence counts broken down by basis of record type (observations, specimens, etc.). Returns a breakdown showing how many occurrences of each type match your filters. Essential for understanding dataset composition and data quality. Very fast - use for dashboards and quick statistics.

gbif_occurrence_counts_by_yearA

Get occurrence counts broken down by year for temporal trend analysis. Returns year-by-year counts showing how observations have accumulated over time. Perfect for time series visualization, identifying data collection patterns, and understanding temporal coverage. Fast endpoint for dashboards.

gbif_occurrence_counts_by_countryA

Get occurrence counts broken down by country for geographic distribution analysis. Returns counts per country showing global distribution patterns. Essential for understanding species ranges, identifying data gaps by region, and prioritizing conservation efforts. Fast statistics endpoint.

gbif_occurrence_counts_by_publishing_countryA

Get occurrence counts broken down by the country of the publishing organization. Shows which countries are contributing data, useful for understanding data provider distribution, identifying data collaboration opportunities, and analyzing global participation in GBIF. Different from occurrence country (where specimen was collected).

gbif_occurrence_counts_by_datasetA

Get occurrence counts broken down by contributing dataset. Identifies which datasets contribute most records for a given query. Essential for data attribution, understanding data sources, finding primary datasets for a taxon/region, and acknowledging data providers. Returns dataset UUIDs with counts.

gbif_occurrence_counts_by_taxonA

Get occurrence counts broken down by species (GBIF backbone speciesKey) for taxonomic composition analysis. Returns counts per species within the filtered taxon, most frequent first (top 100). Useful for understanding biodiversity patterns, identifying dominant species, and analyzing taxonomic coverage within a higher taxon. Fast statistics for ecological analysis.

gbif_occurrence_counts_by_publishing_orgB

Get occurrence counts broken down by publishing organization UUID. Identifies which institutions are contributing the most data for a query. Essential for data attribution, understanding institutional contributions, acknowledging data providers, and analyzing organizational participation. Returns organization UUIDs with occurrence counts.

gbif_registry_search_datasetsB

Search for datasets in the GBIF registry. Find published datasets by type, keyword, publisher, geographic coverage, and taxonomic scope. Essential for discovering data sources and understanding dataset metadata.

gbif_registry_get_datasetA

Get complete metadata for a specific GBIF dataset by its UUID. Returns full dataset details including title, description, contacts, endpoints, geographic/taxonomic coverage, and citation information.

gbif_registry_dataset_metricsA

Get occurrence statistics and quality metrics for a dataset. Returns counts by basis of record, country, year, and data quality indicators. Useful for understanding dataset composition and coverage.

gbif_registry_dataset_documentA

Get the EML (Ecological Metadata Language) metadata document for a dataset. Returns structured XML metadata including dataset description, contacts, geographic/taxonomic/temporal coverage, methods, and project information. Essential for proper dataset citation, understanding data collection methods, and accessing complete metadata.

gbif_registry_search_organizationsB

Search for data-publishing organizations in the GBIF network. Find museums, herbaria, research institutions, and other biodiversity data publishers. Use to discover data providers and understand institutional participation.

gbif_registry_get_organizationA

Get complete details for a specific data-publishing organization. Returns contacts, addresses, datasets published, endorsement status, and institutional information.

gbif_registry_organization_datasetsB

List all datasets published by a specific organization. Shows the complete catalog of datasets contributed by an institution. Useful for understanding an organization's data contributions and portfolio.

gbif_registry_search_networksA

Search for dataset networks in GBIF. Networks are collaborative groups that organize related datasets (e.g., eBird, iNaturalist, Ocean Biodiversity Information System). Use to discover thematic data collections and partnerships.

gbif_registry_get_networkA

Get complete details for a specific dataset network. Returns network metadata, constituent datasets, contacts, and description. Use to understand collaborative data initiatives and their scope.

gbif_registry_network_datasetsA

List all constituent datasets within a specific network. Shows which datasets are part of a collaborative network. Useful for exploring thematic data collections like eBird observations or marine biodiversity networks.

gbif_registry_search_installationsA

Search for IPT (Integrated Publishing Toolkit) installations in the GBIF network. IPTs are servers that host and publish biodiversity datasets. Use to find technical infrastructure and data hosting platforms.

gbif_registry_get_installationA

Get complete details for a specific IPT or data server installation. Returns technical endpoint information, hosting organization, and datasets served by this installation.

gbif_registry_search_collectionsA

Search the Global Registry of Scientific Collections (GRSciColl) for natural history collections. Find museum collections, herbaria, tissue collections, and other scientific collections worldwide. Use to discover physical specimen holdings and their metadata.

gbif_registry_get_collectionA

Get complete details for a specific scientific collection from GRSciColl. Returns collection metadata, institutional affiliation, specimen holdings, contacts, and preservation methods. Essential for understanding physical specimen repositories.

gbif_registry_search_institutionsC

Search for scientific institutions in the Global Registry of Scientific Collections (GRSciColl). Find museums, herbaria, universities, and research institutions that house natural history collections worldwide.

gbif_registry_get_institutionA

Get complete details for a specific scientific institution from GRSciColl. Returns institutional metadata, collections housed, contacts, addresses, and identifiers. Use to understand institution profiles and their collection holdings.

gbif_registry_list_nodesA

List GBIF participant nodes (national/organizational participants). Nodes represent countries or organizations that participate in GBIF governance and data sharing. Essential for understanding GBIF network structure, national participation, and institutional membership.

gbif_registry_get_nodeA

Get complete details for a GBIF participant node. Returns node metadata, contacts, participation type, country information, and endorsement details. Use to understand national GBIF participation, governance structure, and institutional membership.

gbif_maps_get_tile_urlB

Generate a URL for occurrence map tiles with customizable styling and filters. Returns tile URLs in standard web Mercator projection (EPSG:3857) for use in web mapping applications, GIS software, or direct visualization.

gbif_maps_get_vector_tile_urlA

Generate URL for occurrence vector tiles in Mapbox Vector Tile (MVT) format. Vector tiles enable client-side styling, interactivity, and dynamic rendering. Ideal for web mapping libraries like Mapbox GL JS, Leaflet with vector tile plugins, or OpenLayers.

gbif_maps_get_raster_tile_urlA

Generate URL for pre-rendered PNG density map tiles. Raster tiles show occurrence density with various color schemes. Fast rendering, ideal for simple map displays. Use for quick visualization without client-side rendering overhead.

gbif_maps_list_stylesA

List all available map visualization styles for occurrence tiles. Returns style names, descriptions, and types (density/point/poly). Use to discover visualization options before generating tile URLs with gbif_maps_get_tile_url.

gbif_literature_searchA

Search scientific literature that cites GBIF data. Find peer-reviewed publications, reports, and papers that used GBIF-mediated data. Useful for understanding data impact, finding research examples, and tracking biodiversity research trends.

gbif_literature_getA

Get complete metadata for a scientific publication by its DOI. Returns title, authors, abstract, journal, citation info, and GBIF usage details. Use to get full details about a specific paper that used GBIF data.

gbif_vocabularies_listA

List all controlled vocabularies used in GBIF. Vocabularies define valid values for fields like basisOfRecord, establishmentMeans, occurrenceStatus, etc. Essential for understanding valid filter values and data standardization.

gbif_vocabularies_getA

Get a specific controlled vocabulary with all its concepts and definitions. Returns the complete vocabulary including all valid values, descriptions, and usage notes. Use to understand valid values for specific GBIF fields.

gbif_vocabularies_get_conceptA

Get detailed information about a specific concept within a controlled vocabulary. Returns the concept definition, usage notes, related terms, and examples. Use to understand the precise meaning and usage of specific vocabulary terms.

gbif_validator_validate_dwcaA

Validate a Darwin Core Archive (DwC-A) file against GBIF standards. Checks data structure, required fields, data quality, and format compliance. Returns validation report with issues, warnings, and recommendations. Essential before publishing datasets to GBIF.

gbif_validator_get_statusA

Check the status of an asynchronous Darwin Core Archive validation job. Validation is processed asynchronously, so use this tool to poll for completion and retrieve results. Returns validation status, progress, and results when complete.

gbif_validator_validate_tabularB

Validate tabular data files (CSV, TSV) against Darwin Core standards before creating archives. Checks column headers, data types, required fields, and format compliance. Useful for data preparation workflows, pre-publication validation, and quality assurance before creating Darwin Core Archives. Returns validation report with field-level issues.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 58 tools

Disambiguation4/5

Most tools have distinct purposes, but several families overlap: seven occurrence counts_by_* tools, three map tile URL generators, and species search/suggest/match could cause misselection. Descriptions help, but boundaries are not always crisply distinct.

Naming Consistency5/5

All tools follow a consistent gbif_{domain}_{action} snake_case convention. There is no mixing of camelCase or vague verb styles, making the naming predictable and readable.

Tool Count1/5

58 tools is an extreme mismatch for a single server; many could be consolidated (e.g., facet counts, tile URL types). This bloats the surface and increases the selection burden on agents.

Completeness5/5

The surface covers all major GBIF domains: species taxonomy, occurrence search/download/counts, registry (datasets, organizations, networks, installations, collections, institutions, nodes), maps, literature, vocabularies, and validation. The read-only scope is appropriate for a data access API.

Maintenance

ActivityMaintained
ResponsivenessNo issues