Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use USGS Water Services with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Access real-time and historical water data from the USGS, including streamflow, groundwater levels, and site metadata across the US.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 5 capabilities

The complete USGS Water Services capability set.

These are the exact actions your AI can choose when you ask it to work with USGS Water Services.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 5 available through USGS Water Services.

  1. 01

    Get daily values

    You MUST provide at least one major filter. Retrieve historical summarized daily data (mean, median, max, min)

  2. 02

    Get groundwater levels

    You MUST provide at least one major filter. Retrieve historical manually-recorded groundwater levels

  3. 03

    Get instantaneous values

    You MUST provide at least one major filter: sites, stateCd, huc, bBox, or countyCd. Retrieve near real-time water data (usually 15-minute intervals)

Capability set02 / 02

04-05

2 capabilities in this set.

Part of 5 available through USGS Water Services.

  1. 04

    Get sites

    Multiple major filters can be combined (AND logic). Search for USGS sites and metadata

  2. 05

    Get statistics

    Retrieve daily, monthly, or annual statistics based on approved data

Observed, not estimated

937ms average. Fast in production.

USGS Water Services is checked daily against the live service.

Daily averagePeak 1161ms
Aug 20Today
Fastest day
807ms
Slowest day
1161ms
14-day trend
Stable+4%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 5 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of USGS Water Services, so you can see the experience inside your AI.

It does not authenticate your account with USGS Water Services. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

USGS Water Services Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_OfHHhdAB8ZnJ9M0HtapDqysFqh6ibB2vDee750La/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — USGS Water Services capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "usgs-water-services-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OfHHhdAB8ZnJ9M0HtapDqysFqh6ibB2vDee750La/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions USGS Water Services owners ask.

  • 01

    How can I find all water monitoring sites in a specific state?

    Use the get_sites capability and provide the 2-digit USPS state code (e.g., 'CA' for California) in the stateCd parameter. This will return a list of sites and their metadata for that state.

  • 02

    Can I get real-time streamflow data for a specific river station?

    Yes! Use get_instantaneous_values with the specific USGS site number in the sites parameter. You can also specify parameterCd as '00060' for discharge (streamflow).

  • 03

    Is it possible to retrieve long-term monthly averages for a site?

    Absolutely. Use the get_statistics capability with the statReportType set to 'monthly'. This will provide approved statistical summaries based on the historical record of the site.

Explore

More in Industry Titans

Suggestions