# Housing Sentinel

> Housing Sentinel is a freemium MCP server for analytics and data. Official daily housing transaction data and buy/sell signals for 12 Chinese cities. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://housingsentinel.cn
- **Repository:** https://github.com/sheldonzhuang/housing-sentinel-ai
- **MCP Registry name:** cn.housingsentinel/housing-sentinel
- **Categories:** analytics and data, finance and payments
- **Listing updated:** 2026-11-15

## About

Housing Sentinel (房哨兵) collects officially published daily residential transaction and inventory figures from city housing authorities and works out how many months of inventory remain. It then maps that to four market stages: defensive, watch, attack and fast attack. Second-hand inventory turnover is the main signal, and when new-home and second-hand signals conflict, second-hand wins.

Coverage is Shenzhen, Shanghai, Beijing, Guangzhou, Hangzhou, Nanjing, Suzhou, Wuxi, Chengdu, Chongqing, Dongguan and Xiamen. Data updates once a day. The service is also available through a REST API and a Claude skill.

New users get a 3-day trial across all 12 cities; afterwards Shenzhen's current signal stays free, and a points pack costs ¥39 for 1000 calls. An API key is required.

## Features

- **12-city coverage:** Daily new-home and second-hand transactions and inventory.
- **Four-stage signal:** Defensive, watch, attack or fast attack by turnover months.
- **History and metrics:** Daily time series for trend analysis.
- **REST and MCP:** Same data over API, stdio package and remote endpoint.
- **Claude skill:** A skill that teaches how to interpret the signals.
- **Change-driven updates:** Supports since/ETag and webhooks.

## Good for

- Ask which stage Xiamen's market is in
- Compare subscribed cities by closeness to a buying period
- Analyze 90 days of second-hand turnover in Shenzhen
- Feed housing signals into an n8n or Dify workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http housing-sentinel https://api.housingsentinel.cn/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.housingsentinel.cn/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "housing-sentinel": {
      "url": "https://api.housingsentinel.cn/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "housing-sentinel": {
      "type": "http",
      "url": "https://api.housingsentinel.cn/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "housing-sentinel": {
      "serverUrl": "https://api.housingsentinel.cn/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "housing-sentinel": {
      "type": "http",
      "url": "https://api.housingsentinel.cn/mcp"
    }
  }
}
```

## Tools

- `list_cities`: Lists covered cities.
- `get_market_signal`: Gets the current market signal for a city.
- `get_metrics`: Gets daily metric series.
- `get_history`: Gets raw daily transaction history.

## FAQ

### Is there a free option?

Yes: a 3-day all-city trial, then Shenzhen's current signal is free.

### How do I get a key?

Sign in at housingsentinel.cn and generate one under the AI agent access page.

### Which transports exist?

stdio via the housing-sentinel-mcp npm package and streamable HTTP.

### Which cities?

Twelve major Chinese cities including Shenzhen, Shanghai and Chengdu.

### Is Housing Sentinel free?

Housing Sentinel has a free plan, with paid plans for more usage or features.

### How do I add Housing Sentinel to Claude Code?

Run this command in your terminal: claude mcp add --transport http housing-sentinel https://api.housingsentinel.cn/mcp

### What are the best alternatives to Housing Sentinel?

The closest alternatives to Housing Sentinel are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/housing-sentinel
