lake-level-mcp
You can query live US lake and reservoir data from government gauges through this MCP server.
Search 44 covered lakes by name, river, operator, or state and get slug, full-pool elevation, gauge agency, and lake page.
Get current elevation, measurement time, 24h/7d/30d change, feet below full pool, seasonal target where published, percent full where available, and gauge/data URL.
Fetch daily or weekly elevation history for 2–365 days with first, last, low, high, and mean stats.
Compare 2–10 lakes side by side, ranked by distance below full pool, with per-lake errors if a gauge is down.
Use it hosted or locally with no API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@lake-level-mcp What's Lake Mead's level today and how far below full pool is it?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
lake-level-mcp
Live US lake and reservoir water levels for AI assistants, read at call time from USGS, USACE, CDEC, Reclamation and TWDB gauges.
This is a Model Context Protocol (MCP) server. It covers 44 lakes in 12 states, including Lake Mead, Lake Powell, Lake Travis, Shasta, Oroville, Folsom, Lake Lanier, Lake Texoma and Kentucky Lake. It needs no API key.
Tools
Tool | What it returns |
| Covered lakes by name, river, operator or state, with slug, full pool and gauge. |
| Current elevation, measurement time, change over 24 hours, 7 days and 30 days, feet below full pool, the operator seasonal target where one is published, percent full where the agency publishes storage, gauge id and data URL. |
| Daily or weekly elevation series for up to 365 days, with first, last, low, high and mean. |
| 2 to 10 lakes side by side, ranked by feet below full pool. A lake whose gauge is down is reported, not fatal. |
Every result has structured JSON, a one-paragraph summary, as_of, source (the agency URL) and more (the lake page on lakelevelnow.com).
Related MCP server: gagelink
What it knows that your model does not
Today's water level. Lakes move every hour and a model's training data is months old.
Which gauge to read for each lake. The bindings (USGS site and parameter, CDEC station, Reclamation RISE item, TWDB reservoir, USACE CWMS time series) are the verified set lakelevelnow.com uses.
Full-pool elevations and published seasonal guide curves (USACE, TVA, Alabama Power), so "8 ft low" can be read against the winter target, not only against summer full pool.
How to handle feed quirks: unpadded CDEC dates, CWMS loggers that stamp local time as UTC, USGS 15-minute data collapsed to one reading per day.
Install
Hosted (Claude.ai custom connector, ChatGPT developer mode)
Paste this URL. No token, no sign-up.
https://lake-level-mcp.lipmichal.workers.dev/mcpClaude Code
claude mcp add --transport http lake-level https://lake-level-mcp.lipmichal.workers.dev/mcpOr run it locally over stdio:
claude mcp add lake-level -- npx -y lake-level-mcpClaude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"lake-level": { "command": "npx", "args": ["-y", "lake-level-mcp"] }
}
}Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"lake-level": { "url": "https://lake-level-mcp.lipmichal.workers.dev/mcp" }
}
}VS Code
Add to .vscode/mcp.json:
{
"servers": {
"lake-level": { "type": "http", "url": "https://lake-level-mcp.lipmichal.workers.dev/mcp" }
}
}Node 20 or newer is needed for the local stdio version.
Example prompts
"What is the Lake Mead water level today, and how far below full pool is it?"
"Is Lake Lanier above or below its winter guide curve right now?"
"Show Lake Powell's level over the last year, weekly."
"Compare Shasta, Oroville and Folsom: which is fullest?"
"Which Texas lakes do you cover?"
Data sources
All public and keyless. Full list with fetch dates in DATA_SOURCES.md.
USGS Water Services, instantaneous and daily values (waterservices.usgs.gov)
California Department of Water Resources, CDEC (cdec.water.ca.gov)
U.S. Bureau of Reclamation RISE API (data.usbr.gov)
Texas Water Development Board, Water Data for Texas (waterdatafortexas.org)
U.S. Army Corps of Engineers CWMS Data API (cwms-data.usace.army.mil)
Upstream answers are cached for 15 minutes (current level) or 1 hour (history) to respect the agencies' services.
Limitations
44 lakes, the same set as lakelevelnow.com. High Rock Lake (NC) has no public government feed and returns a clear error.
Readings are provisional agency data. CDEC, TWDB and Reclamation publish daily values, so their latest reading is usually yesterday's.
USGS keeps about 120 days of 15-minute data. For longer history the server uses USGS daily means where the site publishes them, and TWDB's daily record for Texas lakes. Some gauges return less than 365 days; the result says how many days it covers.
Percent full is shown only where the agency publishes storage (CDEC, Reclamation, TWDB).
When an agency service is down, the tool returns an error that names the agency and links the lake page, which keeps the last published reading.
Self-hosting and storage
The default build needs no database: upstream readings are cached in memory for 15 minutes (current level) or 1 hour (history).
If you mirror the readings into Postgres, to keep history past the agencies' retention window, we recommend Neon. It is managed Postgres with a free tier, database branching, and scale-to-zero compute. Create a project, set DATABASE_URL, and point your own writer at the upstream APIs listed in DATA_SOURCES.md.
More
Charts, boat ramp context and the paid Lake Level Almanac (decades of daily record and day-of-year normals per lake) are on lakelevelnow.com. The almanac covers 19 of these lakes: lakelevelnow.com/almanac.
Part of the Zovo MCP collection: https://mcp.zovo.one
Development
npm install
npm test # builds, then runs the fixture tests against saved agency payloads
node scripts/smoke-stdio.mjs # live stdio check, one real call per tool
npx wrangler deploy # Cloudflare Worker, Streamable HTTP at /mcpsrc/lakes.data.ts is generated from the lakelevelnow.com data by scripts/build-lakes.mjs.
License
MIT
More data servers from the same author
Each one is free, needs no API key and has a hosted URL you can paste into Claude or ChatGPT.
server | tools | hosted URL |
convert_ingredient, search_ingredients, scale_recipe, convert_oven_temperature |
| |
calculate_dscr, max_loan_for_target_dscr, rent_needed_for_target_dscr, compare_scenarios, amortization_summary |
| |
get_gold_price_per_gram, get_metal_prices, calculate_jewelry_value, convert_gold_units |
| |
get_minimum_wage, list_upcoming_increases, compare_states, annual_income_at_minimum_wage |
| |
calculate_overtime_deduction, calculate_tips_deduction, calculate_senior_deduction, estimate_tax_savings, explain_eligibility |
| |
calculate_take_home_pay, compare_states_take_home, salary_to_hourly, hourly_to_salary, get_federal_tax_brackets |
| |
calculate_uk_take_home, get_uk_tax_bands, compare_salaries, marginal_rate_at_income |
| |
list_federal_holidays, is_business_day, add_business_days, count_business_days, invoice_due_date |
| |
calculate_sample_size, estimate_test_duration, test_ab_significance, fisher_exact_test, check_peeking_risk |
| |
get_federal_poverty_level, calculate_premium_tax_credit, check_subsidy_cliff, get_aptc_repayment_cap |
| |
get_ap_score_distribution, estimate_ap_percentile, compare_ap_exams, list_ap_exams, estimate_ap_score_from_composite |
| |
calculate_car_loan_interest_deduction, calculate_salt_deduction, get_tax_brackets_and_standard_deduction, calculate_child_tax_credit |
| |
get_exemption_amounts, calculate_estate_tax, check_gift, compare_years |
| |
lookup_ingredient_nutrition, calculate_recipe_nutrition, round_nutrition_label, scale_recipe_nutrition |
| |
get_contribution_limits, calculate_max_contribution, get_social_security_cola, compare_years |
| |
calculate_section_179, calculate_bonus_depreciation, get_vehicle_depreciation_limits, calculate_asset_loan_payment |
| |
calculate_rap_payment, compare_rap_vs_standard, get_federal_loan_limits, get_plan_transition_dates |
| |
find_subdomains, resolve_subdomains, get_certificate_history, summarize_attack_surface |
| |
calculate_statutory_sick_pay, calculate_statutory_maternity_pay, get_minimum_wage_rates, check_eligibility |
|
The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one
More from zovo
All free zovo VS Code extensions — file viewers, database clients, formatters. Offline, no telemetry, no sign-up.
Full MCP server catalogue — local-first MCP servers for back-office work: invoices, VAT, PDFs, spreadsheets, payroll.
Hosted no-install MCP endpoints — paste a URL in Claude / Cursor, nothing to install.
Available Tools
4 toolscompare_lakesCompare lake levelsARead-onlyIdempotentInspect
Current levels of 2 to 10 US lakes side by side, read live from their gauges: elevation, feet below full pool, percent full, seasonal target and 24 h / 7 day / 30 day change, ranked by distance below full pool. A lake whose gauge is down is reported with its error instead of failing the whole call.
Inputs: lakes (required).
get_lake_historyGet lake level historyARead-onlyIdempotentInspect
Daily (or weekly) water elevation series for a US lake or reservoir over the last 2 to 365 days, from the same government gauge as get_lake_level, one reading per day. Includes first, last, low, high and mean with dates. Use it for trends, drawdown and refill questions.
Inputs: lake (required), days, step.
get_lake_levelGet current lake levelARead-onlyIdempotentInspect
Current water surface elevation (ft above sea level) of a US lake or reservoir, read now from its government gauge (USGS, USACE CWMS, CDEC, Reclamation or TWDB). Returns the measurement time, change over 24 hours, 7 days and 30 days, feet below full pool, the operator seasonal target where one is published, percent full where the agency publishes storage, and the gauge id and data URL. Your training data cannot know today's level.
Inputs: lake (required).
search_lakesSearch US lakes and reservoirsARead-onlyIdempotentInspect
List the 44 US lakes and reservoirs this server reads live (Lake Mead, Lake Powell, Lake Travis, Shasta, Oroville, Lanier, Texoma, Kentucky Lake and more) by name, river, operator or state. Returns each slug, full-pool elevation, the gauge agency and the lakelevelnow.com page. Call with no arguments to list them all.
Inputs: query, state.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct role: search_lakes discovers lakes, get_lake_level returns current conditions, get_lake_history returns time series, and compare_lakes returns multi-lake rankings. The only overlap is that compare_lakes includes current data, but its multi-lake comparative purpose is clearly distinct from the single-lake get_lake_level.
All four tools use consistent snake_case verb_noun naming: search_lakes, get_lake_level, get_lake_history, compare_lakes. The pattern is predictable and readable throughout.
Four tools are well-scoped for a focused lake-level domain. Each tool serves a distinct workflow—discovery, current reading, history, and comparison—with no obvious redundancy.
The surface covers the full read-only lifecycle: finding lakes, reading current levels, retrieving historical trends, and comparing multiple lakes. Search returns metadata such as slug, full-pool elevation, gauge agency, and page, so there are no obvious dead ends.
Maintenance
Related MCP Connectors
Real-time water levels and flow rates from USGS stream gauges
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
Lake and reservoir water levels from satellite radar altimetry — NASA GSFC Global Water Monitor…
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceProvides NOAA tide predictions and observed water levels, allowing AI agents to query tide stations and current water level data.2 npmMIT
- AlicenseAqualityBmaintenanceProvides hydrology data (river levels, streamflow, flood forecasts, water quality) from USGS, NOAA, and SWOT, preserving units, datums, timezones, and data quality for AI agents.13MIT
- AlicenseNot gradedqualityCmaintenanceEnables querying current and historical relative water levels for 518 lakes, seas, and reservoirs worldwide from satellite radar altimetry, with search by name, country, or continent.75 npmMIT
- AlicenseAqualityCmaintenanceProvides AI agents live access to USGS stream flow, gage height, and water temperature data, along with EPA water quality results ranked against compliance thresholds, and composite basin health scores.3MIT