About io.github.chrischall/homes-mcp
io.github.chrischall/homes-mcp is an MCP server published by chrischall in the Search category: homes.com real-estate for Claude — search, property details, photos, compare, mortgage math.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add io-github-chrischall-homes-mcp -- npx -y homes-mcpnpx -y homes-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (18)
homes_bulk_getFetch up to 200 properties' structured records in one call (per-row errors, input order preserved).
Parameters not published.
homes_calculate_affordabilityLocal affordability calculator — max purchase price from income + DTI + rates. No network.
Parameters not published.
homes_calculate_mortgageLocal PITI calculator — principal+interest, taxes, insurance, HOA, PMI. No network.
Parameters not published.
homes_compare_propertiesSide-by-side comparison of 2–8 properties with an aligned summary table. Per-target errors captured per-row. Concurrent fetches.
Parameters not published.
homes_estimate_rent_vs_buyLocal rent-vs-buy model — you supply `monthly_rent` (homes.com has no rental signal to impute it; see below). No network.
Parameters not published.
homes_get_by_addressResolve one US street address to its canonical homes.com property URL + opaque hash. Walks structured typeahead → slug → city/zip search-fallback with whole-token street + unit verification. Returns `matched_via`; degrades to `{ resolved: false }`.
Parameters not published.
homes_get_historyCombined price + tax history in one fetch: `listing_events`, `ownership_events`, `lien_events`, normalized `events_normalized`, and `tax_records`.
Parameters not published.
homes_get_market_reportMedian / average / $-per-sqft for a market, derived from the `sold` search page's JSON-LD.
Parameters not published.
homes_get_nearby_listingsThe "Homes for Sale Near This Property" cross-link cards from a detail page (For Sale, optionally Rentals). URL + address only.
Parameters not published.
homes_get_propertyFull record for a property by URL. Parses JSON-LD + DOM-side sections: address, lat/lng, beds/baths, sqft, year built, price, status, agent + brokerage, highlights, schools, HOA (raw + monthly), lot size (sqft + acres), parking, heating/cooling, MLS id/source, tax, days-on-market, price drops, `extracted_features`. Optional inline `price_history`/`tax_history`.
Parameters not published.
Show all 18 tools
homes_get_property_history*Deprecated* — price/ownership/lien timelines only. Prefer `homes_get_history`.
Parameters not published.
homes_get_property_photosFull photo gallery scraped from `<img>` tags on the detail page (JSON-LD only carries one image). Returns `{ url, position, alt? }` per photo, filtered to the homes.com CDN.
Parameters not published.
homes_get_saved_homesThe signed-in user's saved (favorited) homes. Auth-gated.
Parameters not published.
homes_get_saved_searchesThe signed-in user's saved searches. Auth-gated.
Parameters not published.
homes_get_tax_history*Deprecated* — year-by-year tax records only. Prefer `homes_get_history`.
Parameters not published.
homes_healthcheckRound-trips `/robots.txt` through the fetchproxy bridge (the shared `registerBridgeHealthcheckTool` from `@chrischall/mcp-utils/fetchproxy`) and returns diagnostics: bridge role/port/version, the extension link state (`bridge.session_state`, `pending_pair_code`, `extension_connected`), a classified `error.kind` (`timeout` / `bridge_down` / `session_not_ready` / `protocol` / `unknown`), and a plain-English hint distinguishing "bridge down" from "extension not connected / pair code pending" from "homes.com-side problem."
Parameters not published.
homes_resolve_addressesBulk `homes_get_by_address` (up to 100 addresses, input order preserved, per-row outcomes). Prefer for batches ≥ 3.
Parameters not published.
homes_search_propertiesSearch listings by free-text location (city/ZIP/neighborhood). Slugifies the input into homes.com's URL routing and parses the JSON-LD `CollectionPage.mainEntity.itemListElement[]`. Filters by `property_type`, `listing_type`, `sort`, and a `price_min`/`price_max` band. Returns address, price, beds/baths, sqft, primary photo, listing agent + brokerage; flags `truncated`/`total_estimated` past the ~40-listing SSR cap.
Parameters not published.
Ask AI
Ask AI about io.github.chrischall/homes-mcp
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.