Colorado DWR MCP Server

This is a Model Context Protocol (MCP) server that interfaces with the Colorado Division of Water Resources (DWR) REST API. It allows AI models to retrieve water data, rights, permits, and administrative calls.

Features

• Surface Water Stations: Search for stations by name, location, etc.
• Surface Water Time Series: Get daily time series data (streamflow, etc.).
• Water Rights: Query net amounts and transactions.
• Well Permits: Search for well permits.
• Administrative Calls: Get active administrative calls.
• Generic Query: Flexible tool to query any DWR API endpoint.

Installation

1. Clone this repository.
2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

Usage

Stdio Mode (for local clients like Claude Desktop)

node build/index.js

HTTP/SSE Mode (for remote connections)

node build/sse.js

This will start a server at http://localhost:3000.

• SSE Endpoint: http://localhost:3000/sse

Configuration

No API key is strictly required for basic usage, but if you have one, you can set it via the DWR_API_KEY environment variable.

Tools

• get_surface_water_stations
• get_surface_water_ts_day
• get_water_rights_net_amount
• get_well_permits
• get_active_admin_calls
• query_dwr_api

Development

Run the test client to verify functionality:

npx tsx test_client.ts