`housing_mortgage_history`

Pack: housing-intel · Endpoint: https://gateway.pipeworx.io/housing-intel/mcp

Freddie Mac Primary Mortgage Market Survey — weekly US mortgage rates back to 1971. Returns the latest snapshot, a time series for the requested window, and min/max/avg stats. Sourced from Freddie Mac directly (not FRED), ingested weekly by the Pipeworx data pipeline.

Parameters

Name	Type	Required	Description
`window`	string	no	1m \| 3m \| 6m \| 1y \| 5y \| all (default 1y)
`as_of`	string	no	Optional YYYY-MM-DD — returns the rate for the closest observation on or before that date instead of the latest.

Example call

Arguments

{
  "window": "1y"
}

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_mortgage_history","arguments":{"window":"1y"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('housing_mortgage_history', {
  "window": "1y"
});

More examples

{
  "window": "5y",
  "as_of": "2024-01-15"
}

Response shape

Field	Type	Description
`latest`	object
`as_of_snapshot`	object
`window`	string	Time window requested (1m, 3m, 6m, 1y, 5y, all)
`time_series`	array	Historical mortgage rates in chronological order
`stats`	object

Full JSON Schema

{
  "type": "object",
  "properties": {
    "latest": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "description": "ISO date of latest observation"
        },
        "rate_30yr": {
          "type": [
            "number",
            "null"
          ],
          "description": "30-year fixed mortgage rate (percent)"
        }
      }
    },
    "as_of_snapshot": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "description": "Closest observation on or before requested as_of date"
        },
        "rate_30yr": {
          "type": [
            "number",
            "null"
          ],
          "description": "30-year fixed mortgage rate (percent)"
        }
      }
    },
    "window": {
      "type": "string",
      "description": "Time window requested (1m, 3m, 6m, 1y, 5y, all)"
    },
    "time_series": {
      "type": "array",
      "description": "Historical mortgage rates in chronological order",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "ISO date of observation"
          },
          "rate_30yr": {
            "type": [
              "number",
              "null"
            ],
            "description": "30-year fixed mortgage rate (percent)"
          }
        }
      }
    },
    "stats": {
      "type": "object",
      "properties": {
        "min": {
          "type": [
            "number",
            "null"
          ],
          "description": "Minimum rate in window (percent)"
        },
        "max": {
          "type": [
            "number",
            "null"
          ],
          "description": "Maximum rate in window (percent)"
        },
        "avg": {
          "type": [
            "number",
            "null"
          ],
          "description": "Average rate in window (percent)"
        }
      }
    }
  }
}

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.

housing_mortgage_history