Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Usgs Water MCP Server

de cyanheadsversión 0.6.0i★ 3iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.cyanheads/usgs-water-mcp-server

Cómo instalar

What it does

Query real-time and historical USGS water data from ~8,000 stream gages and groundwater wells.

  • Connects Computadora o nube
  • Account or key No key needed
  • Category Otros

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad16/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso36/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: 12 (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Usgs Water MCP Server. Sigue https://mcp.popnx.com/i/cyanheads-usgs-water-mcp-server.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (usgs-water.caseyjhand.com) · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreUsgs Water MCP Server
    Remote MCP server URL · Direcciónhttps://usgs-water.caseyjhand.com/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsUsgs Water MCP Server

  4. Pruébalo

    Usa Usgs Water MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Usgs Water MCP Server o muestra una herramienta de Usgs Water MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreUsgs Water MCP Server
    Connection · Direcciónhttps://usgs-water.caseyjhand.com/mcp
  3. Elige Usgs Water MCP Server en un chat

    Abre un chat nuevo y elige Usgs Water MCP Server en tus plugins antes de escribir

  4. Pruébalo

    Usa Usgs Water MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Usgs Water MCP Server o muestra una herramienta de Usgs Water MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user usgs-water https://usgs-water.caseyjhand.com/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver Usgs Water MCP Server en la lista como conectado

  4. Pruébalo

    Usa Usgs Water MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Usgs Water MCP Server o muestra una herramienta de Usgs Water MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Usgs Water MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Usgs Water MCP Server o muestra una herramienta de Usgs Water MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Usgs Water MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Usgs Water MCP Server o muestra una herramienta de Usgs Water MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://usgs-water.caseyjhand.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Usgs Water MCP Server💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user usgs-water https://usgs-water.caseyjhand.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "usgs-water": {
      "url": "https://usgs-water.caseyjhand.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "usgs-water": {
      "type": "http",
      "url": "https://usgs-water.caseyjhand.com/mcp"
    }
  }
}

Instalado en tu computadora

Claude Code

claude mcp add --scope user usgs-water -- npx -y @cyanheads/usgs-water-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "usgs-water": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usgs-water-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "usgs-water": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usgs-water-mcp-server"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "usgs-water": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usgs-water-mcp-server"
      ]
    }
  }
}

Valores que debes completar

  • USGS_USER_AGENT env
    Cadena User-Agent personalizada para las solicitudes a la API de datos de agua de USGS. El valor predeterminado es un identificador descriptivo que incluye la URL del repositorio.
    Ver original en inglésCustom User-Agent string for USGS Water Data API requests. Defaults to a descriptive identifier including the repo URL.
  • USGS_REQUEST_TIMEOUT_MS env
    Tiempo de espera de las solicitudes HTTP en milisegundos para cada solicitud a la API de datos de agua de USGS. Cada llamada a una herramienta también tiene un plazo compartido de 45 segundos entre sus solicitudes y reintentos. Predeterminado: 30000.
    Ver original en inglésHTTP request timeout in milliseconds for each USGS Water Data API request. Every tool call also has a shared 45-second deadline across its requests and retries. Default: 30000.
  • USGS_API_KEY secreto env
    Clave api.data.gov opcional para las API de datos de agua de USGS, enviada en la cabecera X-Api-Key. Sin ella, las solicitudes comparten el límite anónimo por IP por hora (1.000 solicitudes en las colecciones OGC).
    Ver original en inglésOptional api.data.gov key for the USGS Water Data APIs, sent as the X-Api-Key header. Without one, requests share the anonymous per-IP hourly limit (1,000 requests on the OGC collections); a shared o…
  • WATER_DATAFRAME_DROP_ENABLED env
    Establézcalo en true para permitir llamar a water_dataframe_drop, que elimina una tabla preparada de un DataCanvas. Desactivado por defecto, lo que muestra la herramienta como deshabilitada. Requiere CANVAS_PROVIDER_TYPE=duckdb para tener algún efecto.
    Ver original en inglésSet to true to make water_dataframe_drop callable — it removes one staged table from a DataCanvas. Off by default, which lists the tool as disabled. Needs CANVAS_PROVIDER_TYPE=duckdb to have anything…
  • MCP_LOG_LEVEL env
    Establece el nivel mínimo de registro para la salida (p. ej., 'debug', 'info', 'warn').
    Ver original en inglésSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
