Inaturalist Tools

Configuration File: inaturalist_tools.json Tool Type: Local Tools Count: 4

This page contains all tools defined in the inaturalist_tools.json configuration file.

Available Tools

iNaturalist_get_species_counts (Type: INaturalistTool)

Get species observation counts from iNaturalist for a given taxon group or location. Returns a ra…

iNaturalist_get_species_counts tool specification

Tool Information:

  • Name: iNaturalist_get_species_counts

  • Type: INaturalistTool

  • Description: Get species observation counts from iNaturalist for a given taxon group or location. Returns a ranked list of species by number of observations, showing which species are most frequently observed. Useful for biodiversity assessments, understanding species abundance, and identifying common species in an area. Example: species counts for Delphinidae (taxon 41479) returns bottlenose dolphin, common dolphin, etc. ranked by observations.

Parameters:

  • taxon_id ([‘integer’, ‘null’]) (optional) Parent taxon ID to get species counts within. Examples: 41479 (Delphinidae - dolphins), 41944 (Panthera - big cats), 47126 (Sequoioideae - redwoods).

  • place_id ([‘integer’, ‘null’]) (optional) Place ID to filter by location. Example: 10211 (Yellowstone).

  • quality_grade ([‘string’, ‘null’]) (optional) Quality filter: ‘research’, ‘needs_id’, or ‘casual’. Default: ‘research’.

  • per_page ([‘integer’, ‘null’]) (optional) Number of species to return (1-500, default 20).

Example Usage:

query = {
    "name": "iNaturalist_get_species_counts",
    "arguments": {
    }
}
result = tu.run(query)

iNaturalist_get_taxon (Type: INaturalistTool)

Get detailed taxonomy information for a species by its iNaturalist taxon ID. Returns scientific n…

iNaturalist_get_taxon tool specification

Tool Information:

  • Name: iNaturalist_get_taxon

  • Type: INaturalistTool

  • Description: Get detailed taxonomy information for a species by its iNaturalist taxon ID. Returns scientific name, common names, full taxonomic lineage (kingdom through species), observation count, conservation status, and Wikipedia link. Use iNaturalist_search_taxa first to find taxon IDs. Example: taxon 41482 returns Tursiops truncatus (bottlenose dolphin) with 19000+ observations.

Parameters:

  • taxon_id (integer) (required) iNaturalist taxon ID. Examples: 41482 (bottlenose dolphin), 43584 (Homo sapiens), 41944 (Panthera tigris), 48662 (monarch butterfly), 47126 (Sequoia sempervirens).

Example Usage:

query = {
    "name": "iNaturalist_get_taxon",
    "arguments": {
        "taxon_id": 10
    }
}
result = tu.run(query)

iNaturalist_search_observations (Type: INaturalistTool)

Search for georeferenced species observations from iNaturalist citizen scientists. Filter by taxo…

iNaturalist_search_observations tool specification

Tool Information:

  • Name: iNaturalist_search_observations

  • Type: INaturalistTool

  • Description: Search for georeferenced species observations from iNaturalist citizen scientists. Filter by taxon, location, date, and quality grade. Returns observation details including species, location, observer, date, and photo URLs. Useful for biodiversity surveys, species distribution mapping, and ecological research. Example: research-grade observations of bottlenose dolphins (taxon 41482) returns recent sightings with GPS coordinates.

Parameters:

  • taxon_id ([‘integer’, ‘null’]) (optional) iNaturalist taxon ID to filter by. Examples: 41482 (bottlenose dolphin), 41944 (tiger), 48662 (monarch butterfly).

  • query ([‘string’, ‘null’]) (optional) Text search for species name. Alternative to taxon_id.

  • quality_grade ([‘string’, ‘null’]) (optional) Observation quality: ‘research’ (community-verified), ‘needs_id’ (unverified), or ‘casual’. Default: ‘research’.

  • place_id ([‘integer’, ‘null’]) (optional) iNaturalist place ID to filter by location. Example: 10211 (Yellowstone National Park).

  • per_page ([‘integer’, ‘null’]) (optional) Number of results (1-200, default 10).

Example Usage:

query = {
    "name": "iNaturalist_search_observations",
    "arguments": {
    }
}
result = tu.run(query)

iNaturalist_search_taxa (Type: INaturalistTool)

Search for species and taxa in the iNaturalist taxonomy. Returns matching organisms with their sc…

iNaturalist_search_taxa tool specification

Tool Information:

  • Name: iNaturalist_search_taxa

  • Type: INaturalistTool

  • Description: Search for species and taxa in the iNaturalist taxonomy. Returns matching organisms with their scientific and common names, taxonomic rank, observation count, and conservation status. iNaturalist aggregates citizen science biodiversity observations worldwide. Example: searching ‘Panthera tigris’ returns the tiger with 22000+ observations.

Parameters:

  • query (string) (required) Search query for taxon name (scientific or common). Examples: ‘Panthera tigris’, ‘monarch butterfly’, ‘redwood’, ‘Homo sapiens’, ‘blue whale’.

  • per_page ([‘integer’, ‘null’]) (optional) Number of results to return (1-200, default 10).

Example Usage:

query = {
    "name": "iNaturalist_search_taxa",
    "arguments": {
        "query": "example_value"
    }
}
result = tu.run(query)