Inaturalist Resolve Name
inaturalist_resolve_nameResolve organism, place, project, or observer names to identifiers. Taxon lookup matches word starts within a name, not only its beginning; other types use cross-kind search with limited spelling tolerance. Without page, candidates retain relevance order. Explicit taxon pages browse name matches in ascending taxon-ID order; this can differ from autocomplete matching across languages. A miss returns found false with recovery guidance.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"q": "<q>"
},
"name": "inaturalist_resolve_name"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | The name to resolve. Taxon queries match word starts within a name or an exact numeric taxon id; other types match record text with limited spelling tolerance. | |
| page | No | Optional page for browsing beyond relevance-ranked suggestions. Taxon name pages use ascending taxon-ID order from page 1; numeric taxon IDs have only one page. Keep limit unchanged while paging. page × applied limit must not exceed 10,000. | |
| rank | No | Restrict taxon candidates to one rank. Honoured only on type "taxon" — the cross-kind search has no rank filter. | |
| type | No | Which kind of record to resolve. "taxon" uses autocomplete unless an explicit page browses name matches in taxon-ID order; numeric taxon IDs always use autocomplete. Other types use scored cross-kind search, and "any" searches all kinds. For place geometry and containment, use inaturalist_find_places. | taxon |
| limit | No | Maximum candidates to return, applied to every type. Ceiling: 30; oversized values are clamped. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Applied candidate limit. | |
| error | No | Present when the call failed. Absent on success. | |
| found | No | True when candidates matched, including an empty explicit page past an existing match set. | |
| shown | No | Number of candidates returned on this slice. | |
| notice | No | Composed clamp, continuation, or empty-page guidance. | |
| guidance | No | Why nothing matched and what to try instead. Present only when found is false — this is the primary result of a miss. | |
| truncated | No | True when further matching candidates remain beyond this slice. | |
| candidates | No | Candidates in relevance order, or ascending taxon-ID order on explicit taxon name pages. | |
| totalCount | No | Total candidates upstream matched, before the limit was applied. |