Skip to content
All data sources

USGS Water Services API and MCP server

No authusgs-water

First-party USGS streamflow, stage, water-quality, site, daily-value, and groundwater observations for property and site diligence.

USGS Water Services is published by USGS Water Services.

How often the publisher refreshes it is not declared, so treat the timing of any field as unknown.

Last verified . That is when these facts were last rebuilt from the ParcelOps source registry, not when USGS Water Services last refreshed the data itself.

API access

Your AI client reaches USGS Water Services through one ParcelOps MCP endpoint, so there is no separate key to hold for it and no per-source client to write. Reaching it takes no credentials of your own.

Where it came from

Freshness and coverage

FreshnessFreshness not declared
Places coveredNot declared
Time coveredNot declared
CredentialsNo credentials required

What this source cannot tell you

  • Where it stops geographically, because the covered area is not declared. An empty answer will not tell you whether the place is out of range or the record is simply missing.
  • Which years it spans, because the covered period is not declared.
  • How current a field is, because the refresh schedule is not declared.
  • Anything USGS Water Services does not publish. ParcelOps returns this source as it stands and never fills a blank field from a different one.
  • Products and freshness vary by service and site; observations can be provisional and later revised.
  • The legacy Water Services host is scheduled for decommissioning in early 2027.

Methods (6)

A method is one call your agent can make against this source.

  • getInstantaneousValues

    read

    Get current discharge, gage height, or other USGS readings for comma-separated site IDs.

    What you must providesites
    Records returnedwater-observation
    How to get more resultsnone
    Input schema
    {
      "type": "object",
      "properties": {
        "sites": {
          "type": "string",
          "pattern": "^\\d{8,15}(?:,\\d{8,15})*$"
        },
        "parameterCd": {
          "type": "string",
          "pattern": "^\\d{5}(?:,\\d{5})*$"
        },
        "period": {
          "type": "string",
          "maxLength": 30
        }
      },
      "required": [
        "sites"
      ],
      "additionalProperties": false
    }
  • getDailyValues

    read

    Get Daily Values

    What you must providesites
    Records returneddaily-water-observation
    How to get more resultsnone
    Input schema
    {
      "type": "object",
      "properties": {
        "sites": {
          "type": "string",
          "pattern": "^\\d{8,15}(?:,\\d{8,15})*$"
        },
        "parameterCd": {
          "type": "string",
          "pattern": "^\\d{5}(?:,\\d{5})*$"
        },
        "startDate": {
          "type": "string",
          "maxLength": 20
        },
        "endDate": {
          "type": "string",
          "maxLength": 20
        },
        "period": {
          "type": "string",
          "maxLength": 30
        }
      },
      "required": [
        "sites"
      ],
      "additionalProperties": false
    }
  • getSiteInfo

    read

    Get Site Info

    What you must providesites
    Records returnedwater-monitoring-site
    How to get more resultsnone
    Input schema
    {
      "type": "object",
      "properties": {
        "sites": {
          "type": "string",
          "pattern": "^\\d{8,15}(?:,\\d{8,15})*$"
        }
      },
      "required": [
        "sites"
      ],
      "additionalProperties": false
    }
  • searchSites

    read

    Find USGS sites by ONE location filter: bbox (max 4 square degrees), countyCd, or stateCd.

    Records returnedwater-monitoring-site
    How to get more resultsnone
    Input schema
    {
      "type": "object",
      "properties": {
        "stateCd": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$"
        },
        "countyCd": {
          "type": "string",
          "pattern": "^\\d{5}(?:,\\d{5})*$"
        },
        "bbox": {
          "description": "west,south,east,north in WGS84. At most 4 square degrees.",
          "oneOf": [
            {
              "type": "array",
              "minItems": 4,
              "maxItems": 4,
              "items": {
                "type": "number"
              },
              "description": "[minLongitude, minLatitude, maxLongitude, maxLatitude] in WGS84."
            },
            {
              "type": "string",
              "pattern": "^-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?$"
            }
          ]
        },
        "parameterCd": {
          "type": "string",
          "pattern": "^\\d{5}(?:,\\d{5})*$"
        },
        "siteType": {
          "type": "string",
          "maxLength": 80
        },
        "maxResults": {
          "type": "integer",
          "minimum": 1,
          "maximum": 500
        }
      },
      "required": [],
      "additionalProperties": false
    }
  • getGroundwaterLevels

    read

    Get Groundwater Levels

    Records returnedgroundwater-observation
    How to get more resultsnone
    Input schema
    {
      "type": "object",
      "properties": {
        "sites": {
          "type": "string",
          "pattern": "^\\d{8,15}(?:,\\d{8,15})*$"
        },
        "bbox": {
          "description": "west,south,east,north in WGS84. At most 4 square degrees.",
          "oneOf": [
            {
              "type": "array",
              "minItems": 4,
              "maxItems": 4,
              "items": {
                "type": "number"
              },
              "description": "[minLongitude, minLatitude, maxLongitude, maxLatitude] in WGS84."
            },
            {
              "type": "string",
              "pattern": "^-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?$"
            }
          ]
        },
        "siteType": {
          "type": "string",
          "maxLength": 80
        },
        "startDate": {
          "type": "string",
          "maxLength": 20
        },
        "endDate": {
          "type": "string",
          "maxLength": 20
        }
      },
      "required": [],
      "additionalProperties": false
    }
  • getServiceInfo

    read

    Get Service Info

    Input schema
    {
      "type": "object",
      "properties": {},
      "required": [],
      "additionalProperties": false
    }

Where this source is used