Search Observations
search_observationsSearch citizen-science wildlife observations on iNaturalist, ANY organism: plants, fungi, insects, birds, mammals, reptiles, amphibians. This is the tool for "sightings/observations of in in ". Filter by taxon name (scientific or common, e.g. "Leucanthemum vulgare"/"oxeye daisy", "Pandion haliaetus"/"osprey"), place name ("Yukon", "California"), year, threatened status, or quality grade. Returns photographed sightings with coordinates, dates, and observer info. Pairs well with GBIF for cross-validation.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"place": "California",
"taxon_name": "Pandion haliaetus",
"quality_grade": "research"
},
"name": "search_observations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Filter to a specific year | |
| place | No | Place name (country, state, park). Auto-resolved to place_id. | |
| per_page | No | Results per page (1-200, default 20) | |
| taxon_name | No | Scientific or common species/taxon name | |
| threatened | No | Restrict to IUCN-threatened taxa | |
| quality_grade | No | casual | needs_id | research (default: research) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| resolved | Yes | Resolved taxon and place IDs from input names | |
| observations | Yes | Array of observation records | |
| total_results | Yes | Total observation count matching filters |