Skip to content
MCP server

Housing Sentinel

Official daily housing transaction data and buy/sell signals for 12 Chinese cities

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
1.3.0
Listing updated
2 days ago

About Housing Sentinel

Housing Sentinel is a freemium MCP server for analytics and data. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.housingsentinel.cn/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "housing-sentinel": {
      "url": "https://api.housingsentinel.cn/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • HOUSING_SENTINEL_API_KEYAPI Key(hs_live_...),登录 housingsentinel.cn「我的→接入AI Agent」生成;新用户 3 天全 12 城免费试用Required
  • HOUSING_SENTINEL_URL可选:覆盖 MCP 端点,默认 https://api.housingsentinel.cn/mcp(中国大陆可用 https://housingpi-proxy-anirmyfaea.cn-shanghai.fcapp.run/mcp)

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

3-day trial; Shenzhen signal free; points pack ¥39 per 1000 calls

Prices change. Check housingsentinel.cn before you buy.

Housing Sentinel 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 to Housing Sentinel

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments