3 min read

Using the NYC building data MCP tools

Use the Augrented MCP server to query NYC building data: HPD violations, DOB permits, 311, FDNY records, tax liens, evictions, and 22+ other datasets programmatically from your AI agent.

Updated Jun 18, 2026

Using the NYC building data MCP tools

Category: NYC Housing
Read time: 5 minutes
Applies to: NYC buildings only

The Augrented MCP server gives AI coding agents read-only access to every NYC building dataset in the platform — HPD violations, DOB permits, 311 service requests, FDNY fire records, tax liens, evictions, and more. If you can see it on Augrented's web report, your agent can query it programmatically.

What you can do

The NYC-specific MCP tools (nyc_* prefix) cover every major data source in one session. After selecting a building by BBL (Borough-Block-Lot), your agent can:

  • Pull the full building risk profile with violation counts, ownership, and rent-stabilization analysis
  • Fetch recent records from any of 26+ NYC datasets
  • Search landlords and rank their portfolios by HPD violation severity
  • Get detailed profiles on individual code enforcement cases

NYC tool reference

Tool What it returns
nyc_find_buildings(query, limit) Search NYC buildings by address fragment. Returns address, BBL, neighborhood, and a summary of open violation counts.
nyc_get_building_profile(bbl) Full building profile: ownership, physical specs, risk score, rent-stabilization status, premium report availability, and aggregated violation/complaint counts.
nyc_get_building_records(dataset_name, bbl, limit) Recent records from one dataset. See the table below for valid dataset_name values.
nyc_find_landlords(name, limit) Search owners and management companies. Returns ranked portfolio summaries with building counts, total units, and HPD B+C violation totals.
nyc_select_landlord(name) Set this session's landlord for subsequent nyc_list_landlord_buildings calls.
nyc_list_landlord_buildings(landlord_name, limit) A landlord's buildings sorted by HPD class B plus class C violations — the worst properties first.
nyc_get_selected_building() Return the currently selected building's BBL and address.

Available NYC datasets

These are the dataset_name values you can pass to nyc_get_building_records:

Data source Key Agency Est. record range
311 Service Requests service_requests NYC 311 Current year + trailing
HPD Violations housing_maintenance_code_violations HPD 2014–present
HPD Complaints housing_maintenance_code_complaints HPD 2014–present
DOB Violations dob_violations DOB 2008–present
ECB Violations dob_ecb_violations OATH/ECB 2007–present
Building Permits dob_permit_issuance DOB 1990–present
Bedbug Reports bedbug_reporting HPD Annual filings
Sales History sales ACRIS 2000–present
DOB Complaints dob_complaints DOB 2010–present
Rodent Inspections rodent_inspections DOHMH 2015–present
Evictions evictions Housing Court 2017–present
Vacate Orders vacate_orders HPD 2019–present
HPD Litigation hpd_litigation Housing Court 2015–present
AEP / Problem Buildings aep HPD Active list
DOHMH Complaints dohmh_complaints DOHMH 2018–present
HPD Work Orders work_orders HPD 2018–present
Fire Violations fire_violations FDNY No longer updated
Fire Inspections fire_inspections FDNY No longer updated
Fire Certificates fire_certificates FDNY No longer updated
OATH Hearings oath_cases OATH 2013–present
Tax Liens tax_liens NYC Dept of Finance Current fiscal year
Elevator Permits elevator_permits DOB 2009–present

Applies to: NYC buildings only. These datasets are specific to New York City's regulatory framework. SF, LA, and Austin have different agencies and data structures.

Example queries

Find a building and get its profile:

Search for 123 Main Street in Brooklyn and show me the risk profile

Your agent calls nyc_find_buildings to find the BBL, then nyc_get_building_profile to get the full report. The response includes the risk score, number of open HPD violations, ownership entity, and whether the building is rent-stabilized.

Check a specific violation type:

Show me the last 5 HPD violations for 3002140001

Calls nyc_get_building_records(dataset_name="housing_maintenance_code_violations", bbl="3002140001"). Returns the most recent violations with class, status, and original filing date.

Compare landlord portfolios:

Find buildings owned by ABC Management in NYC

Calls nyc_find_landlords(name="ABC Management") followed by nyc_list_landlord_buildings(landlord_name="ABC Management"). The results are ordered by HPD B+C violation count — highest risk first.

Tips

  • BBL is 10 digits — borough (1 digit) + block (5 digits) + lot (4 digits). e.g., Brooklyn block 214 lot 1 = 3002140001
  • Recent records only — get_building_records returns the most recent entries for a dataset. For full history, view the complete building report on the web app
  • Some datasets are locked — evictions, vacate orders, HPD litigation, AEP, and DOHMH complaints return premium-only data via the MCP. The response will indicate if payment is needed
  • Rent stabilization is checked via a separate analysis (pre-1974 construction, 6+ units, RGB registration, tax abatements) — it's included in the building profile but not queryable as a separate dataset

Search any NYC address — free for your first 10 buildings.