NYC 311
betanyc/nyc-311-mcp
NYC 311: how to report a problem, district numbers from BoardStat, the 311 calendar and alerts
- GitHub stars
- 2
- tools
- 19
- auth
- Secret needed
- transport
- STDIO
- env vars
- 3
- last updated
- Nov 10, 2026
Tools
19 toolsPublic tool metadata for what this MCP can expose to an agent.
how_to_reportDescribe the problem the way you'd tell a neighbor. It searches the City's 311 articles and gives back the best match: the article title and link on 311 Online, the agency, the 311 problem type, what the City says happens next, and every way to report it.
Describe the problem the way you'd tell a neighbor. It searches the City's 311 articles and gives back the best match: the article title and link on 311 Online, the agency, the 311 problem type, what the City says happens next, and every way to report it.
No parameter schema in public metadata yet.
draft_311_reportWrites a short report you can paste into 311 Online: the problem, where, when, and what you saw. It doesn't fill in anything you didn't tell it.
Writes a short report you can paste into 311 Online: the problem, where, when, and what you saw. It doesn't fill in anything you didn't tell it.
No parameter schema in public metadata yet.
list_311_categoriesBrowse 311's own topics, the same ones on 311 Online, when a match looks wrong or you just want to see what 311 covers.
Browse 311's own topics, the same ones on 311 Online, when a match looks wrong or you just want to see what 311 covers.
No parameter schema in public metadata yet.
find_districtType an address the way you normally would. It tells you the community district and the Council district, and how many 311 requests have been made there since 2020.
Type an address the way you normally would. It tells you the community district and the Council district, and how many 311 requests have been made there since 2020.
No parameter schema in public metadata yet.
district_summaryThe big picture for one district: how many requests, how many aren't closed, how long they take to close, and the top problems.
The big picture for one district: how many requests, how many aren't closed, how long they take to close, and the top problems.
No parameter schema in public metadata yet.
top_problemsThe most-reported problems in a district for any period, next to the same days a year earlier.
The most-reported problems in a district for any period, next to the same days a year earlier.
No parameter schema in public metadata yet.
problem_trendOne problem, month by month, in one district, with the same days a year earlier next to each month.
One problem, month by month, in one district, with the same days a year earlier next to each month.
No parameter schema in public metadata yet.
agency_responseFor each agency: how many requests, how many are closed, and the median and average days to close.
For each agency: how many requests, how many are closed, and the median and average days to close.
No parameter schema in public metadata yet.
still_openRequests that aren't closed yet, oldest first, with how many days each has been open and a count by agency.
Requests that aren't closed yet, oldest first, with how many days each has been open and a count by agency.
No parameter schema in public metadata yet.
top_addressesThe addresses with the most requests in a district, with each one's most common problem.
The addresses with the most requests in a district, with each one's most common problem.
No parameter schema in public metadata yet.
address_historyEvery request at one address since 2020, newest first, with the status explained and the agency's own resolution text.
Every request at one address since 2020, newest first, with the status explained and the agency's own resolution text.
No parameter schema in public metadata yet.
find_requestsEvery request in a district, newest first, a page at a time. Filter by problem, agency, or status, including the City's own statuses like Pending.
Every request in a district, newest first, a page at a time. Filter by problem, agency, or status, including the City's own statuses like Pending.
No parameter schema in public metadata yet.
boardstat_linkMakes a BoardStat link with your district, dates, problem, agency, and status already set, so you can open the map and charts yourself.
Makes a BoardStat link with your district, dates, problem, agency, and status already set, so you can open the map and charts yourself.
No parameter schema in public metadata yet.
boardstat_statusHow fresh BoardStat's data is, and whether last night's build ran late.
How fresh BoardStat's data is, and whether last night's build ran late.
No parameter schema in public metadata yet.
ll47_service_request_reportRebuilds the monthly report on requests for service, formerly Charter § 1075(b): totals by category, agency, and status, and the average and median days to close, for a month and for the fiscal year to date.
Rebuilds the monthly report on requests for service, formerly Charter § 1075(b): totals by category, agency, and status, and the average and median days to close, for a month and for the fiscal year to date.
No parameter schema in public metadata yet.
cb_monthly_listThe list that Charter § 1075(d), still law, says community boards should get: one district's requests for a month, every older request still unresolved, and the ones closed since.
The list that Charter § 1075(d), still law, says community boards should get: one district's requests for a month, every older request still unresolved, and the ones closed since.
No parameter schema in public metadata yet.
ll47_directory_assistance_reportCalls answered by 311 agents, by topic, for a month and the fiscal year to date, formerly Charter § 1075(c).
Calls answered by 311 agents, by topic, for a month and the fiscal year to date, formerly Charter § 1075(c).
No parameter schema in public metadata yet.
get_calendarAlternate side parking, trash and recycling collection, and schools, for a day or up to 90 days.
Alternate side parking, trash and recycling collection, and schools, for a day or up to 90 days.
No parameter schema in public metadata yet.
get_statusWhether Code Blue, a fire hydrant emergency, snow or ice, or an emergency management alert is in effect right now.
Whether Code Blue, a fire hydrant emergency, snow or ice, or an emergency management alert is in effect right now.
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
NYC_311_API_KEYsecretFree NYC 311 Public API key for the calendar, status, request lookup and reporting tools. The district tools work without it
SOCRATA_APP_TOKENsecretOptional NYC Open Data app token, used by the call center report
NYC_311_MCP_CACHE_DIRFolder for the data cache (about 85 MB of public City data). Defaults to the system cache folder
Readme
nyc-311-mcp
An MCP server that connects an AI assistant like Claude to New York City's 311 data. Ask it how to report a problem, what your community district reports most, how fast agencies close requests, or whether alternate side parking is on today. It answers from the City's own data and tells you where each answer came from.
Built by BetaNYC. Free and open source.
See every tool, with real questions and answers: betanyc.github.io/nyc-311-mcp
If this is an emergency, or if you think this is an emergency, call 911. Every answer from every tool ends with this text: "For informational purposes only. BetaNYC builds these answers from City data; they may contain errors. Check the City's 311 page before you report. If this is an emergency, or if you think this is an emergency, call 911."
What's new in 1.3.0
Details
- Repository
- github.com/betanyc/nyc-311-mcp
- Website
- betanyc.github.io/nyc-311-mcp
- Category
- Productivity & Office
- Package
@betanyc/nyc-311-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
