HUD Housing Data

Fair Market Rents, income limits, public housing, vouchers, and homeless counts

CommunityDegradedNo sign-inGlobalFreeRead-only

What it can do

    What data it sees

    Do you need an account

    No: the server works without sign-in

    Fair Market Rents, income limits, public housing, vouchers, and homeless counts

    How to connect

    How to connect HUD Housing Data to Claude

    The server address to paste into Claude settings:

    https://mcp.olyport.com/hud-housing/mcp

    1. Open Claude (claude.ai or the desktop app).
    2. Go to Settings → Connectors.
    3. Click Add custom connector.
    4. Paste the server address copied below into Remote MCP server URL and click Add.
    5. In a chat, click + → Connectors and switch the new connector on.

    Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

    Authorization

    After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

    How to connect HUD Housing Data to ChatGPT

    The server address to paste into ChatGPT settings:

    https://mcp.olyport.com/hud-housing/mcp

    1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
    2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
    3. Open Settings → Connectors and click Create.
    4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
    5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
    6. In a new chat open + → Apps/Connectors and enable the connector.

    OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

    Authorization

    On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

    How to connect HUD Housing Data to Cursor

    The server address to paste into Cursor settings:

    https://mcp.olyport.com/hud-housing/mcp

    Fastest: click Open in Cursor below and confirm the prompt.

    Manually:

    1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
    2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
    3. Save the file. The server appears in the MCP list; authorize it there if asked.

    Authorization

    If the service needs sign-in, an authorize button appears next to the server in the MCP list.

    Server tool list (5)

    Raw names from tools/list. Only developers need these.

    get_fair_market_rentsGet HUD Fair Market Rent (FMR) values for 0-4 bedroom units. Returns FMR data used to determine Housing Choice Voucher payment standards and other HUD program parameters. Requires HUD User API token; returns registration guidance if token is not configured. Args: state: Two-letter US state abbreviation (e.g. 'CA', 'WA'). county_fips: Optional 5-digit county FIPS code (e.g. '06037' for LA County). If omitted, returns statewide FMR data. year: FMR fiscal year (default 2024).
    get_income_limitsGet HUD income limits (very low, low, median) by family size. Returns income limit data used to determine eligibility for HUD assisted housing programs. Requires HUD User API token. Args: state: Two-letter US state abbreviation (e.g. 'CA', 'NY'). county_fips: Optional 5-digit county FIPS code (e.g. '06037'). If omitted, returns data for all areas in the state. year: Income limit fiscal year (default 2024).
    get_public_housingGet public housing buildings and developments in a state. Queries HUD's open ArcGIS data for public housing inventory. No API key required. Returns building names, addresses, unit counts, and managing Public Housing Agency information. Args: state: Two-letter US state abbreviation (e.g. 'WA', 'TX'). city: Optional city name to filter results. limit: Maximum number of records to return (default 50, max 500).
    get_housing_vouchersGet Housing Choice Voucher (Section 8) program data by Public Housing Agency. Returns information about voucher programs administered by PHAs in the specified state, including total vouchers, utilization rates, and spending. Queries HUD ArcGIS open data (no auth required). Args: state: Two-letter US state abbreviation (e.g. 'CA', 'NY'). limit: Maximum number of records to return (default 50, max 500).
    get_homeless_dataGet Point-in-Time (PIT) homeless count data by Continuum of Care region. Returns homeless population counts from the annual PIT count, broken down by sheltered/unsheltered status and sub-populations. Data sourced from HUD Exchange via ArcGIS open data. No API key required. Args: state: Two-letter US state abbreviation (e.g. 'CA', 'WA'). At least one of state or coc_code must be provided. coc_code: Optional Continuum of Care code (e.g. 'WA-500', 'CA-600'). year: Optional year to filter results.