`hud_income_limits`

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

Check income eligibility thresholds (extremely low, very low, low-income) for HUD programs by area and family size. Returns income limits by category. Use to determine program qualification.

Parameters

Name	Type	Required	Description
`state_code`	string	yes	Two-letter state code (e.g., “CA”, “NY”).
`entity_id`	string	no	FIPS code or metro area code 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": "TX",
  "_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_income_limits","arguments":{"state_code":"TX","_apiKey":"your-hud-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "state_code": "CA",
  "entity_id": "06037",
  "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 code or metro area code if provided, null otherwise
`year`	number \| string	Fiscal year requested or ‘latest’
`data`	object	Income limits 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 code or metro area code if provided, null otherwise"
    },
    "year": {
      "type": [
        "number",
        "string"
      ],
      "description": "Fiscal year requested or 'latest'"
    },
    "data": {
      "type": "object",
      "description": "Income limits 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_income_limits