# HUD Housing Data

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

- name: com.olyport/hud-housing
- version: 1.1.0
- connection class: R0 (autonomous)
- trust: 72/100 flags: no-repository
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.olyport%2Fhud-housing
- tools: https://api.protogrid.dev/v1/servers/com.olyport%2Fhud-housing/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "hud-housing": {
      "type": "http",
      "url": "https://mcp.olyport.com/hud-housing/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 45
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% -stale-202d -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_public_housing (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_housing_vouchers (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_homeless_data (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 948 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 5, about 948 tokens to load them all
- tool set hash: dff0cdb78d67b06e61f734996cf10277
- badge: [![protogrid quality](https://protogrid.dev/badge/com.olyport/hud-housing.svg)](https://protogrid.dev/servers/com.olyport/hud-housing)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://mcp.olyport.com/hud-housing/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (5)

- `get_fair_market_rents`: Get 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_homeless_data`: Get 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.
    
- `get_housing_vouchers`: Get 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_income_limits`: Get 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_housing`: Get 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).