housing_market_snapshot
Pack: housing-intel · Endpoint: https://gateway.pipeworx.io/housing-intel/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/housing_market_snapshot for the schema, then POST the same URL with its arguments for the data.
Get national housing market overview: mortgage rates, housing starts, Case-Shiller index, unemployment, construction employment. Optionally add metro-level prices (e.g., “Denver”, “Atlanta”). For comparing Case-Shiller across multiple metros use case_shiller_metro_compare instead. THE COMPONENTS DO NOT SHARE A DATE — they are weekly, monthly and quarterly official statistics, each published on its own lag, so one call can span months of vintages. freshness states the span in days and names the oldest component; read it before comparing components against each other.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
_fredKey | string | no | FRED API key (https://fred.stlouisfed.org/docs/api/api_key.html) |
_blsKey | string | no | BLS registration key (optional — raises the shared quota; https://data.bls.gov/registrationEngine/) |
metro_name | string | no | Metro area name for metro-level FHFA HPI (e.g., “Denver”, “Atlanta”). Supports top 50 US metros. National data is always included. |
Example call
Arguments
{}curl
curl -X POST https://gateway.pipeworx.io/housing-intel/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"housing_market_snapshot","arguments":{}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('housing_market_snapshot', {});More examples
{
"metro_name": "Denver"
}Response shape
| Field | Type | Description |
|---|---|---|
snapshot_date | string | Today’s date in YYYY-MM-DD format |
metro | string | Metro name or ‘National’ |
note | string | Explanation of data scope and sources |
freshness | object | |
mortgage_rate | object | |
housing_starts | object | |
case_shiller | object | |
unemployment | object | |
owners_equiv_rent | object | |
construction_employment | object | |
metro_hpi | null | object | |
zillow | object |
Full JSON Schema
{
"type": "object",
"properties": {
"snapshot_date": {
"type": "string",
"description": "Today's date in YYYY-MM-DD format"
},
"metro": {
"type": "string",
"description": "Metro name or 'National'"
},
"note": {
"type": "string",
"description": "Explanation of data scope and sources"
},
"freshness": {
"type": "object",
"properties": {
"as_of": {
"type": "string"
},
"span_days": {
"type": "number"
},
"oldest_component": {
"type": "string"
},
"oldest_observation_date": {
"type": "string"
},
"oldest_age_days": {
"type": "number"
},
"newest_component": {
"type": "string"
},
"newest_observation_date": {
"type": "string"
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"component": {
"type": "string"
},
"observation_date": {
"type": "string"
},
"age_days": {
"type": "number"
},
"cadence": {
"type": "string"
}
}
}
},
"components_without_a_date": {
"type": "array",
"items": {
"type": [
null,
"string"
]
}
},
"statement": {
"type": "string"
}
}
},
"mortgage_rate": {
"type": "object",
"properties": {
"scope": {
"type": "string"
},
"observation_date": {
"type": "string"
},
"current": {
"type": "number",
"description": "Current 30-year mortgage rate (percent)"
},
"4wk_ago": {
"type": "number",
"description": "Mortgage rate 4 weeks ago"
},
"4wk_ago_date": {
"type": "string"
},
"trend": {
"type": "string"
},
"cadence": {
"type": "string"
}
}
},
"housing_starts": {
"type": "object",
"properties": {
"scope": {
"type": "string"
},
"observation_date": {
"type": "string"
},
"current": {
"type": "number",
"description": "Latest housing starts in thousands"
},
"unit": {
"type": "string"
},
"3mo_trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "ISO date YYYY-MM-DD"
},
"value": {
"type": "number"
}
}
}
},
"cadence": {
"type": "string"
}
}
},
"case_shiller": {
"type": "object",
"properties": {
"scope": {
"type": "string"
},
"observation_date": {
"type": "string"
},
"current": {
"type": "number",
"description": "Latest Case-Shiller index value"
},
"3mo_trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"cadence": {
"type": "string"
},
"smoothing": {
"type": "string"
}
}
},
"unemployment": {
"type": "object",
"properties": {
"scope": {
"type": "string"
},
"observation_date": {
"type": "string"
},
"current": {
"type": "number",
"description": "Current unemployment rate (percent)"
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"cadence": {
"type": "string"
},
"error": {
"type": "string"
}
}
},
"owners_equiv_rent": {
"type": "object",
"properties": {
"scope": {
"type": "string"
},
"observation_date": {
"type": "string"
},
"current": {
"type": "number",
"description": "Owners' equivalent rent index"
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"cadence": {
"type": "string"
},
"error": {
"type": "string"
}
}
},
"construction_employment": {
"type": "object",
"properties": {
"scope": {
"type": "string"
},
"observation_date": {
"type": "string"
},
"current": {
"type": "number",
"description": "Construction employment in thousands"
},
"unit": {
"type": "string"
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"cadence": {
"type": "string"
},
"error": {
"type": "string"
}
}
},
"metro_hpi": {
"type": [
"null",
"object"
],
"properties": {
"series": {
"type": "string"
},
"metro": {
"type": "string"
},
"observation_date": {
"type": "string"
},
"cadence": {
"type": "string"
},
"current": {
"type": "number"
},
"trend": {
"type": "string"
},
"recent_data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"yoy": {
"type": "object",
"properties": {
"change": {
"type": "number"
},
"pctChange": {
"type": "number"
}
}
}
}
},
"zillow": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"description": "Whether data is metro-specific or national"
},
"region": {
"type": "string",
"description": "Region name (CBSA label or 'National')"
},
"home_value_index": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "ISO date of observation"
},
"value": {
"type": "number",
"description": "ZHVI value in USD"
},
"note": {
"type": "string",
"description": "Description of metric"
}
}
},
"rent_index": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number",
"description": "ZORI value in USD/month"
},
"note": {
"type": "string"
}
}
},
"median_sale_price": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number",
"description": "Weekly median sale price in USD"
},
"note": {
"type": "string"
}
}
},
"sales_count": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number",
"description": "Monthly sales count"
},
"note": {
"type": "string"
}
}
},
"inventory": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number",
"description": "For-sale inventory (smoothed)"
},
"note": {
"type": "string"
}
}
},
"new_listings": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number",
"description": "Monthly new listings"
},
"note": {
"type": "string"
}
}
}
}
}
}
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"housing-intel": {
"url": "https://gateway.pipeworx.io/housing-intel/mcp"
}
}
}See Getting Started for client-specific install steps.