Nyc Restroom MCP server

nyc-restroom-mcp

Ask Claude "where's the nearest public bathroom?" and get a real answer.

This is an MCP server, a small plugin that gives an AI assistant (like Claude Desktop or Claude Code) new abilities. This one lets it search New York City's official public restroom data, live from NYC Open Data. Once installed, you can ask things like:

the latest NYC Parks inspection report)

• "Find a public restroom near Union Square that's open right now."
• "Which restrooms near me are wheelchair accessible?"
• "Is the bathroom at Jaime Campiz Playground actually clean?" (it looks up

It adds two tools:

If you don't give it a location, it can detect yours automatically (details below). Everything is read-only: it only ever fetches public city data.

Install

You need Node.js 20 or newer. No download or setup beyond the snippet for your app.

Claude Code (one command):

claude mcp add nyc-restroom -- npx -y nyc-restroom-mcp

Claude Desktop: go to Settings -> Developer -> Edit Config and add this to claudedesktopconfig.json:

{
  "mcpServers": {
    "nyc-restroom": {
      "command": "npx",
      "args": ["-y", "nyc-restroom-mcp"]
    }
  }
}

Any other MCP client works the same way: have it launch npx -y nyc-restroom-mcp as a local (stdio) server.

Good to know

where you are, the server tries to figure it out: first from your device (macOS only, if you brew install corelocationcli and grant it Location Services access), otherwise a rough guess from your IP address. If neither works, or you're outside NYC, it simply asks for explicit coordinates instead of guessing wrong.

• Automatic location. If you ask for nearby restrooms without saying

and your location is never written to logs. Pass explicit coordinates and no location lookup happens at all.

• Privacy. Location detection only happens when you omit coordinates,

short-lived in-memory cache), so results are as current as the city's own records. Inspection reports only exist for restrooms run by NYC Parks; library and other restrooms will honestly say no inspection data exists.

• Live data. Every answer comes straight from NYC Open Data (with a

tool reference, location detection, data sources, configuration, and security model. The reasoning behind every design decision lives in DECISIONS.md.

• More detail. The docs/ directory covers the full

Optional settings

Set these as environment variables if you need them (most people don't):

A few more exist for testing and advanced setups; see docs/configuration.md.

Contributing

Issues and pull requests are welcome at DanielOrtiz0220/nyc-restroom-mcp.

Shortened. The full README is on GitHub.