420/sem
Licenciai
Apache-2.0
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.6.0
Categoríai
Otros
Publicado en el registroi
11 nov 2026
Último cambio de códigoi
13 nov 2026
Última revisión
18 nov 2026
Creador
cyanheads
Paquetes
npm: @cyanheads/usgs-water-mcp-server
npm: @cyanheads/usgs-water-mcp-server
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 18 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • water_list_parameters

    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), 0

  • water_find_sites

    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, the UTC time each site last reported (lastObservedAt), and (in expanded mode) drain

  • water_get_readings

    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

  • water_get_series

    Get a daily or instantaneous time series for one USGS site and parameter over a date range, as time-ordered value records. A site can hold several series for one query — one per daily statistic (mean, maximum, minimum) and one per sensor (method); this returns one, reporting its

  • water_get_site_data_catalog

    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

  • water_get_conditions

    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 thresh

  • water_dataframe_query

    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_qu

  • water_dataframe_describe

    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_q

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub cyanheads, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 6 días

  • ✓ Superada

    Tiene licencia

    Usa Apache-2.0

  • ✓ Superada

    El endpoint responde

    Respondió en 215 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 8 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

La dirección en la nube respondió 4 de las últimas 4 comprobaciones · última 215 ms · revisado 18 nov 2026

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para @cyanheads/usgs-water-mcp-server@0.6.0

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cyanheads-usgs-water-mcp-server.svg)](https://mcp.popnx.com/en/servers/cyanheads-usgs-water-mcp-server)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Otrosi

  • Más estrellas que el 93% de los otros 20653 servidores de esta categoría
  • Publicado en el registro más recientemente que el 86% de los otros 20653 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 20653 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Usgs Water MCP Server?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 días, y la última versión (0.6.0) llegó al registro hace 8 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

de koala73Muy usado★ 90,9 milActualizado hace 3 días

Se ejecuta en la nube✓ del servicio · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

de openstatusHQMuy usado★ 9,3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

de JanDeDobbeleerMuy usado★ 23,8 mil Estrellas de todo el repositorioActualizado hace 30 días

Se ejecuta en la nube✓ del servicio · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

de Klavis-AIEn crecimiento★ 5,8 milActualizado hace 14 meses

Se ejecuta en la nubeRepo archivado✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

de jitsucomMuy usado★ 5,1 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · jitsu.com
Comparado con otros parecidos
Este
Usgs Water MCP Server
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas5/54/44/44/41/44/4
LicenciaApache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

@cyanheads/usgs-water-mcp-server Query real-time and historical water data from ~8,000 USGS stream gages and groundwater wells via MCP. STDIO or Streamable HTTP. 9 Tools • 2 Resources

Public Hosted Server: https://usgs-water.caseyjhand.com/mcp


Overview

Real-time and historical water data from ~8,000 active USGS stream gages and groundwater wells across the US and territories. Find monitoring sites, pull the latest readings or a historical series, and see how today's flow compares with decades of records.

Tools
ToolDescription
water_list_parametersList well-known USGS parameter codes with names, units, and domain (no network call), or search the full ~19,600-code USGS catalog by name or description.
water_find_sitesFind USGS monitoring sites by bounding box, state, county, or HUC watershed. Filter by site type, parameter availability, and recency; each row reports when the site last reported. Large match sets spill to DataCanvas.
water_get_readingsGet the latest instantaneous values (~15 min real-time) for up to 100 USGS sites.
water_get_seriesGet a time series of daily or instantaneous values for a site over a date range. Large ranges spill to DataCanvas.
water_get_site_data_catalogDiscover a site's parameters, sensors, statistics, and full UTC record bounds, with cursor pagination.
water_get_conditionsGet current hydrologic conditions ranked against the full period-of-record percentile statistics.
water_dataframe_describeList tables and columns staged on a DataCanvas by water_get_series or water_find_sites.
water_dataframe_queryRun a read-only SQL SELECT against the time-series and site tables staged by water_get_series and water_find_sites.
water_dataframe_dropDrop one staged table from a DataCanvas, leaving the canvas and its other tables in place. Opt-in via WATER_DATAFRAME_DROP_ENABLED.
Resources
ResourceDescription
usgs-water://site/{siteId}Site metadata: name, coordinates, type, HUC, state, county, drainage area, and altitude
usgs-water://parametersCurated well-known parameter codes (the list water_list_parameters returns without a query)

All resource data is also reachable via tools. Use water_find_sites for geographic site discovery.

Skill
SkillDescription
usgs-water-guideGates and workflows for agents calling the tools: telling live gages from discontinued ones, reading depth-to-water rankings (a shallower depth ranks higher), finding the parameter code a site reports, time zones and data lag, and SQL over staged series

Ships in skills/ for plugin installs, the npm package, the Docker image, and the .mcpb bundle, and is served over MCP as skill://usgs-water-guide/SKILL.md.

Capability reference

water_list_parameters tool
  • Without query: the curated, built-in list — no network call — of codes like 00060 (Discharge, ft³/s), 00065 (Gage height, ft), and 72019 (Depth to water level, ft), filtered by group (streamflow, groundwater, temperature, meteorological, water-quality, or all, the default)
  • With query: searches the full ~19,600-code USGS catalog by name or description (a bare 5-digit code returns that code) and returns at most 25 entries, each naming its source (curated or usgs-catalog), with total and truncated covering the full match set. query can't be combined with a group other than all
  • The catalog is fetched on the first query and cached for 24 hours; a failed fetch fails as a retryable upstream_error

water_find_sites tool
  • Exactly one geographic scope per call — bbox ("west,south,east,north"), 2-letter stateCd, up to 20 comma-separated 5-digit FIPS countyCd codes, or a 2- or 8-digit huc — narrowed by siteType (ST, GW, LK, SP, …), parameterCd, hasDataTypeCd (iv with aliases uv and rt, dv, gw, pk; no other code has a source), and observedWithin (an ISO 8601 duration). A bbox has no area cap. A missing or doubled scope fails as missing_major_filter / conflicting_major_filters before any request
  • Every row carries lastObservedAt, the UTC time of the site's newest observation among the series the filters select (null when it has none, or none with a recorded time), read from the latest-value collections without a request per site. parameterCd and hasDataTypeCd match sites that have ever reported, discontinued ones included, and never discrete water-quality samples; observedWithin keeps only sites whose lastObservedAt falls inside the window
  • limit (1–500, default 500) and offset page through the match set, with truncated and upstreamTotal describing what lies outside the window; siteOutput: expanded adds state and county FIPS codes, drainage area, and contributing area
  • With CANVAS_PROVIDER_TYPE=duckdb, a match set over 500 sites also stages in full to a canvas (canvas_id / table_name) for water_dataframe_query

water_get_readings tool
  • Up to 100 sites per call, an optional parameterCd filter, and a period lookback (ISO 8601, default PT2H, at most 1,100 days); returns one series per site, parameter, and sensor (methodId is the series' time-series ID, the timeSeriesId the site data catalog lists; methodDescription names the sensor), capped at 100 series per call (kept round-robin across sites) and the 10 most recent records per series, with totalSeries, totalValues, and truncated reporting what the caps held back
  • A sensor that reported nothing in the period still returns, with totalValues: 0, an all-dormant batch included; sites with no series at all are named in missingSites, and no_data_for_parameter fires only when no requested site returns a series
  • Every value carries its qualifier codes (P provisional, A approved, plus codes such as e, Ssn, Dis; a qualifier with no code passes through as the upstream word, e.g. OTHERAGENCY). Timestamps are site-local with the UTC offset, or UTC (+00:00) for a site with no known time zone

water_get_series tool
  • One site and parameterCd per call over a startDate–endDate range; seriesType is daily (one value per day, the default) or instantaneous (~15 min). The most recent 500 records return inline, with totalRecords and truncated reporting the rest
  • Returns one named series — by default the daily mean and the sensor series with the most records, a tie going to the site's default sensor over a labeled one and then to the series that began first; statCd (00003 mean, 00001 maximum, 00002 minimum; daily only) and methodId (a series' time-series ID, 32 hexadecimal characters) select another, and otherSeries lists every alternative, empty ones included, with its record count. An instantaneous range of any length is read in full up to today on the site's clock, in 366-day chunks; for a parameter the site lists no series of, only the last 366 days are read, in one request
  • With CANVAS_PROVIDER_TYPE=duckdb, a range over 500 records spills the complete series to a canvas (canvas_id / table_name); pass a prior canvas_id to add the table to an existing canvas

water_get_site_data_catalog tool
  • One site, optional parameterCd and seriesType, and limit (1–1000; default 100). Reuse the same filters and limit with nextCursor until it is null. An unknown site fails as not_found; a known site with no matching metadata returns series: []
  • Each row preserves its OGC timeSeriesId, parameter name/unit, nullable statistic, sensor description, raw computation fields, and full UTC beginDate/endDate. Daily maps to daily; Points with Instantaneous maps to instantaneous; other computations have null seriesType
  • For water_get_series, take YYYY-MM-DD from the bounds, pass statCd only for daily rows, and pass a row's timeSeriesId as methodId to request that exact series. Bounds may contain gaps and lag observations; null bounds remain unknown
  • Site identity and metadata share a 45-second deadline including retries. Malformed or rejected continuation cursors fail as invalid_cursor; restart without cursor

water_get_conditions tool
  • One site and parameterCd; ranks the current instantaneous reading against the period-of-record daily-mean percentiles for its calendar day as a percentileClass — record-high (≥p95), above-normal, normal, below-normal, low, record-low ( tool
  • Lists the tables staged on a

Solo se muestra el principio; lee el resto en el repo