housing_market_snapshot
Pack: housing-intel · Endpoint: https://gateway.pipeworx.io/housing-intel/mcp
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.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
_fredKey | string | yes | FRED API key (https://fred.stlouisfed.org/docs/api/api_key.html) |
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
{
"_fredKey": "your-housing-intel-api-key"
}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":{"_fredKey":"your-housing-intel-api-key"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('housing_market_snapshot', {
"_fredKey": "your-housing-intel-api-key"
});More examples
{
"_fredKey": "your-housing-intel-api-key",
"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 |
mortgage_rate | object | |
housing_starts | object | |
case_shiller | object | |
unemployment | object | |
owners_equiv_rent | object | |
construction_employment | object | |
metro_hpi | object | null | |
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"
},
"mortgage_rate": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Current 30-year mortgage rate (percent)"
},
"4wk_ago": {
"type": "number",
"description": "Mortgage rate 4 weeks ago"
},
"trend": {
"type": "string",
"enum": [
"rising",
"falling",
"stable"
]
},
"error": {
"type": "string",
"description": "Error message if data unavailable"
}
}
},
"housing_starts": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Latest housing starts in thousands"
},
"unit": {
"type": "string",
"enum": [
"thousands"
]
},
"3mo_trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "ISO date YYYY-MM-DD"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"case_shiller": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Latest Case-Shiller index value"
},
"3mo_trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"unemployment": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Current unemployment rate (percent)"
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"owners_equiv_rent": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Owners' equivalent rent index"
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"construction_employment": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Construction employment in thousands"
},
"unit": {
"type": "string",
"enum": [
"thousands"
]
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"metro_hpi": {
"type": [
"object",
"null"
],
"properties": {
"series": {
"type": "string",
"description": "FRED series ID for metro FHFA HPI"
},
"metro": {
"type": "string",
"description": "Metro name"
},
"current": {
"type": "number",
"description": "Latest metro HPI value"
},
"trend": {
"type": "string",
"enum": [
"rising",
"falling",
"stable"
]
},
"recent_data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"yoy": {
"type": "object",
"properties": {
"change": {
"type": "number",
"description": "Year-over-year absolute change"
},
"pctChange": {
"type": "number",
"description": "Year-over-year percent change"
}
}
},
"error": {
"type": "string"
}
}
},
"zillow": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"metro",
"national"
],
"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",
"null"
],
"description": "ZHVI value in USD"
},
"note": {
"type": "string",
"description": "Description of metric"
}
}
},
"rent_index": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "ZORI value in USD/month"
},
"note": {
"type": "string"
}
}
},
"median_sale_price": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "Weekly median sale price in USD"
},
"note": {
"type": "string"
}
}
},
"sales_count": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "Monthly sales count"
},
"note": {
"type": "string"
}
}
},
"inventory": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "For-sale inventory (smoothed)"
},
"note": {
"type": "string"
}
}
},
"new_listings": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "Monthly new listings"
},
"note": {
"type": "string"
}
}
},
"error": {
"type": "string",
"description": "Error message if Zillow data unavailable"
}
}
}
}
}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.