🌊 Potomac River Water Data

Real-time USGS Water Services via MCP

🟢 Online

About This Service

This Model Context Protocol (MCP) server provides real-time Potomac River water level and flow data from USGS stations. Get current conditions, historical context, and trend analysis for Georgetown and Little Falls monitoring stations.

🔗 MCP Endpoint

Main MCP protocol endpoint

https://water-services-mcp.dudgeon.workers.dev/

📡 SSE Endpoint

Server-Sent Events endpoint

https://water-services-mcp.dudgeon.workers.dev/sse

Available Tools

🌊 Potomac River Conditions

get_potomac_conditions - Complete current conditions including water level and flow rate with historical context and trend analysis

Primary tool: Provides comprehensive overview from both Georgetown and Little Falls stations

📏 Water Level Only

get_potomac_gage_depth - Georgetown water level with 7-day range and 90-minute trend

For focused water depth analysis

🌊 Flow Rate Only

get_potomac_flow - Little Falls flow rate with 7-day range and 90-minute trend

For focused discharge analysis

Example Usage & Responses

🌊 Combined River Conditions

Sample queries:
  • "What are the current Potomac River conditions?"
  • "Check water level and flow rate for the Potomac"
  • "How is the river looking today?"
JSON Response Format:
{
  "water_level": {
    "navd88_ft": 2.45,
    "timestamp": "2025-01-07T10:30:00Z",
    "seven_day_min_ft": 1.89,
    "seven_day_max_ft": 3.12,
    "trend_direction": "rising",
    "trend_change_ft": 0.08,
    "stale": false
  },
  "flow_rate": {
    "discharge_cfs": 16850,
    "timestamp": "2025-01-07T10:15:00Z",
    "seven_day_min_cfs": 12400,
    "seven_day_max_cfs": 18900,
    "trend_direction": "stable",
    "trend_change_cfs": -45,
    "stale": false
  },
  "data_completeness": "complete",
  "overall_staleness": "fresh"
}

📏 Water Level Only

Sample queries:
  • "What's the water level at Georgetown?"
  • "How deep is the Potomac right now?"
  • "Check current water depth"
JSON Response Format:
{
  "navd88_ft": 2.45,
  "wmlw_ft": 4.92,
  "timestamp": "2025-01-07T10:30:00Z",
  "seven_day_min_ft": 1.89,
  "seven_day_max_ft": 3.12,
  "trend_direction": "rising",
  "trend_change_ft": 0.08,
  "reading_90min_ago_ft": 2.37,
  "stale": false
}

🌊 Flow Rate Only

Sample queries:
  • "What's the flow rate at Little Falls?"
  • "How fast is the Potomac flowing?"
  • "Check current discharge rate"
JSON Response Format:
{
  "discharge_cfs": 16850,
  "timestamp": "2025-01-07T10:15:00Z",
  "seven_day_min_cfs": 12400,
  "seven_day_max_cfs": 18900,
  "trend_direction": "stable",
  "trend_change_cfs": -45,
  "reading_90min_ago_cfs": 16895,
  "stale": false
}

USGS Monitoring Stations

This MCP server provides real-time data from two USGS monitoring stations along the Potomac River. These stations continuously collect water level and flow rate measurements that power our water data tools.

Georgetown (01647600): Water level monitoring
Little Falls (01646500): Flow rate monitoring