Skip to main content
All providers

iNaturalist

Research

api.inaturalist.org

Community wildlife observations and taxonomy: what was seen, where, when and by whom.

Runs on your machine under the source's own terms

The crw MCP on your computer calls iNaturalist directly. Calls cost no credits and the data does not pass through fastCRW. Install it once for Claude Code, Cursor, Codex, Windsurf, Gemini CLI or OpenCode, with your fastCRW API key in place of the placeholder:

Capabilities (28)

inaturalist/controlled-termsFree, runs locally

The controlled annotation terms used across iNaturalist (Life Stage, Sex, Plant Phenology, Alive or Dead and the rest), each with its id, allowed values and the taxa it applies to.

locale?
inaturalist/controlled-terms-for-taxonFree, runs locally

Only the annotation terms that are valid for one taxon, with their permitted values: plant phenology for plants, life stage for insects, and so on.

taxon_idlocale?
inaturalist/identification-detailsFree, runs locally

One identification event in full, with the identifier's profile, the taxon proposed, the body text and the complete observation it was made on.

id
inaturalist/identificationsFree, runs locally

Individual identification events: who proposed which taxon on which observation, when, whether it is still the current ID, and its category (leading, improving, supporting, maverick).

q?taxon_id?observation_taxon_id?user_id?user_login?place_id?quality_grade?category?current?is_change?rank?observation_rank?d1?d2?observed_d1?observed_d2?id_above?order?order_by?per_page?page?only_id?
inaturalist/observation-detailsFree, runs locally

The complete record for one observation: every identification and comment, all photos and sounds, annotations, project memberships, faves and the data-quality votes.

idlocale?preferred_place_id?
inaturalist/observation-field-valuesFree, runs locally

The controlled-vocabulary annotations people actually applied to the matching observations (life stage, sex, plant phenology and so on), each with a monthly histogram of its use.

taxon_id?place_id?project_id?user_id?d1?d2?lat?lng?radius?nelat?nelng?swlat?swlng?iconic_taxa?quality_grade?locale?
inaturalist/observation-histogramFree, runs locally

Observation counts bucketed over time (by month of year, week of year, day, month or year) for whatever observation filter you pass.

taxon_id?taxon_name?place_id?project_id?user_id?d1?d2?lat?lng?radius?nelat?nelng?swlat?swlng?iconic_taxa?quality_grade?captive?verifiable?date_field?interval?locale?
inaturalist/observation-identifiersFree, runs locally

The users who added identifications to the observations matching your filter, with how many identifications each contributed, ranked.

taxon_id?place_id?project_id?d1?d2?lat?lng?radius?nelat?nelng?swlat?swlng?iconic_taxa?quality_grade?per_page?page?
inaturalist/observation-observersFree, runs locally

The users who recorded the observations matching your filter, each with their observation count and species count, ranked.

taxon_id?place_id?project_id?d1?d2?month?year?lat?lng?radius?nelat?nelng?swlat?swlng?iconic_taxa?quality_grade?order_by?per_page?page?
inaturalist/observationsFree, runs locally

Individual wildlife sightings with coordinates, observed date, observer, photo URLs, the current identification and its quality grade.

q?taxon_id?taxon_name?place_id?project_id?user_id?user_login?d1?d2?created_d1?month?year?lat?lng?radius?nelat?nelng?swlat?swlng?iconic_taxa?quality_grade?photos?sounds?captive?threatened?introduced?native?verifiable?license?photo_license?updated_since?locale?preferred_place_id?order_by?order?per_page?page?id_above?
inaturalist/observation-species-countsFree, runs locally

The leaf taxa matching an observation filter with the number of observations of each, ordered by count descending: a ranked species list for the filter you gave.

q?taxon_id?place_id?project_id?user_id?user_login?d1?d2?month?year?lat?lng?radius?nelat?nelng?swlat?swlng?iconic_taxa?quality_grade?captive?threatened?introduced?native?rank?hrank?lrank?include_ancestors?locale?preferred_place_id?per_page?page?
inaturalist/observation-taxon-summaryFree, runs locally

For the taxon currently identified on one observation: its Wikipedia summary, the conservation status that applies at that location, and whether it is listed as native or introduced there.

