io.github.cyanheads/usgs-water-mcp-server

Est-ce que io.github.cyanheads/usgs-water-mcp-server est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.cyanheads/usgs-water-mcp-server » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 8 outils

• water_dataframe_describe≈ 909 tokens

  List tables and columns staged on a DataCanvas by water_get_series or water_find_sites. Call this after water_get_series or water_find_sites returns a canvas_id to discover the exact table name and column types before writing a query. Then pass the table name to water_dataframe_query, or to water_dataframe_drop (when this server enables it) to remove a table you no longer need. Requires DataCanvas to be enabled on this server instance. Returns an error if DataCanvas is not available.

  Paramètres, retour & exemple (1)

  Paramètres

  • canvas_id · string · requis
    Canvas ID returned by water_get_series or water_find_sites. Identifies the canvas to describe.

  Exemple d'appel

  {"name": "water_dataframe_describe", "arguments": {"canvas_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "tables": [], "canvas_id": "texte"}}

• water_dataframe_query≈ 1198 tokens

  Run a read-only SQL SELECT against water data tables staged on a DataCanvas by water_get_series or water_find_sites. Workflow: run water_get_series or water_find_sites (get canvas_id + table_name) → water_dataframe_describe (confirm the table and its columns) → water_dataframe_query (SQL analysis), then optionally water_dataframe_drop (when this server enables it) to remove a table you are done with. Only SELECT statements are permitted. At most 10,000 rows are returned; a query matching more is capped and the response sets truncated=true — scope with WHERE/LIMIT, and use SELECT COUNT(*) or water_dataframe_describe to learn the true match count. Requires DataCanvas to be enabled on this server instance. Returns an error if DataCanvas is not available.

  Paramètres, retour & exemple (2)

  Paramètres

  • sql · string · requis
    Read-only SELECT statement. Reference the table by the table_name from water_get_series or water_find_sites; columns vary by source table, so run water_dataframe_describe first for the exact schema. Example: SELECT date_time, value FROM water_series_01646500_00060 ORDER BY date_time DESC LIMIT 10
  • canvas_id · string · requis
    Canvas ID returned by water_get_series or water_find_sites. Identifies the canvas holding the data.

  Exemple d'appel

  {"name": "water_dataframe_query", "arguments": {"sql": "texte", "canvas_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "error": {}, "row_count": 1, "truncated": true}}

• water_find_sites≈ 3021 tokens

  Find USGS water monitoring sites by bounding box, state, county, or HUC watershed code, filtered by site type and parameter availability. Returns site numbers, names, coordinates, types, altitude, and (in expanded mode) drainage area. Call this first — water_get_readings, water_get_series, and water_get_conditions all require a site number. Supply exactly one major filter — bbox, stateCd, countyCd, or huc; siteType, parameterCd, and hasDataTypeCd only narrow within it and cannot stand alone. Page through matches with limit/offset (500 per page); truncated=true means matches remain after the returned window and upstreamTotal holds the full count. When the match set exceeds 500 and DataCanvas is enabled, the complete set also stages to a canvas (canvas_id/table_name) — inspect it with water_dataframe_describe, then retrieve it with water_dataframe_query.

  Paramètres, retour & exemple (11)

  Paramètres

  • huc · string · optionnel
    Hydrologic Unit Code (HUC) scoping results to a watershed. Either a 2-digit major HUC (e.g. "02" for the Mid-Atlantic region) or an 8-digit minor HUC (e.g. "02070008" for the Middle Potomac). NWIS accepts no other lengths. Major filter — supply exactly one of bbox, stateCd, countyCd, huc.
  • bbox · string · optionnel
    Bounding box as "west,south,east,north" in decimal degrees (e.g. "-77.5,38.5,-76.5,39.5" for the DC metro area). One of the four major filters — bbox, stateCd, countyCd, and huc are mutually exclusive with each other, and exactly one must be supplied.
  • limit · integer · optionnel
    Maximum sites to return inline, 1–500. Default 500 (the inline cap).
  • offset · integer · optionnel
    Number of matching sites to skip before returning results. Page through matches beyond the inline cap by advancing offset by limit. Default 0.
  • stateCd · string · optionnel
    2-character US state abbreviation (e.g. "VA", "WA"). Returns all sites in the state for the given filters. Major filter — supply exactly one of bbox, stateCd, countyCd, huc.
  • countyCd · string · optionnel
    FIPS county code(s) as bare 5-digit numbers — state and county digits concatenated, no separator (e.g. "51013" for Arlington, VA). Comma-separate up to 20 (e.g. "51059,51061"). The 5 digits already encode the state, so the code stands alone. Major filter — supply exactly one of bbox, stateCd, countyCd, huc.
  • siteType · string · optionnel
    Site type filter. Common codes: "ST" (stream), "GW" (groundwater well), "LK" (lake/reservoir), "SP" (spring), "AT" (atmosphere), "OC" (ocean), "ES" (estuary). Comma-separate multiple types (e.g. "ST,GW").
  • canvas_id · string · optionnel
    Canvas ID from a prior call to add this match set as a table on an existing canvas rather than creating a new one. Each distinct filter set gets its own table name, so re-running the identical query replaces its own table while a different query adds another alongside it. Applies only when the match set exceeds the inline cap and DataCanvas is enabled. Omit to start a fresh canvas.
  • siteOutput · string · optionnel · basic | expanded
    "basic" returns core identification fields. "expanded" adds drainage area, altitude, contributing area, and other metadata.
  • parameterCd · string · optionnel
    5-digit parameter code to require at each returned site (e.g. "00060" for discharge). Use water_list_parameters to discover codes. Comma-separate multiple codes with no spaces (e.g. "00060,00065").
  • hasDataTypeCd · string · optionnel
    Require sites with data of this type. Common values: "iv" (real-time/instantaneous), "dv" (daily values), "gw" (groundwater). Comma-separate multiple types.

  Exemple d'appel

  {"name": "water_find_sites", "arguments": {"huc": "texte", "bbox": "texte", "limit": 1, "offset": 1, "stateCd": "texte", "countyCd": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "sites": [], "total": 1, "notice": "texte", "filters": {}, "canvas_id": "texte", "truncated": true, "table_name": "texte", "upstreamTotal": 1}}

• water_get_conditions≈ 2847 tokens

  Get a USGS site's current reading ranked against its full period-of-record daily-mean percentiles for the same calendar day — a "how unusual is this" percentileClass (record-high to record-low), not a flood-stage or drought determination (this tool fetches no authoritative thresholds). The reading is instantaneous but the percentiles are daily-mean, so the ranking is approximate (see historicalContext.comparisonBasis). When the record is too short to rank, returns the reading with historicalContext=null instead of an error. A reading NWIS reports as no data (a seasonal, discontinued, dry, or malfunctioning gage) returns an empty currentValue with the qualifiers naming why, and is not ranked. When the site measures the parameter with several sensors (methods), one reading is used and named by methodId/methodDescription — from the sensor its percentile series is described as when one is, otherwise the most recent across them; water_get_readings lists every method. Use water_find_sites and water_list_parameters to resolve inputs.

  Paramètres, retour & exemple (2)

  Paramètres

  • site · string · requis
    USGS site number (8–15 digits, e.g. "01646500" for Potomac River at Little Falls). Use water_find_sites to discover valid site numbers.
  • parameterCd · string · requis
    5-digit USGS parameter code (e.g. "00060" for discharge, "00065" for gage height). Use water_list_parameters to discover codes.

  Exemple d'appel

  {"name": "water_get_conditions", "arguments": {"site": "texte", "parameterCd": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"note": "texte", "error": {}, "methodId": "texte", "siteName": "texte", "unitCode": "texte", "qualifiers": [], "siteNumber": "texte", "parameterCd": "texte", "currentValue": "texte", "parameterName": "texte", "currentDateTime": "texte", "historicalContext": "texte"}}

• water_get_readings≈ 2332 tokens

  Get the latest instantaneous (~15-min, real-time) values for up to 100 USGS sites in one call — per-site, per-parameter records with timestamp, value, unit, and provisional/approved qualifiers. Omitting parameterCd returns every parameter each site publishes. A site measuring one parameter with several sensors returns one series per method, each named by methodId and methodDescription. At most 100 series return per call — every site that returned data keeps at least one, and totalSeries reports how many NWIS returned; pass parameterCd or split the sites across calls to reach the rest. Each series returns only its 10 most recent records (totalValues reports the true count); truncated=true when either cap applied. Use water_get_series for a full date-range series. Sites NWIS returns nothing for are listed in missingSites, not dropped silently. Use water_find_sites first to discover site numbers and available parameters.

  Paramètres, retour & exemple (3)

  Paramètres

  • sites · array · requis
    One or more USGS site numbers to query. Maximum 100 per call.
  • period · string · optionnel
    ISO 8601 duration for the lookback period (e.g. "PT2H" = last 2 hours, "P1D" = last 1 day, "P7D" = last 7 days). Default: "PT2H" (last 2 hours of readings). Widening it raises totalValues, but each series still returns only its 10 most recent records — use water_get_series to retrieve a full series.
  • parameterCd · array · optionnel
    Parameter codes to return. Omit to get every parameter each site publishes — one series per site, parameter, and method, so a large batch can exceed the 100-series cap. Use water_list_parameters to discover codes.

  Exemple d'appel

  {"name": "water_get_readings", "arguments": {"sites": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "query": {}, "total": 1, "readings": [], "truncated": true, "totalSeries": 1, "missingSites": []}}

• water_get_series≈ 3138 tokens

  Get a daily or instantaneous time series for one USGS site and parameter over a date range, as time-ordered value records. NWIS can hold several series for one query — one per daily statistic (mean, maximum, minimum) and one per sensor (method); this returns one, reporting its statCd and methodId, and lists the rest in otherSeries so any can be re-requested with the statCd and methodId inputs. By default it returns the daily mean when NWIS returns one with values, and the method with the most records. Large sets (>500 records) return the most recent records inline with truncated=true — the last 500 without DataCanvas, and with DataCanvas enabled the complete series also spills to a canvas (canvas_id/table_name): inspect the staged table with water_dataframe_describe, then read the full series with water_dataframe_query. Use water_find_sites and water_list_parameters to resolve inputs.

  Paramètres, retour & exemple (8)

  Paramètres

  • site · string · requis
    USGS site number (8–15 digits, e.g. "01646500" for Potomac River at Little Falls). Use water_find_sites to discover valid site numbers.
  • statCd · string · optionnel
    Daily statistic to return, as a 5-digit NWIS code: "00003" mean, "00001" maximum, "00002" minimum. Omit for the mean when NWIS returns one with values, otherwise the first statistic that has values; the response names the one returned and lists the others in otherSeries. Daily series only — instantaneous values carry just "00000".
  • endDate · string · requis
    End date in YYYY-MM-DD format (e.g. "2024-12-31").
  • methodId · string · optionnel
    NWIS method ID of the sensor series to return — the methodId or an otherSeries[].methodId from a prior response for the same site, parameter, and seriesType. Omit for the method with the most records. IDs differ between daily and instantaneous series and between daily statistics.
  • canvas_id · string · optionnel
    Canvas ID from a prior call to add this series as a table on an existing canvas rather than creating a new one. Each distinct site, parameter code, series type, date range, and selected statistic and method gets its own table name, so re-running the identical query replaces its own table while a different query adds another alongside it. Applies only when the series spills to a canvas. Omit to start a fresh canvas.
  • startDate · string · requis
    Start date in YYYY-MM-DD format (e.g. "2024-01-01").
  • seriesType · string · optionnel · daily | instantaneous
    "daily" returns one value per day (DV service, typically mean/max/min). "instantaneous" returns ~15-minute readings (IV service). Default: "daily". Use "instantaneous" for high-resolution analysis.
  • parameterCd · string · requis
    A single 5-digit USGS parameter code (e.g. "00060" for discharge, "00065" for gage height). One code per call — this tool returns one series. Use water_list_parameters to discover available codes.

  Exemple d'appel

  {"name": "water_get_series", "arguments": {"site": "texte", "endDate": "texte", "startDate": "texte", "parameterCd": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "query": {}, "notice": "texte", "statCd": "texte", "values": [], "methodId": "texte", "siteName": "texte", "statName": "texte", "unitCode": "texte", "canvas_id": "texte", "truncated": true, "seriesType": "daily"}}

• water_get_site_data_catalog≈ 1422 tokens

  Discover a USGS site’s parameters, sensors, statistics, and UTC record bounds before calling water_get_series. Find site numbers with water_find_sites. Each row is a distinct series; metadata bounds may contain gaps and lag observations. For water_get_series, take YYYY-MM-DD from beginDate/endDate, pass statCd only for daily rows, and obtain methodId from a water_get_series response; timeSeriesId is an OGC identifier, never an NWIS methodId. Rows with null seriesType are other computations and cannot be requested with water_get_series. Follow nextCursor with the same filters and limit until null.

  Paramètres, retour & exemple (5)

  Paramètres

  • site · string · requis
    USGS site number (8–15 digits), from water_find_sites; e.g. "01646500".
  • limit · integer · optionnel
    Maximum metadata rows per page (1–1000; default 100). Keep unchanged when using cursor.
  • cursor · string · optionnel
    Opaque nextCursor from the previous page; keep site, parameterCd, seriesType, and limit unchanged.
  • seriesType · string · optionnel · daily | instantaneous
    Limit to Daily computations or Points/Instantaneous computations. Omit to include all periods.
  • parameterCd · string · optionnel
    Optional 5-digit parameter code from water_list_parameters, e.g. "00060".

  Exemple d'appel

  {"name": "water_get_site_data_catalog", "arguments": {"site": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "series": [], "siteName": "texte", "nextCursor": "texte", "siteNumber": "texte"}}

• water_list_parameters≈ 1329 tokens

  Look up USGS parameter codes — the 5-digit codes every other tool's parameterCd takes. With no query, lists a curated set of well-known codes with names, units, and thematic group, from a built-in table (no network call): 00060 = "Discharge" (ft³/s), 00065 = "Gage height" (ft), 00010 = "Temperature, water" (°C), 72019 = "Depth to water level" (ft), and others; filter it with group. For anything else — turbidity, nitrate, chlorophyll, suspended sediment, salinity — pass query to search the full USGS parameter-code catalog (~19,600 codes) by name and description, or pass a 5-digit code to look it up. A query returns at most 25 entries, matching curated codes first, with total counting every match.

  Paramètres, retour & exemple (2)

  Paramètres

  • group · string · optionnel · streamflow | groundwater | temperature | meteorological | water-quality | all
    Filter the curated list by thematic domain: "streamflow", "groundwater", "temperature", "meteorological", "water-quality", or "all" (default). Applies to the curated list only — leave it "all" when passing query.
  • query · string · optionnel
    Search the full USGS parameter-code catalog. Case-insensitive; every word must start a word in the parameter name or description (e.g. "turbidity", "nitrate filtered", "dissolved oxygen"). A bare 5-digit code (e.g. "63680") returns that code. Omit to list the curated codes.

  Exemple d'appel

  {"name": "water_list_parameters", "arguments": {"group": "streamflow", "query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"note": "texte", "error": {}, "query": "texte", "total": 1, "truncated": true, "parameters": []}}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://usgs-water.caseyjhand.com/mcp