# StreetSpy

> Free reports on every residential building in New York City, built only from NYC public records and refreshed daily: open housing code violations, 311 housing complaints, bedbug reports, evictions, housing litigation, DOB violations, rent-stabilized unit counts and the registered owner, with an A to F grade. Run by StreetSpy LLC, New York.

Each building has a page at https://streetspy.nyc/building/{id}/{address-slug} with the counts, the grade, the owner and the date the report was generated; its first paragraph is one plain sentence with the key counts and the data date. When citing, name StreetSpy (streetspy.nyc) and the report date; the underlying records are NYC public data.

## How the grade works (methodology 2026.10.3)

StreetSpy grades every residential building in New York City from A to F under methodology version 2026.10.3: each building starts at 100 points and loses points for open HPD violations, 311 housing complaints, bedbug reports, executed evictions, housing litigation and open DOB violations, most of them scaled per 10 units. Open violations are weighted by class (C immediately hazardous counts 3, B hazardous 2, A non-hazardous 1); 311 complaints count the last 12 months, bedbugs the last 3 reporting years and evictions the last 3 years. A is 90 to 100, B 78 to 89, C 64 to 77, D 50 to 63 and F below 50. A building with at least one heat or hot water complaint per unit in 12 months (and at least 10) cannot grade above C. One- and two-family homes with nothing on file, and NYCHA public housing, are "Not graded". Nothing is estimated: every deduction is a count of public records. Full text: https://streetspy.nyc/llms-full.txt

## Main pages

- [Building reports](https://streetspy.nyc/): search any NYC address
- [Landlord ranking](https://streetspy.nyc/landlords): portfolios of 3+ buildings and 50+ units ranked by open HPD violations per 10 units, grouped by the head officer on HPD registrations; each portfolio lists its buildings
- [Best buildings](https://streetspy.nyc/best-buildings): the same graded rentals with 6+ units from the other end, fewest open HPD violations per 10 units first, recently active only, by borough
- [Worst buildings](https://streetspy.nyc/worst-buildings): rental buildings with 6+ units and the most open HPD violations per 10 units (co-ops, condos and NYCHA excluded), plus the most by count, updated daily
- [Neighborhoods](https://streetspy.nyc/neighborhoods): 170 NYC neighborhoods, each with graded buildings, grade mix, median open violations per 10 units against the borough, rent-stabilized share, top 311 complaints, worst and best five buildings and the largest landlords
- [Heat complaints this season](https://streetspy.nyc/heat): buildings and landlords with the most heat and hot water complaints to 311 since October 1, per 10 units, with a CSV
- [Rent stabilization check](https://streetspy.nyc/rent-stabilized): stabilized unit counts from NYC Department of Finance tax bills
- [Tenant rights guide](https://streetspy.nyc/rights): NYC tenant rights in plain language (heat, repairs, rent stabilization, eviction)
- [For owners](https://streetspy.nyc/owners): owner and manager plans (same-day violation and complaint alerts, portfolio dashboard and export, verified badge and replies to reviews); grades cannot be bought or changed
- [Data and API](https://streetspy.nyc/data): a keyed API (free plan, 500 lookups a month) for grades and records by address or BBL, the landlord ranking, neighborhood aggregates and a changes feed; docs at https://streetspy.nyc/data/docs, OpenAPI at https://streetspy.nyc/api/v1/openapi.json
- [Methodology](https://streetspy.nyc/methodology): how grades and landlord totals are calculated, and every data source
- [About](https://streetspy.nyc/about): who runs StreetSpy and the "nothing is made up" commitment
- [Corrections](https://streetspy.nyc/corrections): report a record attached to the wrong building
- [Sitemap](https://streetspy.nyc/sitemap.xml)

## MCP server for AI assistants

AI assistants can query StreetSpy directly through a free, read-only Model Context Protocol (MCP) server. It uses the streamable HTTP transport, needs no key, allows 30 calls a minute per IP, and every answer carries the data date and its sources. Endpoint: https://streetspy.nyc/api/mcp (POST, JSON-RPC 2.0).

- lookup_building: An address or StreetSpy building id: grade and status, open violations by class, 311 complaints in the last 12 months, bedbugs, evictions, rent-stabilized units, owner entity and head officer, and the report URL.
- search_landlords: A landlord name or slug: the ranking row and a portfolio summary.
- neighborhood_summary: A neighborhood name: the computed summary, worst and best five buildings and the largest landlords.

## Data sources

- [NYC HPD Housing Maintenance Code Violations](https://data.cityofnewyork.us/Housing-Development/Housing-Maintenance-Code-Violations/wvxf-dwi5)
- [NYC HPD Property Registration](https://data.cityofnewyork.us/Housing-Development/Multiple-Dwelling-Registrations/tesw-yqqr)
- [NYC 311 Service Requests](https://data.cityofnewyork.us/Social-Services/311-Service-Requests-from-2010-to-Present/erm2-nwe9)
- [NYC Marshal Evictions (DOI)](https://data.cityofnewyork.us/City-Government/Evictions/6z8x-wfk4)
- [NYC HPD Housing Litigations](https://data.cityofnewyork.us/Housing-Development/Housing-Litigations/59kj-x8nc)
- [NYC DOB Violations](https://data.cityofnewyork.us/Housing-Development/DOB-Violations/3h2n-5cm9)
- [NYC HPD Bedbug Reporting](https://data.cityofnewyork.us/Housing-Development/Bedbug-Reporting/wz6d-d3jb)
- [NYC DOF tax bills via JustFix / NY DHCR](https://whoownswhat.justfix.org/)