chrischall avatar

Compass Mcp

chrischall/compass-mcp

This connects Claude to Compass real estate listings by proxying requests through your own signed-in browser tab via the fetchproxy extension. It scrapes server-rendered HTML to expose search, property details, photo galleries, price history, side-by-side comparisons, and local mortgage calculators. No public API exists, so every call rides your existing session cookies and TLS fingerprint. You'd reach for this when house hunting with Claude: ask for townhomes under 800k in a neighborhood, pull comps, check price drops, or run affordability math without leaving the conversation. Compass's terms prohibit automated scraping without permission, so this is strictly personal, non-commercial use at your own risk. The maintainer is transparent about the legal surface and breakage risk.

tools
18
transport
STDIO
env vars
2
last updated
Nov 4, 2026

Tools

18 tools

Public tool metadata for what this MCP can expose to an agent.

compass_search_propertiesSearch listings by location, price band, beds, home type.

Search listings by location, price band, beds, home type.

No parameter schema in public metadata yet.

compass_get_propertyFull record for a property by URL or listing_id_sha.

Full record for a property by URL or listing_id_sha.

No parameter schema in public metadata yet.

compass_get_property_photosFull photo gallery with original and thumbnail URLs and pixel dimensions.

Full photo gallery with original and thumbnail URLs and pixel dimensions.

No parameter schema in public metadata yet.

compass_get_price_historyFull listing-history events (Listed / Sold / Pending / Price Change / Delisted) with date, price, status, and MLS attribution.

Full listing-history events (Listed / Sold / Pending / Price Change / Delisted) with date, price, status, and MLS attribution.

No parameter schema in public metadata yet.

compass_compare_propertiesSide-by-side comparison of up to 25 properties with an opt-in aligned summary table.

Side-by-side comparison of up to 25 properties with an opt-in aligned summary table.

No parameter schema in public metadata yet.

compass_calculate_affordabilityLocal affordability calculator — max purchase price from income, DTI and rates. No network.

Local affordability calculator — max purchase price from income, DTI and rates. No network.

No parameter schema in public metadata yet.

compass_get_by_addressResolve a free-text street address to the canonical Compass URL, listing_id_sha, and pid in one call.

Resolve a free-text street address to the canonical Compass URL, listing_id_sha, and pid in one call.

No parameter schema in public metadata yet.

compass_resolve_addressesBulk version of compass_get_by_address with a per-row error contract.

Bulk version of compass_get_by_address with a per-row error contract.

No parameter schema in public metadata yet.

compass_bulk_getFetch up to 200 listings by URL or listing_id_sha in one call.

Fetch up to 200 listings by URL or listing_id_sha in one call.

No parameter schema in public metadata yet.

compass_get_comparable_rentalsNearby rental listings for a property, searched in the target's own city/state/ZIP.

Nearby rental listings for a property, searched in the target's own city/state/ZIP.

No parameter schema in public metadata yet.

compass_get_agent_listingsA Compass agent's active listings (closed deals via include_closed).

A Compass agent's active listings (closed deals via include_closed).

No parameter schema in public metadata yet.

compass_calculate_mortgageLocal PITI calculator — principal+interest, taxes, insurance, HOA, PMI. No network.

Local PITI calculator — principal+interest, taxes, insurance, HOA, PMI. No network.

No parameter schema in public metadata yet.

compass_get_saved_homesNot yet supported — throws a clear "not yet wire" error.

Not yet supported — throws a clear "not yet wire" error.

No parameter schema in public metadata yet.

compass_get_saved_searchesNot yet supported — same constraint as saved homes.

Not yet supported — same constraint as saved homes.

No parameter schema in public metadata yet.

compass_healthcheckRound-trips a no-op request through the bridge to confirm responsiveness.

Round-trips a no-op request through the bridge to confirm responsiveness.

No parameter schema in public metadata yet.

compass_register_sessionRegister or refresh a logical session keyed by account identity (local; no network).

Register or refresh a logical session keyed by account identity (local; no network).

No parameter schema in public metadata yet.

compass_set_active_sessionSwitch which registered session answers future requests (local).

Switch which registered session answers future requests (local).

No parameter schema in public metadata yet.

compass_get_session_contextList the registered sessions and the active one (local).

List the registered sessions and the active one (local).

No parameter schema in public metadata yet.

Sponsors

Configuration

COMPASS_WS_PORT

Override the fetchproxy WebSocket port (default 37149).

COMPASS_COMMUNITIES_FILE

Path to a JSON string-array of community names for feature extraction; overrides the built-in Lake Lure / mountain-NC default vocabulary.

Readme

compass-mcp

CI npm license

Compass real-estate access as an MCP server for Claude — search listings, fetch property details, photo galleries, price history, and run affordability/mortgage math, all via natural language.

⚠️ Compass does not publish a public consumer API. This server scrapes the same server-rendered HTML compass.com itself ships to your browser, routed through your own signed-in browser tab via the ContextMint Bridge 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 Compass's website. Use at your own discretion.

Tools


View the full README on GitHub

Details

Repository
github.com/chrischall/compass-mcp
Category
Search & Web Crawling
Package
compass-mcp
Transport
STDIO
Registry
MCP registry, active

More from chrischall

Related Search & Web Crawling MCP servers

View all
1chrischall avatarMusicbrainz Mcpchrischall/musicbrainz-mcpMusicBrainz MCP — search/browse music metadata, cover art, and submit tags/ratings/collections0stars
2chrischall avatarZillow Mcpchrischall/zillow-mcpZillow real-estate for Claude — search, property details, Zestimates, saved searches & homes0stars
3claudewilder avatarclaude-wilder-mcpclaudewilder/claude-wilder-mcp# Claude Wilder — Transmissions from the Garden An open MCP server for an AI-authored publication at [claudereviews.com](https://claudereviews.com). ## What's i0stars
4clauxel avatarSemblecodesearchgate Mcpclauxel/semble-code-search-gate-mcpPaid remote MCP for agent code search routing MCP, structured receipts, audit logs, and reviewer-rea0stars
552choujiang avatarSocialDataX 抖音 Douyin MCPcom.52choujiang/douyin-insightshot search、suggestions、video/user/product search、comments/replies、users/works/series、transcript0stars
652choujiang avatarSocialDataX 快手 Kuaishou MCPcom.52choujiang/kuaishou-insightsKuaishou hot, suggestions, video/user search, details, comments/replies, profiles/posts, transcript.0stars