Bragproof

← Reports

@cyanheads/inaturalist-mcp-server

Starts with no setup0.3.3npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Returns a result when called with no setup: 3 of 4 tools tried
Contacts while installing and starting: nothing

10tools listed
0hosts contacted
0files written
0.4 sto start
36dependencies

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y @cyanheads/inaturalist-mcp-server@0.3.3

Installing a package runs its code. Use a sandbox for anything you have not read.

Calling its tools

4 tools that take no input and look read-only were called once with nothing. 3 returned a result.

inaturalist_find_placesNo usable answer tool reported an error: Error: The bounding box is incomplete — 0 of four corners were supplied, and no q was given. Recovery: Pass q to search place names, or
inaturalist_search_observationsReturned a result 1.0 s · 13,437 characters
inaturalist_get_species_countsReturned a result 6.5 s · 13,348 characters
inaturalist_get_histogramReturned a result 0.7 s · 477 characters

During the calls (not necessarily because of them) it first contacted: api.inaturalist.org.

Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

inaturalist_list_reference topic, taxon_id
Look up annotation attributes/values, quality grades, licences, ranks, iconic taxa, and conservation codes before filtering; unknown values can silently return nothing. Conservation codes decode the iucn level on taxon listings and, all but NE and DD, are the csi filter values, distinct from authority-specific taxon status text. With topic controlled_terms and taxon_id, also return observed annotation usage and counts.
inaturalist_resolve_name q, type, rank, limit, page
Resolve 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.
inaturalist_find_places q, nelat, nelng, swlat, swlng, per_page
Resolve a place name to a place id, or list places covering a map area. Pass q to match a display-name prefix or all analyzed query terms within it, or all four of nelat, nelng, swlat and swlng for a map area — exactly one of the two, never both. Each result carries its bounding box, place type, and containment chain. Upstream serves at most 20 places per list and may omit more.
inaturalist_search_observations place_id, lat, lng, radius, nelat, nelng, swlat, swlng, taxon_id, d1, d2, quality_grade, captive, term_id, term_value_id, iconic_taxa, user_id, user_login, project_id, ident_user_id, unobserved_by_user_id, hrank, lrank, csi, threatened, native, introduced, endemic, month, created_d1, created_d2, updated_since, acc_below, obscuration, identifications, licensed, photo_licensed, license, sounds, photo_license, q, search_on, order_by, order, page, cursor, per_page, include
Search georeferenced wildlife sightings by area, date, taxon, quality grade, annotation, conservation status, observer, project, and licence. Returns a projected record per sighting with coordinates, licence, first photo, and identification counts. An area is given in exactly one form — place_id, the lat/lng/radius triple in kilometres, or a four-corner bounding box — and defaults to research-grade, wild-only records, which are echoed back on every call. Identifications and comments are deliberately not expandable here; fetch them for specific records with inaturalist_get_observation. page walks the first 10,000 results under any ordering; past 10,000, order by id descending (order_by "id", order "desc") and pass each page’s next_cursor as cursor.
inaturalist_get_observation observation_id, include, array_offset, array_limit
Fetch up to 10 distinct observations by id with their community identification thread — who identified what, whether each identification agrees, and the consensus taxon the community landed on. The whole attempted batch costs one upstream request. Records come back in requested order; remaining distinct ids are deferred for another call with the same include. Missing attempted ids appear in unresolved; the call fails only when nothing resolved and no deferred work remains. Identifications, comments, and observation fields are sorted by ascending id (creation order) and share the array_limit budget across resolved records — by default up to 40 entries per array for one record, 4 for a full batch; every record reports the size of each array beside what it kept, and next_array_offset pages the rest.
5 more tools
inaturalist_get_species_counts place_id, lat, lng, radius, nelat, nelng, swlat, swlng, taxon_id, d1, d2, quality_grade, captive, term_id, term_value_id, iconic_taxa, user_id, user_login, project_id, ident_user_id, unobserved_by_user_id, hrank, lrank, csi, threatened, native, introduced, endemic, month, rank, page, per_page
Rank leaf taxa recorded in an area and period, most-observed first. Includes hybrids and coarser identifications; subspecies roll up to their species. An area is given in exactly one form: place_id, the lat/lng/radius triple in kilometres, or a four-corner bounding box. Narrow to a clade by passing taxon_id, e.g. the birds of a park, or to one observer or one project by user_id, user_login, or project_id. Defaults to research-grade, wild-only records and echoes those defaults back. For the most active people rather than the most recorded taxa, use inaturalist_get_leaderboard.
inaturalist_get_histogram taxon_id, place_id, lat, lng, radius, nelat, nelng, swlat, swlng, user_id, user_login, project_id, interval, date_field, d1, d2, created_d1, created_d2, quality_grade, captive, term_id, term_value_id, iconic_taxa
Build a phenology histogram for a taxon in an area — which months, weeks, or years it is recorded in. The default month_of_year interval answers "when does this bloom or appear here" in twelve buckets; absolute intervals (year, month, week, day, hour) bucket real dates and disclose their window start. An area is given in exactly one form: place_id, the lat/lng/radius triple in kilometres, or a four-corner bounding box. Omit taxon_id to chart every taxon in the area. Narrow to one life stage or reproductive state with an annotation pair (term_id and term_value_id, e.g. Life Stage = Larva, or Flowers and Fruits = Flowers), or to broad groups with iconic_taxa. Defaults to research-grade, wild-only records and echoes those defaults back.
inaturalist_get_leaderboard kind, place_id, lat, lng, radius, nelat, nelng, swlat, swlng, user_id, user_login, project_id, taxon_id, d1, d2, quality_grade, page, per_page
Rank the most active observers or identifiers for an area, period, and taxon — who knows this place or this group. kind selects which: observers are ranked by how many observations they recorded, identifiers by how many identifications they made. An area is given in exactly one form: place_id, the lat/lng/radius triple in kilometres, or a four-corner bounding box. Both endpoints rank only the top 500 entries, so page multiplied by per_page must stay at or below 500 — narrow the area, period, or taxon to bring someone further down into reach. For the most-recorded species rather than the most active people, use inaturalist_get_species_counts.
inaturalist_get_similar_species taxon_id, place_id, lat, lng, radius, nelat, nelng, swlat, swlng, d1, d2, quality_grade, captive, limit
List related taxa ranked by observations carrying current identifications of both taxa. This is co-identification evidence, not a directional correction count or an exhaustive list of visually similar organisms. Scope it to an area in exactly one form (place_id, the lat/lng/radius triple in kilometres, or a four-corner bounding box), or leave the area off for global results. The taxon must be a genus or finer (genus, species, or below). Resolve the organism name to a taxon id with inaturalist_resolve_name first.
inaturalist_get_taxon taxon_id, sections
Fetch a taxon profile: the taxonomic path, per-authority conservation listings, the encyclopedia summary, the photo gallery, immediate children, and observation counts. Resolve a name to a taxon id with inaturalist_resolve_name first. A taxon that overflows the response budget comes back as an outline of its sections with their byte sizes, and naming those sections in a re-call returns only those. The valid section names are summary, taxonomy, children, conservation, photos, and encyclopedia.

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseApache-2.0
Needsnode >=24.0.0
Sourcegithub.com/cyanheads/inaturalist-mcp-server
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-usJXNjTqwOB+4GEMVWtsKLTauQTj/O479HteYyAHw/5E+hPE+Ham/kp2Cx9y4/TDRwHcHAJs+YcescBdKEkPeg==

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/@cyanheads/inaturalist-mcp-server.svg)](https://bragproof.smaverk.com/r/%40cyanheads/inaturalist-mcp-server)

New version out? Ask for a fresh report.