search_requests: search bounded request metadata by complaint type, borough, agency, and dates.
count_requests: aggregate request totals by complaint type with the same filters.

The server intentionally excludes street addresses, latitude, longitude, and other precise location fields. NYC 311 records are reports of requests, not verified findings, and may contain reporting delays or duplicates. The public Socrata API requires no key for these read-only queries.

Run

npm install
npm run build
node dist/index.js

Quick start

npm install
npm run build
node dist/index.js

The server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code, MCP Inspector, or another compatible MCP client.

Tools at a glance

search_requests: Search recent public NYC 311 requests using non-location-identifying fields. Addresses and coordinates are intentionally excluded.
count_requests: Count NYC 311 requests grouped by complaint type with optional date, borough, and agency filters.

Limits and privacy

This project is intentionally narrow. It should be treated as a practical helper, not a complete certification or security audit. Check the implementation and the returned data before using it with sensitive material. No credentials are required unless the project explicitly says otherwise.

Try it

After building, connect the server through your MCP client. The repository root also contains smoke-test.mjs for projects covered by the shared harness. A typical tool call starts with search_requests.

Premium tools

These tools need a license key:

agency_breakdown
open_by_type

Buy a key at https://mcp-marketplace.io/server/io-github-mrfentmen-nyc311-mcp and set it in your MCP client config:

"env": { "MCP_LICENSE_KEY": "mcp_live_..." }

The key is checked against MCP Marketplace, cached for 24 hours, and keeps working offline once one check has succeeded. Every other tool on this server stays free.