Booli MCP

What booli-mcp does

booli-mcp exposes Booli.se property data as read-only MCP tools. It covers both current and historical market research: active listings, completed sales, individual property records, area resolution, and sold-price statistics.

The main search flow starts with booli_search_areas, which converts a place name into Booli area IDs. Those IDs can then scope listing and sales searches. Queries may also use a free-text location. Monetary values are expressed in SEK, and property areas use square metres.

How it works

Booli’s consumer GraphQL API is protected by a Cloudflare bot wall that can prevent ordinary server-side requests. booli-mcp supports a browser-mediated route through the ContextMint Bridge extension. The bridge sends requests through an open www.booli.se browser tab and reuses that tab’s Cloudflare-cleared session.

BOOLI_TRANSPORT controls request routing:

• auto tries direct access first and uses the browser bridge if access is blocked.
• fetchproxy always uses the bridge.
• direct uses direct requests only.

No Booli account login is required for the normal page view described by the project, but the browser-bridge path requires an open Booli tab and a one-time pairing approval.

Setup and configuration

Install the server through an MCP client using the following stdio configuration:

{
  "mcpServers": {
    "booli": {
      "command": "npx",
      "args": ["-y", "@chrischall/booli-mcp"]
    }
  }
}

For bridge fallback, install ContextMint Bridge from its Chrome release, load the unpacked extension with Chrome’s Developer mode, and keep a www.booli.se tab open. Approve the pairing prompt on the first request. Safari is not available for this setup.

The bridge fleet uses WebSocket port 37149 by default. Set BOOLI_WS_PORT to use another port. Run booli_healthcheck after setup to inspect the selected transport and bridge state.

Tools and capabilities

• booli_search_areas resolves a place name into Booli area IDs.
• booli_search_listings searches active for-sale properties using an area and filters.
• booli_get_listing returns full details for a property identified by residence ID, whether active or sold.
• booli_search_sold searches completed sales and their final prices.
• booli_market_stats reports median and average sold prices for an area.
• booli_healthcheck checks the data path and reports transport and bridge details, including pairing state and a next-step hint.

Limitations and notes

All tools are read-only. The browser route depends on the ContextMint Bridge extension, an available Booli tab, and a successful pairing. The health check can distinguish direct access from bridge access and can report states such as linked, pairing pending, or disconnected. Use Booli’s data within its terms of use.