{"openapi":"3.0.3","info":{"title":"Gnist Context — GBIF Biodiversity","description":"Global biodiversity data — species occurrences, taxonomy, and datasets from the Global Biodiversity Information Facility.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/gbif/`\n- **Toolkit page:** `/toolkits/gbif`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/gbif/search_species":{"post":{"tags":["Science"],"summary":"search_species","description":"Search the GBIF taxonomy backbone for species, genera, families, or higher taxa.\n\nCovers 2.4M+ species from the GBIF backbone taxonomy — the most comprehensive\nglobal species catalogue. Returns scientific names, common names, taxonomic hierarchy,\nand occurrence counts. Data aggregated from 2,100+ institutions worldwide.\n\nArgs:\n    query: Species name or keyword to search.\n    rank: Taxonomic rank filter.\n    habitat: Habitat filter.\n    limit: Number of results (1–50, default 20).\n\nReturns:\n    List of matching taxa with scientific name, common name, classification, and\n    occurrence count. Use the key with get_species or search_occurrences for details.","operationId":"gbif_search_species","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Species name or keyword (e.g. \"Panthera leo\", \"orchid\", \"Atlantic salmon\", \"pine\").","type":"string"},"rank":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Taxonomic rank filter: SPECIES, GENUS, FAMILY, ORDER, CLASS, PHYLUM, KINGDOM. Omit for all."},"habitat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Habitat filter: MARINE, FRESHWATER, TERRESTRIAL. Omit for all."},"limit":{"default":20,"description":"Number of results (1–50, default 20).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/gbif/get_species":{"post":{"tags":["Science"],"summary":"get_species","description":"Get full taxonomic details for a species by its GBIF taxon key.\n\nReturns the complete classification hierarchy from kingdom to species,\nplus status and occurrence count.\n\nArgs:\n    taxon_key: GBIF taxon key (numeric).\n\nReturns:\n    Full taxonomic record. Returns found=false if key not found.","operationId":"gbif_get_species","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"taxon_key":{"description":"GBIF taxon key (numeric). Found in search_species results.","type":"string"}},"required":["taxon_key"],"type":"object"}}}}}},"/rest/gbif/search_occurrences":{"post":{"tags":["Science"],"summary":"search_occurrences","description":"Search 2.4B+ biodiversity occurrence records — species sightings, specimens, and observations.\n\nEach record is a documented observation of a species at a specific place and time.\nSources include museum specimens, citizen science (eBird, iNaturalist), research surveys,\nand automated monitoring. Covers all of life — animals, plants, fungi, bacteria.\n\nArgs:\n    taxon_key: GBIF taxon key. Use search_species to find it.\n    scientific_name: Scientific name as alternative to taxon_key.\n    country: ISO country code to filter by location.\n    year_range: Year or year range filter.\n    basis_of_record: Filter by observation type.\n    has_coordinate: Only records with GPS coordinates.\n    limit: Number of results (1–50, default 20).\n\nReturns:\n    List of occurrence records with species, location, date, observer, and source dataset.","operationId":"gbif_search_occurrences","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"taxon_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"GBIF taxon key (numeric). Use search_species to find keys. Provide this or scientific_name."},"scientific_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Scientific name (e.g. \"Panthera leo\"). Alternative to taxon_key."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2 country code (e.g. 'NO' for Norway, 'US', 'GB')."},"year_range":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Year or year range (e.g. '2023' or '2020,2024' for a range)."},"basis_of_record":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Record type: HUMAN_OBSERVATION, PRESERVED_SPECIMEN, MACHINE_OBSERVATION, FOSSIL_SPECIMEN, LIVING_SPECIMEN."},"has_coordinate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Filter to records with GPS coordinates."},"limit":{"default":20,"description":"Number of results (1–50, default 20).","type":"integer"}},"type":"object"}}}}}},"/rest/gbif/search_datasets":{"post":{"tags":["Science"],"summary":"search_datasets","description":"Search 100K+ biodiversity datasets published through GBIF.\n\nDatasets are collections of occurrence records or species checklists published by\ninstitutions, museums, citizen science platforms, and research projects.\n\nArgs:\n    query: Search term for dataset titles and descriptions.\n    type_filter: Filter by dataset type.\n    publishing_country: Filter by country of the publishing organization.\n    limit: Number of results (1–50, default 20).\n\nReturns:\n    List of datasets with title, description, type, publisher, and record count.","operationId":"gbif_search_datasets","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Dataset search term (e.g. \"birds Norway\", \"marine mammals\", \"eBird\", \"herbarium\").","type":"string"},"type_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dataset type: OCCURRENCE, CHECKLIST, SAMPLING_EVENT, METADATA."},"publishing_country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2 code of the publishing country."},"limit":{"default":20,"description":"Number of results (1–50, default 20).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/gbif/get_species_distribution":{"post":{"tags":["Science"],"summary":"get_species_distribution","description":"Get the global distribution of a species — occurrence counts by country.\n\nShows which countries a species has been observed in and how many records exist.\nUseful for understanding species range, conservation status, and biodiversity hotspots.\n\nArgs:\n    taxon_key: GBIF taxon key (numeric).\n\nReturns:\n    List of countries with occurrence counts, sorted by count (highest first).","operationId":"gbif_get_species_distribution","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"taxon_key":{"description":"GBIF taxon key (numeric). Use search_species to find it.","type":"string"}},"required":["taxon_key"],"type":"object"}}}}}},"/rest/gbif/report_feedback":{"post":{"tags":["Science"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"gbif_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Science","description":"Data sources: Science"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}