ClawHub

Tmp.HJPP6RNCdj

MCP Tools

Look up real-estate listings, property details, market reports, and your saved homes/searches on Compass via MCP. Triggers on phrases like "find homes on compass in", "compass property details for", "show my saved compass homes", "what's my saved compass search seeing", "what does compass say about", "compass market report for", or any request involving Compass properties, prices, or your saved Compass activity. Requires compass-mcp installed and the fetchproxy extension active (see Setup below).

Install

openclaw skills install compass-mcp

compass-mcp

MCP server for Compass — natural-language access to listings, property records, market reports, and your saved homes/searches. Routes through your signed-in compass.com tab via the fetchproxy browser extension, so AWS WAF / DataDome see a real browser session instead of a Node process.

⚠️ Compass does not publish a public consumer API. This server uses the same private /stingray/... endpoints the compass.com web app calls, dispatched through your own signed-in browser tab via the fetchproxy extension. Use at your own discretion.

Setup

1. Install compass-mcp

.mcp.json (project) or ~/.claude/mcp.json (global):

{
  "mcpServers": {
    "compass": {
      "command": "npx",
      "args": ["-y", "compass-mcp"]
    }
  }
}

2. Install the fetchproxy extension (one-time, shared across all fetchproxy-based MCPs)

git clone https://github.com/chrischall/fetchproxy
cd fetchproxy
npm ci
npm --workspace=@fetchproxy/extension-chrome run build

Then in Chrome: chrome://extensions → Developer mode → Load unpacked → pick packages/extension-chrome/dist/.

3. Open compass.com and sign in.

That's it. No API keys, no env vars.

Tools

Public data

  • compass_search_properties — Search by location + filters (price, beds/baths min, home type). Resolves the location via Compass's autocomplete then queries the /stingray/api/gis endpoint. Returns matching listings with price, beds/baths, sqft, year built, address, and the Compass home URL.
  • compass_get_property — Full property record by url (Compass homedetails URL or path) or property_id + listing_id. Two-round-trip API: initialInfo resolves the URL to IDs, then aboveTheFold fetches the data. Returns address, beds/baths, sqft, year built, price, status, days on market, primary photo.
  • compass_get_market_report — Median sale/list prices, price per sqft, days on market, year-over-year change, homes sold/on market for a Compass region. Provide either location (free-text) or region_id + region_type. All metrics returned as formatted strings (e.g. "$870K", "+2.4%").
  • compass_calculate_mortgage — Local PITI calculator. No network call. Provide home price, interest rate, optional down payment / taxes / insurance / HOA / PMI; returns a full monthly breakdown.

Signed-in user data (the unique value vs. paid scrapers)

  • compass_get_saved_homes — Your favorited homes, flattened across all collections. Returns address, price, beds/baths, status.
  • compass_get_saved_searches — Your saved searches with region URLs and display text.

Trigger examples

  • "Find me 2-bedroom condos under $1.5M in Brooklyn on Compass" → compass_search_properties
  • "What does Compass say about 42 Monroe St in Brooklyn?" → compass_get_property
  • "Pull up my favorited homes on Compass" → compass_get_saved_homes
  • "What's new on my saved Compass searches?" → compass_get_saved_searches
  • "Brooklyn housing market trends on Compass" → compass_get_market_report
  • "Monthly payment on a $500k home, 20% down, 6.5% rate" → compass_calculate_mortgage

Gotchas

  • Sign-in required for saved- tools.* If the user isn't signed into compass.com in the bridged Chrome tab, those tools fail with SessionNotAuthenticatedError. Public tools work either way.
  • AWS WAF challenge. Compass occasionally serves a WAF challenge to fresh sessions. Solving it in the Chrome tab once unblocks subsequent fetches.
  • No write surface yet. All tools are read-only. Saving a home / search / contact form are not implemented in v0.1.
  • for_rent / sold listing statuses map to entirely different Compass URL paths (/apartments-for-rent/..., /recently-sold). v0.1 of compass_search_properties supports for_sale only.
  • No equivalent to Zillow's Zestimate history tool. Compass's Compass Estimate is exposed as a current scalar inside compass_get_property; there's no historical-series endpoint yet.
More in MCP Tools