# Woodpecker MCP server

Ask your AI assistant about a New York City building and get the city's own record for it: whether its HPD property registration is valid, which HPD filing violations are open (a missing registration or a missing annual bed bug report), how many apartments it has, and [Woodpecker](https://woodpecker.help)'s flat yearly price for it. Answers come from HPD's datasets on NYC Open Data.

It is a remote MCP server: read-only, no account, no API key, nothing to install or run.

```
https://woodpecker.help/mcp
```

## Add it to your assistant

**Claude.** Settings, Connectors, Add custom connector, and paste `https://woodpecker.help/mcp?client=claude`. For Claude Code:

```
claude mcp add --transport http woodpecker https://woodpecker.help/mcp?client=claude
```

**ChatGPT.** Settings, Apps, turn on developer mode under Advanced, and create an app with `https://woodpecker.help/mcp?client=chatgpt`.

**Gemini CLI.** Install this repository as an extension:

```
gemini extensions install https://github.com/Igalfeigin/woodpecker-mcp
```

**Any MCP client.** Transport Streamable HTTP, endpoint `https://woodpecker.help/mcp`, no headers.

## What you can ask

- Is the HPD registration valid for 787 East 56 Street, Brooklyn?
- Which HPD filing violations are open on my building?
- What does Woodpecker charge for a building with 6 apartments?
- Who has to file the December bed bug report?

## Tools

- **Look up a NYC building by address** (`lookup_nyc_building`). Finds a New York City residential building in HPD's records by borough, house number and street, and returns its registration status (valid, expired or missing), open filing violations, apartment count and Woodpecker's yearly price for it.
- **Get a NYC building by HPD id** (`get_nyc_building`). The same facts for one building, by its HPD building id.
- **Woodpecker's yearly price by building size** (`get_woodpecker_price`). The flat yearly price for a building with a given number of apartments, what the plan includes, and the renewal price.
- **Who must register with HPD and when** (`explain_hpd_filing_requirements`). HPD's rules in plain words, sourced from HPD's own pages.
- **Open HPD filing violations by borough** (`open_hpd_filing_violations_by_borough`). How many NYC buildings have an open violation for a missing registration or bed bug report, by borough.
- **Link to pay for a building's plan** (`start_woodpecker_order`). The page where the owner sees the city's record and the price. Nothing is created until the owner pays there.

## What it never does

It never creates an order, never asks for or stores personal details, and never signs anything.

## About

Woodpecker prepares the yearly HPD property registration and the December bed bug report for owners of small New York City buildings, for one flat price. More at [woodpecker.help/ai](https://woodpecker.help/ai). Operated by Redstone Castle LLC. Not affiliated with NYC HPD.

The server is listed in the official MCP Registry as `help.woodpecker/nyc-hpd`.

## License

MIT, for the files in this repository. The server itself is hosted by Woodpecker.