id
inaturalist/place-detailsFree, runs locally

One place record with its type and admin level, ancestor places, bounding box, computed area and the full GeoJSON boundary polygon.

idadmin_level?
inaturalist/places-autocompleteFree, runs locally

Places whose names start with your text (parks, counties, countries, open-space preserves), each with its place id, type, bounding box and full boundary polygon.

qorder_by?per_page?
inaturalist/places-nearbyFree, runs locally

Places that intersect a bounding box, split into curator-approved 'standard' places and user-created 'community' ones, each with its geometry.

nelatnelngswlatswlngname?per_page?
inaturalist/postsFree, runs locally

Journal posts published on iNaturalist by users and projects, with full HTML body, cover image, author and publication date, newest first.

login?project_id?per_page?page?
inaturalist/project-detailsFree, runs locally

One project with its full rule set, the observation search terms it is built from, its admins, icon, banner, place and member count.

idrule_details?
inaturalist/project-membersFree, runs locally

The users who joined a project, with their role, their observation and identification counts inside it and whether they share hidden coordinates with it.

idrole?order_by?per_page?page?
inaturalist/projectsFree, runs locally

iNaturalist projects matching a query or a place, with each project's type, slug, icon, rules, admin list and member count.

q?place_id?lat?lng?radius?type?member_id?has_params?order_by?per_page?page?
inaturalist/searchFree, runs locally

One ranked list mixing taxa, places, projects and users that match your text, each result tagged with which type it is.

qsources?place_id?locale?preferred_place_id?per_page?
inaturalist/similar-speciesFree, runs locally

Species that identifiers attached to observations of your taxon, or that your taxon was proposed on, ranked by how often the mix-up happens, with the count behind each pair.

taxon_idplace_id?quality_grade?d1?d2?lat?lng?radius?
inaturalist/taxaFree, runs locally

Taxonomy records matching a query: scientific name, rank, ancestry ids, default photo, observation count and whether the name is still active.

q?id?rank?rank_level?parent_id?taxon_id?is_active?id_above?all_names?locale?preferred_place_id?order?order_by?per_page?page?
inaturalist/taxa-autocompleteFree, runs locally

Up to 30 taxa whose scientific or common names begin with your text, ordered for typeahead with exact and prefix matches first.

qrank?is_active?locale?preferred_place_id?per_page?
inaturalist/taxa-suggestFree, runs locally

Species that have actually been observed near a point, scored by how often they turn up there, with each suggestion's taxon record and the evidence count behind it.

latlngper_pagetaxon_id?observed_on?place_id?locale?preferred_place_id?
inaturalist/taxon-detailsFree, runs locally

The full taxon record: complete ancestor chain, children, Wikipedia summary and URL, conservation statuses, establishment means, the taxon photo set and listed places.

idlocale?preferred_place_id?all_names?
inaturalist/user-detailsFree, runs locally

One user's public profile: login, display name, join date, ORCID, icon, and their observation, identification, species and journal-post counts.

id
inaturalist/user-projectsFree, runs locally

The projects one user has joined, each as a full project record with its type, place and rules.

idrule_details?per_page?page?
inaturalist/users-autocompleteFree, runs locally

iNaturalist users whose login or display name matches your text, with their id, icon, site and lifetime observation count.

qproject_id?per_page?

Response example

The shape of data from inaturalist/controlled-terms (Annotation vocabulary). A sample, not live data.

Example truncated, full shape in JSON from the API.

