NestDaddy

NYC 311

io.github.BetaNYC/nyc-311-mcp · v1.2.0

NYC 311: how to report a problem, district numbers from BoardStat, the 311 calendar and alerts

Connect Runs on your machine

Terminal
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]
claude_desktop_config.json
{
  "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>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "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>"
      }
    }
  }
}
.vscode/mcp.json
{
  "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

NameDescription
NYC_311_API_KEY
Optional, secret
Free NYC 311 Public API key for the calendar, status, request lookup and reporting tools. The district tools work without it
SOCRATA_APP_TOKEN
Optional, secret
Optional NYC Open Data app token, used by the call center report
NYC_311_MCP_CACHE_DIR
Optional
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 published10 Nov 2026
Last updated10 Nov 2026
Registry nameio.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.