io.github.andrewschristison/pondlog-usgs

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

USGS Water Services MCP server. Real-time streamflow, gage height, and site metadata from NWIS.

Available components

+25 this week 68 68 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 Usability69

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 1003 tokens (~250/item across 4 items; 4 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-usgs

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# add to Codex CLI

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

// opencode.json

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

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.json

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

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
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Licence: MIT functional
1 Aug 26 −7
- 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 +1
- Malware scan: pass → unverified ▼ security
- Tool coverage: unverified → 100 ▲ functional
30 Jul 26 −19
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
27 Jul 26 43

First indexed and scored.

Show 3 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 · 95 deprecated · 29 stale.

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

MCP tools — 4 exposed · ~1,003 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_daily_values Daily USGS Streamflow Statistics (Current or Historic) ~278

Daily statistics (default: mean) for one or more USGS gauges. Use this for any query that crosses days or asks about historic dates. Pass either `period` (relative-to-now) OR `start_date`/`end_date` (historic range), not both. For real-time sub-hour resolution prefer `get_instantaneous_values`. Returns one daily value per (site × parameter × statistic × day). USGS quality codes: 'A' = approved, 'P' = provisional.

Input Output Examples

Name	Type	Req	Description
end_date	—	—	Historic range end (YYYY-MM-DD). Defaults to today when start_date is set.
parameter_codes	array	—	5-digit parameter codes. Defaults to ['00060'] (discharge mean).
period	string	—	Relative window ending now. Examples: 'P7D', 'P30D', 'P1Y'. Mutually exclusive with start_date/end_date.
sites	array	yes	Array of USGS site numbers. Single-site queries are typical.
start_date	string	—	Historic range start (YYYY-MM-DD). Pair with end_date for an explicit window.
statistic_codes	array	—	USGS statistic codes, '00003' = mean (default), '00001' = max, '00002' = min, '00008' = median.

No output schema declared.

No examples provided.

get_instantaneous_values Real-Time USGS Streamflow / Gage Height ~241

Real-time readings (typically 15-minute cadence) from a USGS gauge. Returns one or more time series, by default discharge (00060, ft³/s) and gage height (00065, ft), over a relative period ending now. Use this to answer 'what is the river doing right now?'. USGS rejects historic dates on this endpoint; for past data use `get_daily_values` with start_date/end_date instead. For a 'what gauges exist near here?' first-step query use `search_sites`.

Input Output Examples

Name	Type	Req	Description
parameter_codes	array	—	Specific 5-digit parameter codes to retrieve. Defaults to ['00060', '00065'] (discharge + gage height). Pass ['00010'] for water temperature, etc.
period	string	—	Relative time window ending now. Default 'PT2H' (past 2 hours, returns ~8 readings at 15-minute cadence). 'P1D' returns ~96 readings.
sites	array	yes	Array of USGS site numbers to fetch in one call. Most queries pass a single site, but the API supports batched fetches.

No output schema declared.

No examples provided.

get_site_info USGS Gauge Site Metadata ~150

Returns metadata for a single USGS gauging station: official name, coordinates, site type (stream/lake/groundwater/etc.), hydrologic unit (HUC), state/county codes, and gauge altitude. Use after `search_sites` finds candidate gauges, or to confirm a site number returned in someone's data.

Input Output Examples

Name	Type	Req	Description
site_number	string	yes	USGS site number, 8 to 15 digits identifying a single gauging station. Examples: '12045500' (Elwha River at McDonald Bridge near Port Angeles, WA); '12048000' (Dungeness River near Sequim, WA). Use `…

No output schema declared.

No examples provided.

search_sites Find USGS Gauge Sites Near a Location ~334

Find active USGS stream-gauge sites by either (a) latitude/longitude/radius_km, or (b) US state postal code. Returns site numbers, names, coordinates, HUC, and altitude, feed the resulting site numbers into `get_instantaneous_values` or `get_daily_values`. Defaults filter to surface-water streams (siteType=ST) with real-time data (hasDataTypeCd=iv); pass site_type/has_data_type to override. Pass either lat+lng+radius_km OR state_code; the lat/lng path is preferred for place-aware queries.

Input Output Examples

Name	Type	Req	Description
has_data_type	string	—	Restrict to sites that publish the given data type: 'iv' = instantaneous (real-time, default), 'dv' = daily values, 'qw' = water quality, 'gw' = groundwater levels.
lat	number	—	Latitude of the search center. Required if state_code is not provided.
lng	number	—	Longitude of the search center. Required if state_code is not provided.
radius_km	number	—	Search radius in km around (lat, lng). Default 25.
site_type	string	—	USGS site type code: 'ST' = stream (default), 'LK' = lake, 'GW' = groundwater, 'AT' = atmosphere, 'ES' = estuary. Full list: https://help.waterdata.usgs.gov/site_tp_cd
state_code	string	—	US two-letter state code. Mutually exclusive with lat/lng. Returns ALL active stream gauges in the state.

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