Skip to content
AGENTIC Data Mining
● Public TOOL env.water_use LAST SYNC

USGS National Water Use

The canonical US water-withdrawal dataset from the US Geological Survey — a historical/analytical reference compiled on a 5-year cadence (latest complete compilation is 2015; this is not a nightly feed). One row per area (county or state) × water-use category × compilation year, with the ground/surface × fresh/saline withdrawal breakdown in Mgal/d (million gallons per day). Eight categories: public supply, domestic, industrial, irrigation, livestock, aquaculture, mining, and thermoelectric power. State rows are county estimates summed per category. Public domain (US federal); joins to any FIPS-keyed geographic dataset.

Records

County + state × category × compilation year

Coverage

County + state

2015 compilation · county 1985+, state 1950+ available

Categories

8 use classes

Public supply, irrigation, thermoelectric, and 5 more

Freshness

5-year

USGS compilation cadence · JSON · Public · included in subscription

Coverage syncing from the live ingestion pipeline…

Query parameters

statestring

2-letter state (e.g. AZ)

countystring

County name, partial match (null for state-level rows)

fipsstring

5-digit county FIPS or 2-digit state FIPS — the geographic join key

area_typestring

county or state (state = county sums per category)

category_codestring

PS / DO / IN / IR / LI / AQ / MI / PT (public supply, domestic, industrial, irrigation, livestock, aquaculture, mining, thermoelectric)

yearnumber

Compilation year (e.g. 2015); defaults to the latest complete compilation

limitnumber

Max records per response (default 25, max 50)

Withdrawals are in Mgal/d (million gallons per day). The full input schema is served by the MCP server at connection time.

Example call

Request · env.water_use
{
  "tool": "env.water_use",
  "params": {
    "state": "AZ",
    "county": "Maricopa",
    "category_code": "IR",
    "year": 2015,
    "limit": 10
  }
}
View tool & schema

What you can ask

  • Irrigation vs. thermoelectric vs. public-supply withdrawals for a county or state
  • Groundwater vs. surface-water reliance for a region's public supply
  • Top water-use sector for a given county, ranked by total withdrawal
Full tool reference →

Install in Claude Desktop

One-click .mcpb bundle — adds the env.water_use tool to Claude Desktop. Prompts for your API key on install; nothing is baked in.

Install in Claude Desktop (.mcpb)

Schema

One row per area × water-use category × compilation year.

Field Type Description
area_typestring'county' or 'state' (state = county sums per category)
statestring2-letter state (e.g. AZ)
countystringCounty name (null for state rows)
fipsstring5-digit county FIPS, or 2-digit state FIPS (join key)
yearnumberCompilation year (e.g. 2015)
category_codestringPS / DO / IN / IR / LI / AQ / MI / PT
withdrawal_total_mgdnumberTotal withdrawal for the category, Mgal/d
gw_fresh_mgdnumberFresh groundwater withdrawal, Mgal/d
sw_fresh_mgdnumberFresh surface-water withdrawal, Mgal/d

Every row's as-of is the compilation year. This is a historical/analytical reference, not a live feed.

Sample record

Sample · env.water_use
{
  "area_type": "county",
  "state": "AZ",
  "county": "Maricopa County",
  "fips": "04013",
  "year": 2015,
  "category_code": "IR",
  "category_name": "Irrigation (total)",
  "withdrawal_total_mgd": 1232.8,
  "gw_fresh_mgd": 953.85,
  "sw_fresh_mgd": 278.95,
  "consumptive_use_mgd": 1006.24
}

Use it for

  • Irrigation vs. thermoelectric vs. public-supply withdrawals by county or state
  • Groundwater vs. surface-water reliance for a region's public supply
  • Water-stress and resource-planning context joined to any FIPS-keyed dataset
● Agg Monthly

Water rights

env.waterrights

Water right appropriations, transfers, and curtailment notices across western state engineer systems — priority dates and point-of-diversion joins.

17 western states · appropriations + transfers

Included in subscription View dataset
● Public Weekly

EPA permits

env.permits

Environmental permit applications, modifications, and enforcement across EPA and state-delegated programs — facility expansion signals in permit form.

NPDES, Title V, RCRA · nationwide

Included in subscription View dataset
● Catalog All datasets

Full data catalog

catalog

Every dataset served over MCP, across all sectors — from SEC fundamentals to federal contracts to water use.

Browse everything

All sectors View catalog