# NYC Property Market: MCP server

> Connect Claude, ChatGPT or any client that supports the Model Context Protocol to New York City property sale figures from official NYC Department of Finance records. Read-only; sign-in with a free account.

**Server URL:** https://nycpropertymarket.com/api/mcp  
**Transport:** Streamable HTTP · **Auth:** OAuth 2.1 (sign-in with a free account; the server answers an unauthenticated request with a standard challenge pointing to its OAuth metadata)  
**License:** Free to use with attribution to NYC Property Market (https://nycpropertymarket.com)

## Connect

- **Claude:** Customize → Connectors → Add custom connector, the name “NYC Property Market” and the server URL. Choose Connect, sign in with Google on this site and approve Claude on the consent screen.
- **Claude Code:** `claude mcp add --transport http nyc-property-market https://nycpropertymarket.com/api/mcp`
- **Cursor and other clients that read an mcp.json file:**

```json
{
  "mcpServers": {
    "nyc-property-market": { "url": "https://nycpropertymarket.com/api/mcp" }
  }
}
```

- **ChatGPT:** add the server URL as a connector where your plan allows custom connectors.

## Tools

| Tool | Returns | Example question |
| --- | --- | --- |
| `market_summary` | New York City or one borough over the trailing 12 months: the median sale price and its year-on-year change, the arm's-length sales count, medians by type and the mix of what sold. | How did Brooklyn sale prices change over the last year? |
| `find_areas` | Looks up neighborhoods by name and returns the identifiers the other tools take, with each one's 12-month median. | Which neighborhoods match “Upper East”? |
| `area_profile` | One neighborhood: 12-month medians by type, the mix of what sold, Census median rent with the gross rent-to-price yield, and the yearly median since 2003. | What do homes in Astoria sell for? |
| `rank_areas` | Ranks neighborhoods by median sale price, by its year-on-year change or by gross rental yield, citywide or in one borough, under the site's sample thresholds. | Which Queens neighborhoods have the highest rental yields? |
| `property_records` | One property by street address or BBL: its recorded deeds since 2003 with prices and arm's-length status, building facts from PLUTO and the city's tax assessment. | What did 350 5th Ave sell for, and when? |
| `monthly_report` | A dated monthly market report, frozen as published, so a figure for a given month can be cited and stays the same. | What did the August 2026 NYC market report say? |

Every result carries its provenance: source, data date, licence, the canonical page and the methodology. Medians below 5 sales are withheld, as on the pages.

## Sign-in and what the application receives

The server is free and requires a free account on this site. The application receives an access token valid for one hour, renewed while you stay connected, and your name and email address as listed on the consent screen. The tools only read published figures; they cannot change your account. To disconnect, remove the connector in the application or delete your account at https://nycpropertymarket.com/my.

## Limits

- Read-only. Every figure the tools return is also published on this site.
- Up to 60 requests per minute per network address; above that, requests are refused for a few minutes.
- The server can be paused, for example automatically if its use would exceed the hosting budget. A paused server answers with status 503.
- Without an account, the same figures are available as https://nycpropertymarket.com/llms.txt, markdown pages such as https://nycpropertymarket.com/market.md and the JSON API at https://nycpropertymarket.com/api.

---

_Not affiliated with the City of New York. Not an appraisal. Methodology: https://nycpropertymarket.com/methodology_