Section 8 contract data for AI assistants: MCP server

Add it to your AI assistant

Server URL (Streamable HTTP, no key, read-only):

https://multifamily.deals/mcp

Claude (claude.ai and the desktop app): Settings, then Connectors, then Add custom connector. Paste the URL and save. No sign-in is needed.
ChatGPT: Settings, then Apps and Connectors. Turn on Developer mode under Advanced, choose Create, paste the URL and set authentication to none.
Grok: grok.com, then Connectors, then New connector, then Custom. Paste the URL.
Perplexity: Settings, then Connectors, then Add custom connector, then MCP. Paste the URL and choose no authentication.
Mistral Le Chat: Intelligence, then Connectors, then Add connector, then Custom MCP connector. Paste the URL.

Claude Code:

claude mcp add --transport http multifamily-deals https://multifamily.deals/mcp

Cursor (~/.cursor/mcp.json) and other clients that read mcpServers:

{
  "mcpServers": {
    "multifamily-deals": {
      "url": "https://multifamily.deals/mcp"
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "multifamily-deals": {
      "type": "http",
      "url": "https://multifamily.deals/mcp"
    }
  }
}

Gemini CLI (~/.gemini/settings.json):

{
  "mcpServers": {
    "multifamily-deals": {
      "httpUrl": "https://multifamily.deals/mcp"
    }
  }
}

Menu names change as the apps update. If a step has moved, look for "connectors" or "MCP" in the app's settings.

Tools

Tool	What it returns	Try asking
`expiring_contracts`	Active Section 8 and assistance contracts in a state whose overall or current expiration falls in a date window, filtered by county, city, contract type or size.	Which Section 8 HAP contracts in Ohio expire in the next 12 months?
`screen_below_fmr`	Active HAP contracts whose rent-to-FMR ratio in HUD's file is under a threshold (90% by default), lowest first, with a link to the offer calculator.	Which California Section 8 properties have contract rents well below fair market rent?
`get_property`	One property and every contract on it, by contract number, HUD property ID or name: address, units, program, status, both expiration dates, term and rent-to-FMR ratio.	When does Section 8 contract DE26M000010 expire?
`state_contract_summary`	A state's counts of active contracts, contracts reaching final expiration within two years and HAP contracts under 90% of FMR, or every state ranked.	Which states have the most expiring project-based Section 8 contracts?

Discovery file: /.well-known/mcp.json. For bulk use, every contract is a free CSV and JSON download on Data, downloads and methods.

License and attribution

HUD data is public domain. The compilation is CC BY 4.0: credit "Data: Contract Clock (multifamily.deals)" with a link. Contract Clock is published by Janover Capital LLC and is not affiliated with HUD. Nothing returned is a listing, an appraisal or a loan offer.

Questions people ask

Is there a cost or an API key?

No. The server is free, read-only and needs no key or sign-in. Please cite the multifamily.deals page or the HUD source that comes back with each answer.

Where does the data come from?

HUD's Multifamily Assistance & Section 8 Database, the same contract file the deal screen and the downloads use. Each answer gives the as-of date of the HUD file it read. Owner and management agent names and contacts are in HUD's file but are not republished.

Does an expiring contract mean a property is for sale?

No. Inclusion says nothing about an owner's plans. Most contracts that reach a current expiration are funded again, and the rent-to-FMR ratio is a guide only; renewal rents come from a rent comparability study.

Questions or a data error: hello@multifamily.deals. Privacy and terms.

Section 8 contract expirations as an MCP server

Add it to your AI assistant

Tools

License and attribution

Questions people ask