Homes Mcp
homes.com real-estate for Claude — search, property details, photos, compare, mortgage math
- Transport
- Not stated
- Package
- —
- Registry id
- io.github.chrischall/homes-mcp
No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.
homes.com real-estate access as an MCP server for Claude — search listings, resolve addresses, fetch property details, price/tax history, market reports, saved homes, photo galleries, and run affordability/mortgage math, all via natural language.
⚠️ homes.com does not publish a public consumer API. This server reads the same server-rendered HTML and Schema.org JSON-LD that homes.com itself ships to your browser, routed through your own signed-in browser tab via the fetchproxy extension. Every request acts on behalf of your existing session — your cookies, your TLS, your JS context — exactly as if you'd clicked it in the browser yourself. Treat this as informal use of homes.com. Use at your own discretion.
Tools
| Tool | Purpose |
|---|---|
homes_search_properties |
Search 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. |
homes_get_by_address |
Resolve 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 }. |
homes_resolve_addresses |
Bulk homes_get_by_address (up to 100 addresses, input order preserved, per-row outcomes). Prefer for batches ≥ 3. |
homes_get_property |
Full 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. |
homes_get_property_photos |
Full 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. |
homes_bulk_get |
Fetch up to 200 properties' structured records in one call (per-row errors, input order preserved). |
homes_compare_properties |
Side-by-side comparison of 2–8 properties with an aligned summary table. Per-target errors captured per-row. Concurrent fetches. |
homes_get_nearby_listings |
The "Homes for Sale Near This Property" cross-link cards from a detail page (For Sale, optionally Rentals). URL + address only. |
homes_get_history |
Combined price + tax history in one fetch: listing_events, ownership_events, lien_events, normalized events_normalized, and tax_records. |
homes_get_property_history |
Deprecated — price/ownership/lien timelines only. Prefer homes_get_history. |
homes_get_tax_history |
Deprecated — year-by-year tax records only. Prefer homes_get_history. |
homes_get_market_report |
Median / average / $-per-sqft for a market, derived from the sold search page's JSON-LD. |
homes_get_saved_homes |
The signed-in user's saved (favorited) homes. Auth-gated. |
homes_get_saved_searches |
The signed-in user's saved searches. Auth-gated. |
homes_calculate_affordability |
Local affordability calculator — max purchase price from income + DTI + rates. No network. |
homes_calculate_mortgage |
Local PITI calculator — principal+interest, taxes, insurance, HOA, PMI. No network. |
homes_estimate_rent_vs_buy |
Local rent-vs-buy model — you supply monthly_rent (homes.com has no rental signal to impute it; see below). No network. |
homes_healthcheck |
Round-trips /robots.txt through the fetchproxy bridge (the shared registerBridgeHealthcheckTool from @chrischall/mcp-utils/fetchproxy) and returns |
From the project's README.