Stream.estate MCP Server

MCP server for the Stream.estate French real estate API. Search properties, get market statistics, manage saved searches with webhook notifications, and more.

Prerequisites

Node.js >= 20
Stream.estate API key

Quick Start

Claude Code (one command)

claude mcp add -e STREAM_ESTATE_API_KEY=your-api-key stream-estate -- npx mcp-stream-estate

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "stream-estate": {
      "command": "npx",
      "args": ["mcp-stream-estate"],
      "env": {
        "STREAM_ESTATE_API_KEY": "your-api-key"
      }
    }
  }
}

Configuration

Environment Variable	Required	Default	Description
`STREAM_ESTATE_API_KEY`	Yes	—	Your Stream.estate API key (sign up)
`STREAM_ESTATE_BASE_URL`	No	`https://api.stream.estate`	API base URL

Available Tools

Properties

Tool	Description
`search-properties`	Search properties with 50+ filters (location, price, size, energy, etc.)
`get-property`	Get full property details by UUID
`find-similar-properties`	Find properties similar to a given one

Indicators

Tool	Description
`get-cities`	Search cities by name, zipcode, or INSEE code
`location-autocomplete`	Autocomplete city/department names (returns IDs for filters)
`get-points-of-interest`	Find nearby schools, hospitals, restaurants, etc.
`get-price-per-meter`	Price/m² statistics with average, median, and time series

Saved Searches

Tool	Description
`create-search`	Create a saved search with webhook notifications
`list-searches`	List all saved searches
`get-search`	Get a specific saved search
`update-search`	Update saved search criteria
`delete-search`	Delete a saved search

Webhooks

Tool	Description
`test-webhook`	Send a test payload to a webhook endpoint

Key Concepts

Property types: 0=Flat, 1=House, 2=Building, 3=Parking, 4=Office, 5=Land, 6=Shop
Transaction types: 0=Sell, 1=Rent
Publisher types: 0=Individual, 1=Professional
Energy categories: A (most efficient) through G (least efficient)
Use location-autocomplete first to find city/department IDs for search filters

Development

pnpm run dev    # Watch mode
pnpm run build  # Production build
pnpm start      # Run server

License

MIT

stream-estate

Quick Install