io.github.squidcode/tapwatermap

Official10 toolsLive

by squidcode

Query US tap-water quality from the EPA's SDWIS records — by city, system, or contaminant.

io.github.squidcode/tapwatermap — MCP Server

The MCP server provides tools to query U.S. tap-water quality using the EPA’s SDWIS records. Queries can be made by city, by water system, or by contaminant, enabling retrieval of relevant quality information from the underlying EPA dataset.

🛠️ Key Features

Queries the EPA’s SDWIS tap-water quality records
Supports lookup by city
Supports lookup by water system
Supports lookup by contaminant
Exposes 10 tools

🚀 Use Cases

Find tap-water quality information for a specific city
Retrieve quality details for a known water system
Check tap-water quality related to a particular contaminant

⚡ Developer Benefits

Structured access to EPA SDWIS data through MCP tools
Multiple query dimensions (city, system, contaminant)

⚠️ Limitations

Server scope is limited to U.S. tap-water quality data from EPA SDWIS records

Captured live from the server via tools/list.

search

Search TapWaterMap for US cities by name. Returns matching cities with an id you can pass to `fetch`. (ChatGPT/Deep-Research compatible.)

Parameters1

query

string

required

City name or partial name, e.g. 'Burlington'.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "City name or partial name, e.g. 'Burlington'."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

fetch

Fetch the full plain-English EPA tap-water record for a city id (e.g. 'vt/burlington') returned by `search`. (ChatGPT/Deep-Research compatible.)

Parameters1

string

required

City id like 'vt/burlington' (state/slug).

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "City id like 'vt/burlington' (state/slug)."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

search_cities

Find covered US cities by name, optionally within a state. Returns counts + the page URL for each.

Parameters3

query	string	required
state	string	optional	Optional 2-letter state code, e.g. 'TX'.
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "description": "Optional 2-letter state code, e.g. 'TX'."
    },
    "limit": {
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

get_city_water

The core tool: what the EPA has on record for a city's tap water — the active community water systems serving it, populations, sources, and violations (contaminant, health-based or not, dates, status, level vs limit when recorded). Plain-English, sourced, never a safety verdict.

Parameters2

city	string	required
state	string	required	2-letter state code, e.g. 'VT'.

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "description": "2-letter state code, e.g. 'VT'."
    }
  },
  "required": [
    "city",
    "state"
  ],
  "additionalProperties": false
}

get_water_system

EPA record for a single water system by its PWSID (e.g. 'VT0005053'): name, population served, source, and violations.

Parameters1

pwsid

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "pwsid": {
      "type": "string"
    }
  },
  "required": [
    "pwsid"
  ],
  "additionalProperties": false
}

list_state_cities

List all covered cities in a state (with violation counts).

Parameters1

state

string

required

2-letter state code.

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "2-letter state code."
    }
  },
  "required": [
    "state"
  ],
  "additionalProperties": false
}

find_cities

Filter/rank cities across the dataset — e.g. cities in TX with open health-based violations, or cities with a specific contaminant. Returns ranked matches.

Parameters6

state	string	optional	Optional 2-letter state code.
contaminant	string	optional	Optional EPA contaminant code or name (use explain_contaminant to find a code).
healthBasedOnly	boolean	optional
minPopulation	integer	optional
openViolationsOnly	boolean	optional	Only cities with violations not returned to compliance.
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Optional 2-letter state code."
    },
    "contaminant": {
      "type": "string",
      "description": "Optional EPA contaminant code or name (use explain_contaminant to find a code)."
    },
    "healthBasedOnly": {
      "type": "boolean"
    },
    "minPopulation": {
      "type": "integer"
    },
    "openViolationsOnly": {
      "type": "boolean",
      "description": "Only cities with violations not returned to compliance."
    },
    "limit": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}

compare_cities

Compare the EPA records of several cities side by side. Pass cities as 'City, ST' strings.

Parameters1

cities

array

required

e.g. ['Burlington, VT', 'Houston, TX']

Raw schema

{
  "type": "object",
  "properties": {
    "cities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "e.g. ['Burlington, VT', 'Houston, TX']"
    }
  },
  "required": [
    "cities"
  ],
  "additionalProperties": false
}

explain_contaminant

Plain-English explanation of an EPA contaminant by name or code: the EPA name, whether the EPA classifies it as health-based, and how often it appears in our records. Not medical advice.

Parameters1

contaminant

string

required

Contaminant name or EPA code, e.g. 'TTHM' or '2950'.

Raw schema

{
  "type": "object",
  "properties": {
    "contaminant": {
      "type": "string",
      "description": "Contaminant name or EPA code, e.g. 'TTHM' or '2950'."
    }
  },
  "required": [
    "contaminant"
  ],
  "additionalProperties": false
}

coverage_stats

What TapWaterMap covers: states, cities, total EPA violation records, and the data quarter/date.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Install

Tools (10)

searchfetchsearch_citiesget_city_waterget_water_systemlist_state_citiesfind_citiescompare_cities

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.tapwatermap.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "tapwatermap": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tapwatermap.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.squidcode/tapwatermap — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search

fetch

search_cities

get_city_water

get_water_system

list_state_cities

find_cities

compare_cities

explain_contaminant

coverage_stats

Install

Remote endpoint

Related servers