top_addresses
Rank addresses in a NYC district by 311 request count for a date range, with optional filters for problem type or descriptor to identify repeat-report locations.
Instructions
The addresses in a district with the most requests for a period, optionally for given problems or descriptions. Addresses are as the City spelled them. From BoardStat (BetaNYC, NYC Open Data, 2020 on); not an official City report. 311 counts are reports, not problems; 'closed' is not 'fixed'.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "top_addresses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to list (default 15). | |
| agency | No | Agency code as 311 writes it, e.g. 'NYPD'. | |
| status | No | 'not_closed' = any status but Closed. | |
| to_date | No | End, YYYY-MM-DD, inclusive. | |
| problems | No | BoardStat problem names, e.g. ['HEAT/HOT WATER']; any case. | |
| from_date | No | Start, YYYY-MM-DD, inclusive. | |
| last_days | No | The last N days of data, ending on the newest request's day (not today). | |
| fiscal_year | No | NYC fiscal year: 2027 or 'FY2027' = 2026-07-01 to 2027-06-30. | |
| descriptions | No | 311 descriptors, e.g. ['Blocked Bike Lane']; a missing one is '(none)'. | |
| council_district | No | Council district, 1 to 51. Not with community_district. | |
| community_district | No | 306, BK06 or 'Brooklyn 6' (all forms: server instructions). Not with council_district. | |
| exclude_descriptions | No | Leave out these descriptions instead of keeping only them. |