Stream Estate MCP Server (v1, deprecated)
[!WARNING]
This server is deprecated and will stop working on 31 December 2026 , together with the Stream Estate API v1.
Switch to the v2 remote MCP server : https://api-v2.stream.estate/mcp (HTTP transport, X-API-KEY header), listed in the MCP Registry as estate.stream/mcp .
Setup guide: https://next.docs.stream.estate/en/docs/guides/mcp
复制 claude mcp add --transport http streamestate https://api-v2.stream.estate/mcp --header "X-API-KEY: <your_key>"
MCP server for the Stream.estate French real estate API. Search properties, get market statistics, manage saved searches with webhook notifications, and more.
Prerequisites
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