`hud_fair_market_rents`

Pack: hud · Endpoint: https://gateway.pipeworx.io/hud/mcp

Get Fair Market Rent ceilings by bedroom count (0–4+) for a specific area and year. Returns rent limits by bedroom count. Use to set voucher payment standards and rental assistance caps.

Parameters

Name	Type	Required	Description
`state_code`	string	yes	Two-letter state code (e.g., “CA”, “NY”, “TX”). Required to get state-level summary.
`entity_id`	string	no	FIPS code or ZIP code to get FMR for a specific area. Omit to get all areas in the state.
`year`	number	no	Fiscal year (e.g., 2024). Omit for the most recent year.
`_apiKey`	string	yes	HUD API token

Example call

Arguments

{
  "state_code": "CA",
  "_apiKey": "your-hud-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/hud/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hud_fair_market_rents","arguments":{"state_code":"CA","_apiKey":"your-hud-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('hud_fair_market_rents', {
  "state_code": "CA",
  "_apiKey": "your-hud-api-key"
});

More examples

{
  "state_code": "NY",
  "entity_id": "36061",
  "year": 2024,
  "_apiKey": "your-hud-api-key"
}

Response shape

Always returns: state, entity_id, year, data

Field	Type	Description
`state`	string	Two-letter state code provided in request
`entity_id`	string \| null	FIPS or ZIP code if provided, null otherwise
`year`	number \| string	Fiscal year requested or ‘latest’
`data`	object	Fair Market Rent data from HUD API

Full JSON Schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter state code provided in request"
    },
    "entity_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "FIPS or ZIP code if provided, null otherwise"
    },
    "year": {
      "type": [
        "number",
        "string"
      ],
      "description": "Fiscal year requested or 'latest'"
    },
    "data": {
      "type": "object",
      "description": "Fair Market Rent data from HUD API"
    }
  },
  "required": [
    "state",
    "entity_id",
    "year",
    "data"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "hud": {
      "url": "https://gateway.pipeworx.io/hud/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

hud_fair_market_rents