JSON
{
  "total_results": 7,
  "page": 1,
  "per_page": 30,
  "results": [
    {
      "id": 17,
      "ontology_uri": "",
      "uri": "",
      "is_value": false,
      "multivalued": false,
      "uuid": "60901c4f-7b6d-4df9-a014-8ed66533d2dc",
      "values": [
        {
          "id": 18,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "126bf41d-c387-4b98-90be-c693bd41f429",
          "label": "Alive"
        },
        {
          "id": 19,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "04f8af94-a893-48d5-b43a-ba13956e7c5d",
          "label": "Dead"
        },
        {
          "id": 20,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "1e75ade7-f1c2-4ef7-994b-c5b07d52713e",
          "label": "Cannot Be Determined"
        }
      ],
      "taxon_ids": [
        1
      ],
      "excepted_taxon_ids": [
        43583
      ],
      "label": "Alive or Dead"
    },
    {
      "id": 33,
      "ontology_uri": "",
      "uri": "",
      "is_value": false,
      "multivalued": false,
      "uuid": "8e8fdbf3-1231-4d85-a52c-32b587d911d2",
      "values": [
        {
          "id": 34,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "ea244ff4-e33c-4079-afc1-4d497dd996c6",
          "taxon_ids": [
            26036,
            20978
          ],
          "label": "Not Established"
        }
      ],
      "taxon_ids": [
        26036,
        20978
      ],
      "label": "Established"
    },
    {
      "id": 1,
      "ontology_uri": "",
      "uri": "",
      "is_value": false,
      "multivalued": false,
      "uuid": "f895e9ce-fb2d-4a63-a486-ac424f497e02",
      "values": [
        {
          "id": 2,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "48722062-360d-4b6e-b72c-129c7066b3fa",
          "taxon_ids": [
            1
          ],
          "label": "Adult"
        },
        {
          "id": 3,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "b3b6e6d0-cbce-4886-bb2b-55bd99d44586",
          "taxon_ids": [
            47792,
            50190
          ],
          "label": "Teneral"
        },
        {
          "id": 4,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "c883d7b5-4eb5-4ad1-8cbc-56f5e2555869",
          "taxon_ids": [
            47208,
            48763,
            49369,
            47157,
            47822,
            47201,
            62164,
            47864,
            83204,
            83202,
            "… 1 more items"
          ],
          "label": "Pupa"
        },
        {
          "id": 5,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "0f0c03c2-4741-46db-a19a-7cac8a96d667",
          "taxon_ids": [
            47793,
            81769,
            56834,
            47744,
            47792,
            47651,
            47504,
            48011,
            48112,
            53795,
            "… 4 more items"
          ],
          "label": "Nymph"
        },
        {
          "id": 6,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "8ff477bd-0949-4a7a-9c67-64a8e3786876",
          "taxon_ids": [
            20978,
            47208,
            47822,
            47201,
            47157,
            49369,
            47864,
            48763,
            47794,
            83204,
            "… 2 more items"
          ],
          "label": "Larva"
        },
        {
          "id": 7,
          "ontology_uri": "",
          "uri": "",
          "blocking": false,
          "uuid": "fe58aedb-4375-4096-a61f-1cd718cf319f",
          "excepted_taxon_ids": [
            848317
          ],
          "taxon_ids": [
            48

Ask with this source

A prompt for your agent that names this source and how to call it through the crw MCP.

  • Annotation vocabulary

    Use iNaturalist (inaturalist) from fastCRW Pergamon, capability "Annotation vocabulary" (controlled-terms). You need the term_id and term_value_id numbers before you can filter observations by an annotation, or you are decoding annotations in a response. Example options: locale=en. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "inaturalist" and capability "controlled-terms". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Annotations for a taxon

    Use iNaturalist (inaturalist) from fastCRW Pergamon, capability "Annotations for a taxon" (controlled-terms-for-taxon). You are about to annotate or filter one specific organism and need to know which traits iNaturalist actually records for it. Example options: taxon_id=1, locale=en. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "inaturalist" and capability "controlled-terms-for-taxon". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Identification details

    Use iNaturalist (inaturalist) from fastCRW Pergamon, capability "Identification details" (identification-details). You have an identification id from a search or a webhook and need the whole context behind that single determination. Example options: id=910099310. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "inaturalist" and capability "identification-details". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Identification search

    Use iNaturalist (inaturalist) from fastCRW Pergamon, capability "Identification search" (identifications). You are auditing how a determination was reached or tracking one identifier's activity, rather than looking at observations. Example options: q=juvenile, taxon_id=47219, observation_taxon_id=47219. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "inaturalist" and capability "identifications". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

Licence

Unless you specify otherwise when you post Content, you agree to license Content you contribute to the Platform under the Creative Commons Attribution Noncommercial license (CC BY-NC).

https://www.inaturalist.org/pages/terms

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attributionText.

Source: iNaturalist