# NYC Property & Venue Intelligence API

Official NYC property, building, and venue intelligence for AI agents. Use when the user is asking about a specific NYC address, landlord or building risk, open violations or complaints, or restauran…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add matchuplabs/nyc-property-venue

# Browse available tools
npx -y @smithery/cli@latest tool list matchuplabs/nyc-property-venue

# Get full schema for a tool
npx -y @smithery/cli@latest tool get matchuplabs/nyc-property-venue resolve_property_identifier

# Call a tool
npx -y @smithery/cli@latest tool call matchuplabs/nyc-property-venue resolve_property_identifier '{}'
```

## Direct MCP Connection

Endpoint: `https://nyc-property-venue--matchuplabs.run.tools`

**Required config:**
- `apiKey` (query) — Your NYC API key from nycapi.app

**Optional config:**
- `baseUrl` (query) — Base URL for the NYC API (optional)

## Tools (4)

- `resolve_property_identifier` — Normalize and validate a NYC property identifier. Pass a partial address, BBL, or BIN and get back the normalized addre…
- `get_property_intelligence` — Get a full property intelligence profile for a NYC property. Returns owner, zoning, assessment, and violation counts. O…
- `get_building_violations` — Get building violation records for a NYC property. Returns DOB violations, OATH/ECB violations (fines & penalties), HPD…
- `get_restaurant_venue_intel` — Get health inspection and compliance data for a NYC restaurant or venue. Returns current health grade, inspection score…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get matchuplabs/nyc-property-venue <tool-name>
```

## Resources

- `nyc-api://capability-guide` — Explains what each tool does, when to use it, and the recommended decision tree for NYC property/building/venue questio…
- `nyc-api://input-formatting` — Explains NYC address formats, BBL/BIN identifiers, and borough values accepted by the tools.
- `nyc-api://schema-examples` — JSON input/output examples for each tool, including both success and error responses.
- `nyc-api://coverage-notes` — Explains data sources, what each covers, refresh cycles, and limitations including rent stabilization caveats.
- `nyc-api://credit-policy` — Explains credit costs per tool, detail flags, and best practices to minimize usage.