NYC 311: how to report a problem, district numbers from BoardStat, the 311 calendar and alerts
Connect Runs on your machine
claude mcp add nyc-311-mcp -e NYC_311_API_KEY=<NYC_311_API_KEY> -e SOCRATA_APP_TOKEN=<SOCRATA_APP_TOKEN> -e NYC_311_MCP_CACHE_DIR=<NYC_311_MCP_CACHE_DIR> -- npx -y @betanyc/[email protected]
{
"mcpServers": {
"nyc-311-mcp": {
"command": "npx",
"args": [
"-y",
"@betanyc/[email protected]"
],
"env": {
"NYC_311_API_KEY": "<NYC_311_API_KEY>",
"SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>",
"NYC_311_MCP_CACHE_DIR": "<NYC_311_MCP_CACHE_DIR>"
}
}
}
}
{
"mcpServers": {
"nyc-311-mcp": {
"command": "npx",
"args": [
"-y",
"@betanyc/[email protected]"
],
"env": {
"NYC_311_API_KEY": "<NYC_311_API_KEY>",
"SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>",
"NYC_311_MCP_CACHE_DIR": "<NYC_311_MCP_CACHE_DIR>"
}
}
}
}
{
"servers": {
"nyc-311-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@betanyc/[email protected]"
],
"env": {
"NYC_311_API_KEY": "<NYC_311_API_KEY>",
"SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>",
"NYC_311_MCP_CACHE_DIR": "<NYC_311_MCP_CACHE_DIR>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
NYC_311_API_KEYOptional, secret | Free NYC 311 Public API key for the calendar, status, request lookup and reporting tools. The district tools work without it |
SOCRATA_APP_TOKENOptional, secret | Optional NYC Open Data app token, used by the call center report |
NYC_311_MCP_CACHE_DIROptional | Folder for the data cache (about 85 MB of public City data). Defaults to the system cache folder |
Details
| Package | @betanyc/[email protected] (NPM, stdio) |
| First published | 10 Nov 2026 |
| Last updated | 10 Nov 2026 |
| Registry name | io.github.BetaNYC/nyc-311-mcp |
More productivity servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
