Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.andrewschristison/pondlog-mushroomobserver

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

Mushroom Observer MCP server. Mycology observations, fungal taxonomy, and region discovery.

+26 this week 67 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
Schema Quality & AI Usability62
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 1824 tokens (~364/item across 5 items; 5 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 Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
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-mushroomobserver

# add to Claude Code
claude mcp add andrewschristison-pondlog-mushroomobserver -- npx -y @pondlog/mcp-mushroomobserver
# add to Codex CLI
codex mcp add andrewschristison-pondlog-mushroomobserver -- npx -y @pondlog/mcp-mushroomobserver
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "andrewschristison-pondlog-mushroomobserver": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@pondlog/mcp-mushroomobserver"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add andrewschristison-pondlog-mushroomobserver --command npx --arg -y --arg @pondlog/mcp-mushroomobserver
# ~/.hermes/config.yaml
mcp_servers:
  andrewschristison-pondlog-mushroomobserver:
    command: "npx"
    args: ["-y", "@pondlog/mcp-mushroomobserver"]
// mcp.json
{
  "mcpServers": {
    "andrewschristison-pondlog-mushroomobserver": {
      "command": "npx",
      "args": [
        "-y",
        "@pondlog/mcp-mushroomobserver"
      ]
    }
  }
}
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.

  • 3 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

  • 2 Aug 26 +49
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Malware scan: unverified → pass security
    • Install scripts: unverified → pass security
    • MCP protocol: unverified → pass functional
    • Stability: unverified → 0.23 functional
    • Schema quality: unverified → excellent functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • License: unverified → pass functional
    • Licence: MIT functional
  • 1 Aug 26 −6
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 31 Jul 26 −18
    • Malware scan: pass → unverified security
  • 27 Jul 26 41

    First indexed and scored.

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 — 5 exposed · ~1,824 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_observation ~105

Returns one observation in high detail: nested location with bounding box, consensus taxon, all proposed namings with their per-naming confidence and votes, observer, primary image and full image set, and comments. Use after `search_observations` or `get_recent_fungi` returns an id of interest.

NameTypeReqDescription
idintegeryesMushroom Observer observation id (positive integer). The numeric segment of an MO URL like https://mushroomobserver.org/187521.

No output schema declared.

No examples provided.

get_recent_fungi ~502

Place-aware shortcut: 'what fungi have been observed near here in the last N days?' Provide either bbox (lat+lng+radius_km) OR an MO region suffix string. Returns observations sorted by date with consensus name, confidence score, location, and photo URL. This is the recommended starting tool for any 'what's fruiting?' question. Pages through MO results internally to fill the requested limit. For taxonomy lookup use `search_fungal_names`. For a single record's full detail use `get_observation`. For richer filtering (taxon name, date range) use `search_observations`.

NameTypeReqDescription
confidence_minnumberMinimum vote-weighted ID confidence in [-3..3]. MO observations carry consensus confidence aggregated from votes by mycology experts and citizen scientists. 1.0+ is a reasonable threshold to filter o…
daysintegerTime window in days, counted backwards from today. Default 30. Fungi fruit seasonally, values around 30–90 days surface 'currently fruiting' species; longer windows (180–365) build a year-round portr…
latnumberWGS84 latitude in decimal degrees, between -90 and 90. Example: 48.118 for Port Angeles, WA.
limitintegerMaximum number of observations to return. Default 50, max 200. The server pages through MO results internally up to 5 pages.
lngnumberWGS84 longitude in decimal degrees, between -180 and 180. Example: -123.4307 for Port Angeles, WA.
radius_kmnumberSearch radius in kilometers. Maximum 500. Default 25. Mushroom Observer is densest in the Pacific Northwest, Northern California, the Northeast US, and Western Europe; use 50–100 km for coverage in s…
regionstringMushroom Observer region suffix string. MO models geography as comma-separated location names ending in country (e.g. 'Clallam Co., Washington, USA', 'Marin Co., California, USA', 'Sussex, England, U…

No output schema declared.

No examples provided.

search_fungal_names ~288

Search Mushroom Observer's fungal taxonomy by substring. Returns scientific names with author citation, taxonomic rank, full classification (kingdom › phylum › class › order › family), deprecation status, and a link to the MO name page. Use this to translate vernacular interest ('chanterelles') into MO scientific names ('Cantharellus'), to disambiguate between species in a genus, or to confirm whether a name is current vs. deprecated. Mushroom Observer's name index covers 100,000+ fungal names including many synonyms and historical combinations.

NameTypeReqDescription
include_subtaxabooleanIf true, include observations of subtaxa under the queried name (e.g. all species in a genus). Default false.
pageinteger1-indexed page number. MO returns ~100 records per page. Default 1.
querystringSubstring search against MO's scientific-name index (uses MO's `text_name_has` filter). Examples: 'Cantharellus' (the chanterelle genus), 'Amanita muscaria' (the species), 'Boletales' (an order). Cas…
rankstringTaxonomic rank filter for `search_fungal_names`. Most fungi searches care about Genus, Species, Family, or Order. MO's full set is exposed.

No output schema declared.

No examples provided.

search_observations ~680

Searches Mushroom Observer, the world's largest dedicated mycology platform with 500,000+ observations and expert-weighted identification confidence scores. Returns matching fungal observations with consensus name, vote-weighted ID confidence (-3..3), date, location name, photo URL when available, and notes. AT LEAST ONE narrowing filter is required: bbox (lat+lng+radius_km), region suffix, taxon name, or date range. Unbounded queries can return tens of MB. For a simple 'what's fruiting near me lately?' query prefer `get_recent_fungi`. For a single observation by id prefer `get_observation`. MO is densest in the Pacific Northwest, Northern California, the Northeastern US, and Western Europe.

NameTypeReqDescription
confidence_minnumberMinimum vote-weighted ID confidence in [-3..3]. MO observations carry consensus confidence aggregated from votes by mycology experts and citizen scientists. 1.0+ is a reasonable threshold to filter o…
date_fromstringInclusive lower bound on observation date in YYYY-MM-DD format. Example: '2025-09-01'.
date_tostringInclusive upper bound on observation date in YYYY-MM-DD format. Example: '2025-12-01'.
detailstringDetail level. 'low' (default) returns flat IDs (~1KB/record); 'high' returns nested location/consensus/owner/images objects (~3-4KB/record). Use 'high' only when needed.
has_imagesbooleanIf true, only return observations that have at least one photo. Useful for visual ID workflows.
include_subtaxabooleanIf true, include observations of subtaxa under the queried name (e.g. all species in a genus). Default false.
latnumberWGS84 latitude in decimal degrees, between -90 and 90. Example: 48.118 for Port Angeles, WA.
lngnumberWGS84 longitude in decimal degrees, between -180 and 180. Example: -123.4307 for Port Angeles, WA.
namestringFilter by consensus taxon name (substring match against MO's scientific name index). Examples: 'Amanita', 'Cantharellus formosus', 'Boletales'.
pageinteger1-indexed page number. MO returns ~100 records per page. Default 1.
radius_kmnumberSearch radius in kilometers. Maximum 500. Default 25. Mushroom Observer is densest in the Pacific Northwest, Northern California, the Northeast US, and Western Europe; use 50–100 km for coverage in s…
regionstringMushroom Observer region suffix string. MO models geography as comma-separated location names ending in country (e.g. 'Clallam Co., Washington, USA', 'Marin Co., California, USA', 'Sussex, England, U…

No output schema declared.

No examples provided.

search_regions ~249

Mushroom Observer's geography is a flat list of comma-separated location names ending in a country (e.g. 'Cape Alava Trail, Olympic National Park, Clallam Co., Washington, USA'). MO's `/locations` endpoint has NO name filter, so this tool runs an observations search with the suffix and harvests unique location-name strings from the results, with per-name observation counts. Use to discover well-formed region suffixes before calling `search_observations` or `get_recent_fungi` with a `region` filter. Try broad-to-narrow: 'Washington, USA' → 'Clallam Co., Washington, USA' → 'Olympic National Park, Clallam Co., Washington, USA'.

NameTypeReqDescription
max_pagesintegerMaximum pages of observations to scan when discovering region suffixes. Default 2. MO returns ~100 obs/page; the tool aggregates unique location names across the scanned pages.
querystringyesSuffix string to match observation locations against. The result includes only unique location_name values that END WITH this string. Examples: 'California, USA', 'Sussex, England, UK', 'Marin Co., C…

No output schema declared.

No examples provided.