USGS Water Services MCP Server for Mastra AIGive Mastra AI instant access to 5 tools to Get Daily Values, Get Groundwater Levels, Get Instantaneous Values, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect USGS Water Services through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The USGS Water Services MCP Server for Mastra AI is a standout in the Industry Titans category — giving your AI agent 5 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"usgs-water-services": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "USGS Water Services Agent",
instructions:
"You help users interact with USGS Water Services " +
"using 5 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with USGS Water Services?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About USGS Water Services MCP Server
Connect to the USGS Water Services to retrieve comprehensive hydrological data directly from the United States Geological Survey. Monitor environmental conditions, analyze historical trends, and discover monitoring stations through natural language.
Mastra's agent abstraction provides a clean separation between LLM logic and USGS Water Services tool infrastructure. Connect 5 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Real-time Monitoring — Use
get_instantaneous_valuesto fetch near real-time data (15-minute intervals) for streamflow, water levels, and quality. - Historical Analysis — Retrieve daily summaries (mean, median, max, min) using
get_daily_valuesfor long-term trend analysis. - Site Discovery — Search for monitoring stations using
get_sitesfiltered by state, county, hydrologic unit (HUC), or geographic bounding box. - Statistical Reports — Generate daily, monthly, or annual statistics with
get_statisticsto understand hydrological patterns. - Groundwater Tracking — Access specialized groundwater level data using
get_groundwater_levelsfor aquifer monitoring.
The USGS Water Services MCP Server exposes 5 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 5 USGS Water Services tools available for Mastra AI
When Mastra AI connects to USGS Water Services through Vinkius, your AI agent gets direct access to every tool listed below — spanning hydrology, environmental-data, water-monitoring, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Get daily values on USGS Water Services
You MUST provide at least one major filter. Retrieve historical summarized daily data (mean, median, max, min)
Get groundwater levels on USGS Water Services
You MUST provide at least one major filter. Retrieve historical manually-recorded groundwater levels
Get instantaneous values on USGS Water Services
You MUST provide at least one major filter: sites, stateCd, huc, bBox, or countyCd. Retrieve near real-time water data (usually 15-minute intervals)
Get sites on USGS Water Services
Multiple major filters can be combined (AND logic). Search for USGS sites and metadata
Get statistics on USGS Water Services
Retrieve daily, monthly, or annual statistics based on approved data
Connect USGS Water Services to Mastra AI via MCP
Follow these steps to wire USGS Water Services into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the USGS Water Services MCP Server
Mastra AI provides unique advantages when paired with USGS Water Services through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add USGS Water Services without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every USGS Water Services tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
USGS Water Services + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the USGS Water Services MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query USGS Water Services, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed USGS Water Services as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query USGS Water Services on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using USGS Water Services tools alongside other MCP servers
Example Prompts for USGS Water Services in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with USGS Water Services immediately.
"Search for all active USGS water monitoring sites in Florida."
"Get the last 7 days of water level data for site 08313000."
"What are the daily mean statistics for discharge at site 01646500?"
Troubleshooting USGS Water Services MCP Server with Mastra AI
Common issues when connecting USGS Water Services to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpUSGS Water Services + Mastra AI FAQ
Common questions about integrating USGS Water Services MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
GoSquared
11 toolsMonitor real-time web traffic and analyze historical trends via AI.
Contentdrips
10 toolsTurn text into scroll-stopping social media carousels and visual content pieces that boost engagement on every platform.
Froged
11 toolsManage customer success, track events, and handle omnichannel support via AI agents with Froged.
Handwrytten
10 toolsAutomate handwritten notes via Handwrytten — manage cards, fonts, and send physical mail directly from any AI agent.