An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect USGS Water Services to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Pull real-time hydrological data directly into your AI agent.

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

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 5 capabilities

We ship only the actions that matter.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 5 available through USGS Water Services.

  1. 01

    Get daily values

    This capability pulls summarized daily data including mean, median, max, and min values. It is used for analyzing historical water trends over specific periods.

  2. 02

    Get groundwater levels

    This capability retrieves manually recorded historical groundwater levels. Use it to monitor aquifer health and water table changes.

  3. 03

    Get instantaneous values

    This capability fetches near real-time water data, typically updated at 15-minute intervals. It provides current streamflow, water levels, and quality metrics.

Capability set02 / 02

04-05

2 capabilities in this set.

Part of 5 available through USGS Water Services.

  1. 04

    Get sites

    This capability searches for USGS monitoring stations and their metadata. You can filter your search by state, county, HUC, or geographic bounding box.

  2. 05

    Get statistics

    This capability generates daily, monthly, or annual statistical reports. It helps you understand hydrological patterns through aggregated data.

Real work

What teams actually run

01

Flood Risk Assessment

An engineer asks the agent for recent streamflow spikes to evaluate local flood threats.

02

Aquifer Monitoring

A researcher pulls groundwater level history to track changes in water availability.

03

Field Site Planning

A scientist uses site discovery capabilities to find the nearest monitoring station in a specific county.

04

Recreational Safety

A boater checks current water levels at a specific site before heading out on a river.

Automate a task

Put USGS Water Services to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

USGS Water Services works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put USGS Water Services to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1052ms average. Fast in production.

USGS Water Services is checked daily against the live service.

Daily averagePeak 1196ms
Oct 3Today
Fastest day
834ms
Slowest day
1196ms
14-day trend
Stable-3%

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

Guided setup for Claude? Set up USGS Water Services in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work USGS Water Services owners hand off.

This MCP is built for professionals who need to move from raw hydrological data to actionable insights without manual data entry.

  • 01

    Environmental Scientists

    They use the agent to gather field data and historical records for research papers.

  • 02

    Hydrologists and Engineers

    They monitor streamflow and groundwater levels to plan for flood risks or infrastructure needs.

  • 03

    Outdoor Enthusiasts

    They check real-time river conditions for safety or recreation like fishing and boating.

FAQ

Questions USGS Water Services owners ask.

  • 01

    How do I access the USGS data?

    You simply enter 'PUBLIC' as your access key during initialization to start querying the USGS database.

  • 02

    How often is the water data updated?

    Near real-time data, accessed through the instantaneous values capability, is typically updated at 15-minute intervals.

  • 03

    Can I search for stations in a specific area?

    Yes, you can use the site discovery capability to find stations by state, county, HUC, or a specific geographic bounding box.

  • 04

    What kind of historical data is available?

    You can access daily summaries including mean, median, max, and min values, as well as historical groundwater levels.

  • 05

    Which AI clients can use this MCP?

    This MCP works with any compatible client, including Claude, Cursor, Windsurf, and VS Code.

  • 06

    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.

  • 07

    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).

  • 08

    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

Connect USGS Water Services to Claude, Cursor, ChatGPT & more