How to Use the USGS Water Services MCP in Cline

Q: How do I query site metadata using USGS Water Services and Cline?

You write a function that calls getsites, passing combined filters like bBox or countyCd. Cline executes this call, giving you the raw JSON data which your code can then process into structured types.

Q: What metrics are available for historical analysis with USGS Water Services and Cline?

You access daily, monthly, and annual statistics via getstatistics. You also get summarized flow rates using getdailyvalues by specifying the required date range.

Q: Can I use USGS Water Services and Cline to build a live dashboard?

Yes. By combining calls to getinstantaneousvalues for real-time data, you can write code that creates a live component in your IDE, automatically refreshing with the latest 15-minute interval readings.

Q: What filters must I use when retrieving groundwater levels?

When calling getgroundwaterlevels, you need to ensure you specify key identifying parameters for manual recordings. The tool requires these inputs to accurately retrieve the historical data points.

Build water data dashboards with Cline's end-to-end execution inside VS Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect USGS Water Services MCP to Cline

Create your Vinkius account to connect USGS Water Services to Cline and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup USGS Water Services with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Write code to fetch and process site metadata.

Use `get_sites` when you need to programmatically find USGS sites. You can combine multiple filters like stateCd, huc, or countyCd into a single search query within your script. Cline executes this data retrieval, letting you immediately build the necessary component structure in your repository. It's write-test-commit ready.

Implement historical trend analysis.

`get_daily_values` gives you summarized daily metrics (mean, median, max, min). You can call this tool to generate a time series dataset. Cline writes the Python code needed to ingest and plot these statistics for your dashboard. It handles the data formatting automatically, so all you do is review the generated file diff.

Create components using real-time flow data.

Need near real-time water data? `get_instantaneous_values` pulls 15-minute intervals based on site IDs. You can use this in conjunction with `get_statistics` to compare current readings against annual averages. Cline writes the API call wrapper for you, imports the necessary library dependencies, and stages the full component commit.

Setup guide

Set up USGS Water Services MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type usgs-water-services-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest USGS Water Services refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "usgs-water-services-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by USGS Water Services. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect USGS Water Services now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about USGS Water Services MCP in Cline

You write a function that calls `get_sites`, passing combined filters like bBox or countyCd. Cline executes this call, giving you the raw JSON data which your code can then process into structured types.

You access daily, monthly, and annual statistics via `get_statistics`. You also get summarized flow rates using `get_daily_values` by specifying the required date range.

Yes. By combining calls to `get_instantaneous_values` for real-time data, you can write code that creates a live component in your IDE, automatically refreshing with the latest 15-minute interval readings.

When calling `get_groundwater_levels`, you need to ensure you specify key identifying parameters for manual recordings. The tool requires these inputs to accurately retrieve the historical data points.

Yes. You can combine multiple filters in a single query—for example, using both `stateCd` and `huc` identifiers when calling `get_sites`. This makes your code much more precise.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript