USGS Water Services Connector for AI agents.
5 live capabilities
Access real-time streamflow and groundwater data across the United States.
Waiting for input…
Why people use USGS Water Services
USGS Water Services: Stop Manual Hydrological Data Entry
With the USGS Water Services MCP, you just tell your agent what you need. It finds the sites, pulls the historical summaries, and gives you the numbers in a single chat. You get your data without the manual overhead.
What Vinkius changes
You get instant access to official U.S. hydrological data through a simple chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Flood planning for civil engineers
An engineer asks their agent to check the 15-minute streamflow for a specific river to assess flood risk for a new bridge.
- Real-world use case 02
Aquifer health research
A scientist needs to see how groundwater levels have changed over a decade in a specific county.
- Real-world use case 03
Safe river conditions for recreation
An outdoor enthusiast asks if a local river is safe for boating today.
Complete set · 5capabilities
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.
01—03
3 capabilities in this set.
Part of 5 available through USGS Water Services.
- 01 Capability
Get statistics
Retrieve daily, monthly, or annual statistics. Use this to identify broader hydrological patterns.
- 02 Capability
Get daily values
Retrieve historical summarized daily data like mean and max values. This is perfect for analyzing long-term trends.
- 03 Capability
Get groundwater levels
Pull historical groundwater level records. Use this to monitor aquifer depth and trends over time.
04—05
2 capabilities in this set.
Part of 5 available through USGS Water Services.
- 04 Capability
Get instantaneous values
Fetch near real-time water data at 15-minute intervals. It provides current streamflow and water quality.
- 05 Capability
Get sites
Search for specific USGS monitoring stations. You can filter by state, county, or geographic bounding boxes.
Set up in minutes
One URL. Then ask USGS Water Services to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use USGS Water Services from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_OfHHhdAB8ZnJ9M0HtapDqysFqh6ibB2vDee750La/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it USGS Water Services, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable USGS Water Services for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_OfHHhdAB8ZnJ9M0HtapDqysFqh6ibB2vDee750La/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the USGS Water Services URL.
- Step 03
Save and start
Save the connection and enable USGS Water Services in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"usgs-water-services": {
"url": "https://edge.vinkius.com/vk_preview_OfHHhdAB8ZnJ9M0HtapDqysFqh6ibB2vDee750La/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using USGS Water Services
Open Agent mode in chat and ask: "Using USGS Water Services, help me...". 5 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"usgs-water-services": {
"url": "https://edge.vinkius.com/vk_preview_OfHHhdAB8ZnJ9M0HtapDqysFqh6ibB2vDee750La/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using USGS Water Services
Ask Copilot: "Using USGS Water Services, help me...". 5 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"usgs-water-services": {
"url": "https://edge.vinkius.com/vk_preview_OfHHhdAB8ZnJ9M0HtapDqysFqh6ibB2vDee750La/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using USGS Water Services
Open Cascade and ask: "Using USGS Water Services, help me...". 5 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"usgs-water-services": {
"url": "https://edge.vinkius.com/vk_preview_OfHHhdAB8ZnJ9M0HtapDqysFqh6ibB2vDee750La/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using USGS Water Services
Ask Cline: "Using USGS Water Services, help me...". 5 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add usgs-water-services --transport http "https://edge.vinkius.com/vk_preview_OfHHhdAB8ZnJ9M0HtapDqysFqh6ibB2vDee750La/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using USGS Water Services
Ask Claude: "Using USGS Water Services, show me...". 5 tools are ready
Where the request belongs
Work USGS Water Services can move forward.
This is for professionals who deal with water data daily and need to stop manual data scraping. It's for anyone who needs accurate, official USGS records without the hassle of navigating complex government portals.
Environmental Scientist
Gathering historical records and field data for research papers or environmental impact reports.
Hydrologist
Monitoring groundwater levels and aquifer health for regional water management projects.
Civil Engineer
Checking streamflow and water levels to plan for flood prevention and infrastructure safety.
Outdoor Enthusiast
Checking real-time river conditions for safe boating or fishing before heading out.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsUK Environment Agency
Pull real-time flood monitoring, sensor readings, and water levels directly from the UK Environment Agency via any AI agent.
Open-Meteo Flood & Rivers
Predict floods before they happen: GloFAS river discharge simulations at 5km, 40 years of historical data (1984–present), and 7-month forward forecasts for disaster prevention.
NCDC Climate Data Online
Access authoritative historical weather and climate data via NCDC. track datasets, stations, and climate records directly from your AI agent.
ANA (Movimentação de Dados)
Access and manage hydrometeorological data from the Brazilian National Water Agency (ANA). query flow, rainfall, water quality, and cross-section series.
EPA Envirofacts (Environmental Data)
Access US environmental data including UV forecasts, facility information, and toxic release inventories directly from the EPA.
NOAA Climate — Historical Weather Records
Historical climate data from the planet's largest weather archive: GHCN-Daily temperature and precipitation records, monthly and yearly summaries, 30-year climate normals, and station search from NOAA's National Centers for Environmental Information.
Bring your own AI
Change the model, client or framework. Keep USGS Water Services connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about USGS Water Services.
The practical details behind the request, access and result.
Can I use the USGS Water Services MCP to find river levels for my fishing trip?
Yes. You can ask your agent to check real-time river conditions for specific locations. It will pull the latest 15-minute updates so you know the current water levels before you head out.
Does the USGS Water Services MCP provide historical data for groundwater?
Yes, it includes specialized capabilities for groundwater levels. You can pull historical records to monitor aquifer health or study long-term groundwater trends in specific areas.
How do I find specific monitoring stations using this Connector?
You can ask your agent to search for sites by state, county, or even a geographic bounding box. It will return the metadata and IDs for the monitoring stations in that area.
Can I get daily summaries of water flow for a research paper?
Yes. The Connector can retrieve daily summaries, including mean, median, maximum, and minimum values. This is ideal for pulling large amounts of historical data for trend analysis.
Is the data from the USGS Water Services MCP official?
Yes, this Connector connects directly to the United States Geological Survey. You are getting official hydrological data used by scientists and engineers across the country.
Can the USGS Water Services MCP help with flood planning?
Absolutely. Engineers can use it to monitor real-time streamflow and water levels, which is essential for identifying flood risks and planning infrastructure safety.
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.
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).
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.
One connection away
Give your agent a direct line to USGS Water Services.
Connect USGS Water Services once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available