Log inSubmit server
Compass MCP logo

Compass MCP

Searches Compass listings, retrieves property data, compares homes, and calculates affordability through a browser session.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Compass 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": {
    "compass-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "compass-mcp"
      ]
    }
  }
}

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

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

Overview

The compass-mcp MCP server exposes Compass listing search, property records, photos, price history, comparisons, address resolution, and local mortgage calculations. It runs as a Node stdio process and sends Compass requests through the ContextMint Bridge extension in a signed-in browser tab, preserving that session's cookies and browser context. Reach for it when an agent needs structured Compass data or real-estate calculations, but review Compass's terms before use because the server scrapes rendered site data rather than using a public API.

Use cases

  • Search Compass listings by location and budget
  • Compare multiple properties side by side
  • Inspect photos and listing price history
  • Estimate affordability and monthly mortgage costs

Key features

  • Compass listing search with filters
  • Property details and address resolution
  • Photo galleries and price history
  • Comparisons for up to 25 properties
  • Local affordability and PITI calculations

Tools18

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

Verified live~7.3k 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 Today

Recent health check succeeded.

4/4 checks healthy over the last 29d

What it can do

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

Handles credentials · 2Makes network requests · 14Read-only tools · 18
Network at startup3 connections
Files written at startup1
Install scriptsNone
npm provenanceSigned build
Package age149 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 · compass-mcp (npm)

Adoption & maintenance

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

npm downloads2.9kPackage 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 exposed18Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Compass MCP works

What compass-mcp MCP server does

The compass-mcp MCP server gives MCP clients access to selected Compass real-estate data and local housing calculations. It can search listings by location, price range, bedroom count, and home type; retrieve detailed property records; resolve an address to Compass identifiers; and collect photo galleries and listing history. It can also compare as many as 25 properties in one request, with errors retained on the affected rows.

Two tools perform calculations without contacting Compass. The affordability calculator estimates a maximum purchase price from income, debt-to-income settings, and rates. The mortgage calculator estimates PITI components, including principal and interest, taxes, insurance, HOA fees, and PMI.

Saved homes and saved searches are not implemented. Those tools return a clear unsupported or not-yet-wired error because the required authenticated GraphQL operations have not been identified.

How it works

The server runs in Node and communicates with an MCP client over stdio. For Compass requests, it passes work to the ContextMint Bridge browser extension, which dispatches the fetch from an open, signed-in Compass tab. Requests therefore use the browser session's cookies, TLS context, and JavaScript environment rather than a separate login or headless browser.

Compass does not provide a public consumer API for these operations. The compass-mcp MCP server reads data embedded in server-rendered pages, including search-page application state and property-page listing state. It then converts those page structures into tool results, so callers receive fields instead of parsing the page themselves. Search inputs are converted into Compass URL routes, while property lookups can use a URL or listing identifier.

Setup and configuration

Install the published package with an MCP configuration using npx, or clone the repository, run npm install, build it, and launch dist/bundle.js with Node. The source workflow uses npm run build; tests are available through npm test.

Install the ContextMint Bridge extension separately. For Chrome, load the unpacked extension through the browser's developer-extension page after downloading and extracting its release. Open Compass and sign in after installing the bridge. No additional server credential is documented.

Tools and capabilities

  • Search listings using location, price band, beds, and home type.
  • Fetch property attributes such as address, pricing, status, amenities, schools, parcel number, and monthly charges.
  • Return original and thumbnail photo URLs with image dimensions; additional media categories require an option.
  • Retrieve listed, sold, pending, price-change, and delisted events with dates, prices, statuses, and MLS attribution.
  • Compare up to 25 property targets with an optional aligned summary.
  • Resolve addresses, calculate affordability, and calculate mortgage costs locally or through Compass as appropriate.

Limitations and notes

The compass-mcp MCP server depends on Compass's current rendered-page structures and URL conventions. Compass can change those private inline-script fields or routes without notice, which may break extraction. The project is not affiliated with Compass.

The README warns that Compass's terms prohibit automated crawling or querying without express written permission and describes IDX data as personal, non-commercial use only. Do not use the server for bulk extraction, redistribution, model training, competing products, or commercial purposes. Users are responsible for consequences such as rate limits, account suspension, IP blocking, browser challenges, or other enforcement. This documentation is not legal advice; consult Compass's actual terms before using the tool.

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 Compass MCP

compass-mcp is an MCP server that connects AI clients to Compass through a signed-in browser tab and the ContextMint Bridge extension. Its main tools search listings, retrieve property details, photos, and price history, compare homes, resolve addresses, and calculate affordability or mortgage costs locally.

Install it with an `npx` MCP configuration or build it from source with `npm install` and `npm run build`. Then run the generated Node bundle and install the ContextMint Bridge extension. Open Compass in the browser and sign in before using the tools.

No, the documented setup does not require an API key. Requests use an existing signed-in Compass browser tab through ContextMint Bridge, including that tab's cookies and browser context. The server reads rendered Compass page data rather than calling a public consumer API.

No, saved homes and saved searches are not yet supported. Their tools return a clear not-yet-wired error because Compass exposes those views through authenticated GraphQL operations that the project has not identified.

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 PreviewCompass MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/compass-mcp?style=directory)](https://allmcps.com/mcp/compass-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/compass-mcp"><img src="https://allmcps.com/api/badge/compass-mcp?style=directory" alt="Compass MCP on AllMCPs" /></a>