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) (optional) Quality filter: ‘research’, ‘needs_id’, or ‘casual’. Default: ‘research’.

  • per_page (integer) (optional) Number of species to return per page (1-500, default 20).

  • page (integer) (optional) One-based results page (default 1). iNaturalist exposes at most the first 10,000 matching records through this endpoint.

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 iNaturalist observations by taxon/name, place, and quality, ordered by observation ID desc…

iNaturalist_search_observations tool specification

Tool Information:

  • Name: iNaturalist_search_observations

  • Type: INaturalistTool

  • Description: Search iNaturalist observations by taxon/name, place, and quality, ordered by observation ID descending. Use metadata.next_page within the 10,000-result page window, or page=1 with metadata.next_id_below for sliding-window traversal beyond 10,000 records.

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) (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) (optional) Number of results per page (1-200, default 10).

  • page (integer) (optional) One-based results page (default 1). iNaturalist exposes at most the first 10,000 matching records through this endpoint.

  • id_below (integer) (optional) Sliding-window cursor. Set page=1 and pass metadata.next_id_below from the previous response to continue beyond the 10,000-result page limit.

Example Usage:

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

iNaturalist_search_taxa (Type: INaturalistTool)#

Search iNaturalist taxa with exact total and page continuation. Page-based access is limited to 1…

iNaturalist_search_taxa tool specification

Tool Information:

  • Name: iNaturalist_search_taxa

  • Type: INaturalistTool

  • Description: Search iNaturalist taxa with exact total and page continuation. Page-based access is limited to 10,000 ranked matches; refine broad searches when metadata.upstream_truncated is true.

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) (optional) Number of results to return per page (1-200, default 10).

  • page (integer) (optional) One-based results page (default 1). iNaturalist exposes at most the first 10,000 matching records through this endpoint.

Example Usage:

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