io.github.andrewschristison/pondlog-inaturalist

NPM · @PONDLOG/MCP-INATURALIST · SCANNED AUG 3

iNaturalist MCP server. Wildlife observations, species counts, taxa, and places worldwide.

Available components

+24 this week 66 66 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (97 of 101), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (97 of 101), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 82 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability63

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 1952 tokens (~216/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage95

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
86% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @pondlog/mcp-inaturalist

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add andrewschristison-pondlog-inaturalist -- npx -y @pondlog/mcp-inaturalist

# add to Codex CLI

codex mcp add andrewschristison-pondlog-inaturalist -- npx -y @pondlog/mcp-inaturalist

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "andrewschristison-pondlog-inaturalist": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@pondlog/mcp-inaturalist"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add andrewschristison-pondlog-inaturalist --command npx --arg -y --arg @pondlog/mcp-inaturalist

# ~/.hermes/config.yaml

mcp_servers:
  andrewschristison-pondlog-inaturalist:
    command: "npx"
    args: ["-y", "@pondlog/mcp-inaturalist"]

// mcp.json

{
  "mcpServers": {
    "andrewschristison-pondlog-inaturalist": {
      "command": "npx",
      "args": [
        "-y",
        "@pondlog/mcp-inaturalist"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +61
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: unverified → 0.23 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: MIT functional
1 Aug 26 −13
- Tool coverage: 100 → unverified ▼ functional
31 Jul 26 −24
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 +18
- Security disclosure: unverified → fail ▼ functional
- Tool coverage: unverified → 100 ▲ functional
28 Jul 26 −18
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
27 Jul 26 42

First indexed and scored.

Show 5 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@pondlog/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 97 packages

97 packages in the resolved dependency tree · 96 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 9 exposed · ~1,952 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

get_iconic_taxa_summary Iconic Taxa Summary at a Location ~268

Returns a high-level breakdown of recent activity grouped by iconic taxa group (Aves, Amphibia, Mammalia, etc.). For each group, returns the total observation count and the top 5 species by count. Useful for at-a-glance summaries. Aves = birds; Amphibia = frogs, salamanders, newts; Mammalia = mammals; Reptilia = reptiles; Insecta = insects; Arachnida = spiders, scorpions, mites; Mollusca = snails, slugs, clams, octopuses; Plantae = plants; Fungi = fungi, lichens; Actinopterygii = ray-finned fish; Animalia = catch-all animal kingdom (use only when others don't fit); Protozoa, Chromista = microscopic eukaryotes.

Input Output Examples

Name	Type	Req	Description
days	integer	—	Default 7 days.
lat	number	yes	WGS84 latitude in decimal degrees, between -90 and 90. Example: 48.118 for Port Angeles, WA.
lng	number	yes	WGS84 longitude in decimal degrees, between -180 and 180. Example: -123.4307 for Port Angeles, WA.
radius_km	number	—	Default 25 km.

No output schema declared.

No examples provided.

get_nearby_observations Get Nearby iNaturalist Observations ~171

Convenience tool for the most common query: 'what wildlife has been seen near these coordinates recently?' Returns up to 50 observations within `radius_km` over the last `days` days, ordered by observation date. For more control (taxon filters, date ranges, sort order), use `search_observations` instead.

Input Output Examples

Name	Type	Req	Description
days	integer	—	Default 7 days.
lat	number	yes	WGS84 latitude in decimal degrees, between -90 and 90. Example: 48.118 for Port Angeles, WA.
lng	number	yes	WGS84 longitude in decimal degrees, between -180 and 180. Example: -123.4307 for Port Angeles, WA.
radius_km	number	—	Default 25 km.

No output schema declared.

No examples provided.

get_observation Get iNaturalist Observation Detail ~76

Fetch a single observation by its iNaturalist ID, with full detail: photos, description, identification count, comment count, plus all the fields from the search response. Use after `search_observations` returns a result the caller wants to drill into.

Input Output Examples

Name	Type	Req	Description
id	—	yes	iNaturalist observation ID. Numeric or numeric string.

No output schema declared.

No examples provided.

get_observers Top iNaturalist Observers at a Location ~153

Returns the top observers (most prolific iNaturalist users) for a given geographic + temporal query. Each row: user id, login, display name, observation count, species count. Use this to find local naturalists or to credit who is documenting an area.

Input Output Examples

Name	Type	Req	Description
days	integer	—	Default 7 days.
lat	number	yes	WGS84 latitude in decimal degrees, between -90 and 90. Example: 48.118 for Port Angeles, WA.
lng	number	yes	WGS84 longitude in decimal degrees, between -180 and 180. Example: -123.4307 for Port Angeles, WA.
radius_km	number	—	Default 25 km.

No output schema declared.

No examples provided.

get_species_counts iNaturalist Species Counts at a Location ~369

Returns a count of observations per species for a geographic + temporal query. Each row: taxon name, common name, iconic group, observation count. Use this for 'what species have been seen here' rather than 'show me each individual sighting'. For a higher-level summary grouped by iconic taxa, use `get_iconic_taxa_summary` instead.

Input Output Examples

Name	Type	Req	Description
d1	string	—	—
d2	string	—	—
iconic_taxa	array	—	Filter to one or more iNaturalist iconic-taxa groups. Aves = birds; Amphibia = frogs, salamanders, newts; Mammalia = mammals; Reptilia = reptiles; Insecta = insects; Arachnida = spiders, scorpions, m…
lat	number	—	WGS84 latitude in decimal degrees, between -90 and 90. Example: 48.118 for Port Angeles, WA.
lng	number	—	WGS84 longitude in decimal degrees, between -180 and 180. Example: -123.4307 for Port Angeles, WA.
page	integer	—	—
per_page	integer	—	—
place_id	integer	—	—
radius_km	number	—	Search radius in kilometers. Maximum 500. Default 25. Use smaller values (5-25 km) for hyper-local queries; larger values (50-200 km) for regional surveys.

No output schema declared.

No examples provided.

get_taxon Get iNaturalist Taxon Detail ~59

Fetch a single taxon by ID, with full detail: ancestry chain, Wikipedia URL, total observations count, default photo. Use after `search_taxa` to drill into a specific match.

Input Output Examples

Name	Type	Req	Description
id	—	yes	iNaturalist taxon ID.

No output schema declared.

No examples provided.

search_observations Search iNaturalist Observations ~637

Search recent iNaturalist observations with rich filters: geographic radius, taxon, iconic group, date range, and quality grade. Returns up to `per_page` normalized observations (species name, observer, place, observed date, coordinates, URL). Use this when the caller asks for specific kinds of observations ('show me bird sightings near Olympic National Park last month'). For a simple 'what's nearby' query, prefer `get_nearby_observations`. For aggregate counts, prefer `get_species_counts`.

Input Output Examples

Name	Type	Req	Description
d1	string	—	Start date (inclusive), ISO YYYY-MM-DD. Example: 2025-04-01.
d2	string	—	End date (inclusive), ISO YYYY-MM-DD. Example: 2025-04-30.
iconic_taxa	array	—	Filter to one or more iNaturalist iconic-taxa groups. Aves = birds; Amphibia = frogs, salamanders, newts; Mammalia = mammals; Reptilia = reptiles; Insecta = insects; Arachnida = spiders, scorpions, m…
lat	number	—	WGS84 latitude in decimal degrees, between -90 and 90. Example: 48.118 for Port Angeles, WA.
lng	number	—	WGS84 longitude in decimal degrees, between -180 and 180. Example: -123.4307 for Port Angeles, WA.
order_by	string	—	Sort order. 'observed_on' for chronological by sighting date (most useful); 'created_at' for upload order; 'votes' for community-favorited.
page	integer	—	Page number, 1-indexed. iNaturalist caps page * per_page at 10,000.
per_page	integer	—	Results per page. Default 30, maximum 200.
place_id	integer	—	iNaturalist place ID. Use `search_places` first to look one up. Filters to a named region rather than lat/lng radius.
quality_grade	string	—	iNaturalist quality grade. 'research' = community-verified IDs (most reliable); 'needs_id' = uploaded but not yet verified; 'casual' = excluded from research-grade pool. Default: no filter (all grade…
radius_km	number	—	Geographic search radius in km. Required if `lat`/`lng` are provided. Default 25 when geo-searching. Maximum 500.
taxon_name	string	—	Taxon name to filter by. Accepts common name (e.g. 'frog', 'bald eagle') or scientific name (e.g. 'Pseudacris regilla'). Partial matches work.

No output schema declared.

No examples provided.

search_places Search iNaturalist Places ~106

Look up an iNaturalist 'place' (named region: park, county, country, etc.) by name. Returns up to 10 matches with id, display name, and (when available) coordinates. Use to convert a place name into a `place_id` you can pass to `search_observations` or `get_species_counts`.

Input Output Examples

Name	Type	Req	Description
query	string	yes	Place name. Example: 'Olympic National Park', 'Clallam County', 'Port Angeles'.

No output schema declared.

No examples provided.

search_taxa Search iNaturalist Taxa ~113

Search the iNaturalist taxonomy by name (common or scientific). Returns up to 30 matching taxa with id, scientific name, common name, rank (species/genus/family/etc.), and iconic group. Use this to look up a taxon ID before passing it to other tools, or to confirm a species is in iNat's taxonomy.

Input Output Examples

Name	Type	Req	Description
query	string	yes	Search term. Common name ('bald eagle') or scientific name ('Haliaeetus leucocephalus'). Partial matches work.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug