Log inSubmit server
Homes MCP logo

Homes MCP

Accesses homes.com listings, property records, histories, photos, saved data, market metrics, and local real-estate calculators through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Homes MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "homes-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "homes-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 21 tools correctly (1d ago).

Overview

  • real-estate
  • homes-com
  • property-search
  • mortgage

The homes-mcp MCP server connects an MCP client to homes.com through the ContextMint Bridge browser extension. It searches listings, resolves addresses, retrieves property records, photos, histories, market reports, saved homes, and saved searches, while also providing local affordability, mortgage, and rent-versus-buy calculations. Use it when an agent needs homes.com data from an existing signed-in browser session rather than a public API. The server reads server-rendered HTML, Schema.org JSON-LD, and selected page elements, so homes.com page changes can affect results.

Use cases

  • Search listings by city, ZIP code, or neighborhood
  • Compare several homes using aligned property fields
  • Review price, ownership, lien, and tax history
  • Calculate mortgage and affordability scenarios
  • Resolve address lists into canonical homes.com property URLs

Key features

  • homes.com listing and property search
  • Bulk address and property retrieval
  • Property photos and comparison tables
  • Price, tax, ownership, and lien history
  • Market reports and saved-home access
  • Local mortgage and affordability calculations

Tools21

What Homes MCP lets your agent do. Expand a tool for its parameters.

Verified live~8.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

8/8 checks healthy over the last 45d

What it can do

From the 21 tools this server returned when we ran it; 21 declare their own safety hints.

Handles credentials · 2Makes network requests · 16Read-only tools · 21
Network at startup3 connections
Files written at startup1
Install scriptsNone
npm provenanceSigned build
Package age148 days
Maintainers1

Observed 2026-10-21 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · homes-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads2kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed21Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Homes MCP works

What homes-mcp does

The homes-mcp MCP server exposes homes.com real-estate data and property analysis tools to an MCP client. It can search by city, ZIP code, or neighborhood; resolve US street addresses; retrieve structured property details; collect photo galleries; compare properties; and inspect nearby listings. It also provides price, ownership, lien, and tax history, plus market statistics derived from sold-listing pages.

For the 🏠 Real Estate category, the homes-mcp MCP server is suited to agents that need listing research, property screening, or buyer-oriented calculations. The local calculation tools do not contact homes.com: affordability estimates a maximum purchase price, mortgage calculates PITI components, and rent-versus-buy compares supplied financial inputs. Rental estimates must be supplied by the caller because homes.com does not provide a rental estimate signal.

How it works

Requests are sent through a signed-in browser tab using the separately installed ContextMint Bridge extension. The browser session supplies its own cookies, TLS context, and JavaScript environment. The server reads the HTML and Schema.org JSON-LD rendered by homes.com, with additional DOM parsing for sections such as photo galleries and property details.

Search results are built from homes.com URL routing and CollectionPage JSON-LD. A blank or unsluggable location is treated as an error rather than an empty result. Address resolution uses structured typeahead first, then slug and city or ZIP search fallbacks, with street and unit verification. Bulk operations preserve input order and report individual row failures.

Setup and configuration

Install from npm with npx -y homes-mcp, or clone the repository, run npm install, build with npm run build, and start the generated dist/bundle.js with Node. Configure the server in an MCP client using a standard command and args entry.

The ContextMint Bridge is not bundled with homes-mcp. Install the extension separately from its releases, then load the unpacked extension in Chrome through Developer mode. The browser tab must be connected and signed in to homes.com for session-dependent requests. The healthcheck reports bridge and extension state, including whether pairing is pending or the extension is disconnected.

Tools and capabilities

The homes-mcp MCP server includes these supported operation groups:

  • Listing search with property type, listing type, sort, and price filters.
  • Single and bulk address resolution, with up to 100 addresses in a batch.
  • Full property records, optional agent contact fields, photos, and up to 200-property bulk retrieval.
  • Two-to-eight-property comparisons and nearby listing links.
  • Combined price, ownership, lien, and tax history through homes_get_history.
  • Market reports containing median, average, and price-per-square-foot values.
  • Authenticated saved homes and saved searches.
  • Local affordability, mortgage, and rent-versus-buy calculations.
  • Bridge diagnostics and account-label session bookkeeping.

The older property-history and tax-history tools remain deprecated; callers should use homes_get_history instead.

Limitations and notes

homes-mcp does not use a public homes.com consumer API. It relies on page structure and URL conventions that homes.com may change, so continued operation is not guaranteed. Requests act through the currently signed-in browser tab; session labels do not switch the actual browser account.

The project documentation describes homes.com terms that restrict automated crawling and license IDX data for personal, non-commercial use. It also warns about possible rate limits, account suspension, IP blocks, WAF challenges, or other enforcement. Do not treat the extracted data as a commercial feed or redistribute it without checking the applicable terms. The server is not affiliated with homes.com or CoStar Group.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Homes MCP

homes-mcp is an MCP server that connects an MCP client to homes.com through the ContextMint Bridge browser extension. Its main tools search listings, resolve addresses, retrieve property records and photos, compare homes, read history and market reports, access saved homes, and run affordability, mortgage, and rent-versus-buy calculations.

Install it with `npx -y homes-mcp`, or clone the repository, run `npm install`, build it, and start `dist/bundle.js` with Node. You must also install the separate ContextMint Bridge extension and connect a signed-in homes.com browser tab.

Yes, homes-mcp uses a standard MCP process configuration and can be added to Cursor as an MCP server. No Cursor-specific requirement is documented; the separate ContextMint Bridge setup and signed-in homes.com browser session are still required for site requests.

No, homes-mcp cannot fetch a rental estimate from homes.com. Its rent-versus-buy tool performs local calculations only and requires you to provide `monthly_rent` directly, because homes.com does not publish a comparable rental or estimated-rent signal.

Related MCP servers

All in Real Estate All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHomes MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/homes-mcp?style=directory)](https://allmcps.com/mcp/homes-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/homes-mcp"><img src="https://allmcps.com/api/badge/homes-mcp?style=directory" alt="Homes MCP on AllMCPs" /></a>