io.github.chrischall/booli-mcp
Booli.se real estate for Claude: search listings, sold prices, areas & market stats
Open source Open in the app JSON README (API)
About
Booli.se real estate for Claude: search listings, sold prices, areas & market stats
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- chrischall
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.3.0
- Stars
- 4
- Last push
- 2026-09-07T21:40:29Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:34
- Updated
- 2026-09-04 23:00:30
- Origin id
io.github.chrischall/booli-mcp
README
# booli-mcp
An MCP server for [Booli](https://www.booli.se), the Swedish property
portal — search active for-sale listings, sold prices (slutpriser),
resolve areas, and compute market statistics, all from Claude.
> Developed and maintained by AI (Claude Code). Use at your own discretion
> and within booli.se's terms of use.
## How it works
Booli fronts www.booli.se — including its GraphQL API — with a Cloudflare
bot wall that blocks server-side clients. booli-mcp therefore reads Booli's
consumer GraphQL API by routing each query through **your own signed-in
www.booli.se browser tab** via the fetchproxy bridge (the Transporter
extension), reusing your Cloudflare-cleared session. No
Booli login is required — just a normal page view. All tools are read-only.
`BOOLI_TRANSPORT` selects the path: `auto` (default — direct fetch first,
browser-bridge fallback when walled), `fetchproxy` (always the bridge), or
`direct`. The fetchproxy fleet shares WS port `37149` (`BOOLI_WS_PORT`).
## Setup
1. Install the Transporter (fetchproxy) browser extension and keep a
**www.booli.se** tab open.
2. On the first request, approve the one-time pairing prompt in Transporter.
3. Run `booli_healthcheck` to confirm the path is working. Its `transport`
field says which leg served the probe (`direct` or `fetchproxy`) and,
once the bridge exists, `bridge.session_state` says whether the
Transporter extension is `linked`, `pair_pending` (approve the pair code
it names), or `extension_disconnected`.
## Install
```jsonc
// mcp config
{
"mcpServers": {
"booli": {
"command": "npx",
"args": ["-y", "@chrischall/booli-mcp"]
}
}
}
```
## Tools
| Tool | What it does |
| --- | --- |
| `booli_search_areas` | Resolve a place name to Booli area ids |
| `booli_search_listings` | Search active for-sale listings by area + filters |
| `booli_get_listing` | Full detail for one property (active or sold) by residence id |
| `booli_search_sold` | Search sold listings (slutpriser) with final prices |
| `booli_market_stats` | Median/average sold-price statistics for an area |
| `booli_healthcheck` | Probe the data path and report `transport` (direct / fetchproxy, the `BOOLI_TRANSPORT` mode) and, once the bridge is up, `bridge` (role, port, extension link `session_state`, pending pair code) with a next-step hint |
Searches scope by `area_id` (from `booli_search_areas`) or a free-text
`location`. Money is SEK, areas m². See
[`docs/BOOLI-API.md`](docs/BOOLI-API.md) for the underlying GraphQL API.
## Development
```
npm install
npm test # vitest, no network
npm run build # tsc + esbuild bundle
```
## License
MIT