# Sherlock Homes

French real estate data platform for AI agents. Identifies property owners likely to sell and tracks behavioral signals on active listings (price drops, agency changes). Coverage: metropolitan France.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add romainlaffitau/sherlock-homes

# Browse available tools
npx -y smithery tool list romainlaffitau/sherlock-homes

# Get full schema for a tool
npx -y smithery tool get romainlaffitau/sherlock-homes search_biens

# Call a tool
npx -y smithery tool call romainlaffitau/sherlock-homes search_biens '{}'
```

## Direct MCP Connection

Endpoint: `https://sherlock-homes.run.tools`

**Optional config:**
- `api_ke` (header) — Sherlock Homes API key (Bearer token). Get one at sherlockhomes.pro/api

## Tools (6)

- `search_biens` — Search scored properties by city, temperature (hot/warm/cold), or postal code. Returns address, property type, surface,…
- `get_bien` — Get complete property details including all active behavioral signals (price drops, agency changes, etc.).
- `get_market_stats` — Market statistics for a given city: number of hot/warm/cold properties, signal counts, and recent activity.
- `get_zone_analysis` — Sherlock Map — zone classification and trends by postal code (hot_zone, transforming, cooling, stable). Requires Standa…
- `search_signals` — Behavioral signals on active listings: motivated sellers currently on market (price drops, re-listing, agency removal).
- `search_nearby` — Find properties within a geographic radius around GPS coordinates.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get romainlaffitau/sherlock-homes <tool-name>
```