# NYC Government & Property AI Agent Connect

> NYC Government & Property MCP gives your AI client direct access to keyless New York City datasets. You can pull city payroll records, search City Council legislation, look up property assessments by BBL, and find open job postings or city-owned property details without needing an API key.

## Overview
- **Category:** government-public-data
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_juJQCqZFpf9AO5eZeYHjz8jtxE4krxLErfcw38m1/ai-agent-connect
- **Tags:** new-york, nyc, payroll, council, civil-list, property, assessments, city-record, jobs

## Description

You can now query New York City's public datasets directly through your agent. This MCP connects your AI client to massive datasets including citywide payroll, property valuations, and legislative records. Instead of manually searching through web portals, you can ask your agent to find specific employee salary data from 2014 to 2025 or pull the latest City Council bills. 

If you are analyzing real estate, you can use the BBL to pull specific property assessments or search for city-owned parcels. For those tracking municipal spending or employment, the tool provides access to agency payroll counts, job postings, and recent City Record notices. It handles the heavy lifting of querying the NYC Open Data infrastructure, allowing you to focus on the analysis rather than data retrieval.

## Tools

### count_city_payroll
This tool counts NYC payroll records for a specific agency and fiscal year. Use it to quickly determine the size of an agency's workforce.

### search_council_bills
This tool searches NYC City Council bills and local laws. You can filter results by matter ID, status, sponsor, or committee.

### list_city_job_postings
This tool lists open NYC city job postings. It provides details like salary ranges, agency, and career level, showing the most recent posts first.

### list_city_record_notices
This tool retrieves recent City Record notices by agency. It defaults to a 90-day window to keep results current.

### list_civil_list
This tool lists NYC civil list appointees, including judges and civil officers. You can filter by name, department, or calendar year.

### search_city_owned_property
This tool searches for city-owned or leased property (COLP) parcels. You can filter by agency code, use type, or community district.

### search_city_payroll
This tool searches NYC citywide payroll records for employee salaries. It covers fiscal years from 2014 to 2025.

### search_property_assessments
This tool looks up NYC property valuation and assessment records using a 10-digit BBL. It provides owner info, tax class, and valuation history.

## Prompt Examples

**Prompt:** 
```
How many employees does the Department of Education have in FY 2025?
```

**Response:** 
```
The count_city_payroll tool for fiscal year 2025 and agency 'DEPT OF EDU' shows the total number of employees for that department.
```

**Prompt:** 
```
What is the assessed value of BBL 1-00016-3859?
```

**Response:** 
```
Using search_property_assessments with BBL 1-00016-3859, I found the owner, building class, and valuation history for that specific lot.
```

**Prompt:** 
```
List recent City Record contract award notices.
```

**Response:** 
```
The list_city_record_notices tool shows recent notices from the last 90 days, including agency names and notice types.
```

## Capabilities

### Payroll Auditing
Your agent uses payroll tools to count employees or check specific salary records by fiscal year.

### Real Estate Research
The agent pulls property assessments and city-owned parcel data using BBL or agency codes.

### Legislative Tracking
Your agent searches for City Council bills and local laws to monitor legislative status.

### Employment Monitoring
The agent lists open city job postings and civil service appointments.

### Procurement Oversight
Your agent retrieves City Record notices to track contract awards and public notices.

## Use Cases

### Salary Benchmarking
Compare agency payroll and salary ranges across different fiscal years.

### Property Due Diligence
Verify the assessed value and ownership of a specific lot using its BBL.

### Legislative Monitoring
Track the progress of specific bills or local laws through the City Council.

### Job Market Analysis
Monitor open city job postings and salary levels across various agencies.

## Benefits

- Eliminates the need for manual API key management.
- Provides direct access to large datasets like payroll without manual filtering.
- Uses BBL codes to pinpoint specific property tax and valuation data.
- Offers a 90-day default window for recent procurement notices.

## How It Works

Connecting to this MCP gives your AI client immediate access to NYC's public data infrastructure.

1. Subscribe to the NYC Government & Property MCP on Vinkius.
2. Connect your preferred MCP-compatible client like Claude or Cursor.
3. Ask your agent a specific question about NYC data.
4. The agent invokes the necessary tool to query the NYC Open Data source.
5. The agent receives the raw data and presents the answer to you.

## Frequently Asked Questions

**Do I need an API key to use this NYC data?**
No. This MCP provides keyless access to the datasets, so you don't need to manage your own credentials.

**How do I look up a property?**
You need the 10-digit Borough-Block-Lot (BBL) code. You can provide it with or without dashes.

**What years of payroll data are available?**
The payroll dataset includes records for fiscal years ranging from 2014 to 2025.

**How recent are the City Record notices?**
The tool defaults to a 90-day window for recent notices, but you can specify a start date.

**Can I filter job postings by salary?**
Yes, the job posting tool provides salary ranges and allows filtering by agency, category, and level.

**Do I need an API key?**
No. NYC Open Data serves all public datasets anonymously over its SODA API (data.cityofnewyork.us). This MCP defines no credentials and needs nothing configured.

**Which fiscal years does the payroll data cover?**
Fiscal years 2014–2025. Both payroll tools default to FY 2025 when omitted. The full payroll table is over half a million rows per year, so every count is scoped to a fiscal year (plus optionally an agency) — the dataset itself is never scanned in full.

**What is the BBL format?**
The 10-digit borough-block-lot code, e.g. "1-00016-3859". Dashes are optional and stripped; search_property_assessments validates the code before querying and returns a clear error for a malformed BBL.