OpenStoop MCP Server

NYC building health data for AI assistants. Look up safety grades, violations, and health scores for 858,000+ residential buildings in New York City.

Quick Start

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "openstoop": {
      "command": "npx",
      "args": ["-y", "@openstoop/mcp-server"],
      "env": {
        "OPENSTOOP_API_KEY": "your-api-key"
      }
    }
  }
}

Run locally (development)

cd mcp
npm install
OPENSTOOP_API_URL=http://localhost:3000 OPENSTOOP_API_KEY=sk_... npx tsx src/index.ts

Tools

lookup_building

Look up the health grade and safety information for any NYC building.

Input: Address or 10-digit BBL number

"123 Main St Brooklyn" or "3012340056"

Returns: Grade (A-F), health score, violation counts, component breakdown, safety flags, and link to full report on openstoop.com.

search_buildings

Search for NYC buildings by partial address.

Input: Address search query

"riverside drive manhattan"

Returns: List of matching buildings with grades and links.

Environment Variables

| Variable | Required | Default | Description | |----------|:--------:|---------|-------------| | OPENSTOOP_API_KEY | Yes | — | Enterprise API key | | OPENSTOOP_API_URL | No | https://api.openstoop.com | API base URL |

Data Coverage

• 858,000+ NYC residential buildings
• 70M+ public records from 26 NYC agency sources
• A-F letter grades based on violations, complaints, building safety, management quality, financial health, maintenance, and legal enforcement
• Updated daily from NYC Open Data

About OpenStoop

OpenStoop scores every residential building in New York City using public data from HPD, DOB, DOF, FDNY, and other city agencies. Learn more at openstoop.com.