stream-estate
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@stream-estate find houses in Lyon with 3 bedrooms"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Stream Estate MCP Server (v1, deprecated)
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
Node.js >= 20
Related MCP server: HomeHarvest MCP Server
Quick Start
Claude Code (one command)
claude mcp add -e STREAM_ESTATE_API_KEY=your-api-key stream-estate -- npx mcp-stream-estateClaude 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 |
| Yes | — | Your Stream.estate API key (sign up) |
| No |
| API base URL |
Available Tools
Properties
Tool | Description |
| Search properties with 50+ filters (location, price, size, energy, etc.) |
| Get full property details by UUID |
| Find properties similar to a given one |
Indicators
Tool | Description |
| Search cities by name, zipcode, or INSEE code |
| Autocomplete city/department names (returns IDs for filters) |
| Find nearby schools, hospitals, restaurants, etc. |
| Price/m² statistics with average, median, and time series |
Saved Searches
Tool | Description |
| Create a saved search with webhook notifications |
| List all saved searches |
| Get a specific saved search |
| Update saved search criteria |
| Delete a saved search |
Webhooks
Tool | Description |
| 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-autocompletefirst to find city/department IDs for search filters
Development
pnpm run dev # Watch mode
pnpm run build # Production build
pnpm start # Run serverLicense
MIT
Available Tools
13 toolscreate-searchC
Create a saved search with optional webhook notifications for real-time property alerts. Configure location, price, size filters and webhook endpoints.
Inputs: lat, lon, title, radius, +36 more.
delete-searchA
Delete a saved search by its ID.
Inputs: id (required).
find-similar-propertiesA
Find properties similar to a given property. Useful for market comparisons and finding alternatives.
Inputs: id (required), page, fromDate, itemsPerPage, +5 more.
get-citiesA
Search French cities by name, zipcode, INSEE code, or geographic polygon. Returns city IDs needed for property search filters.
Inputs: name, page, slug, label, +7 more.
get-points-of-interestA
Find points of interest (schools, hospitals, restaurants, parking) near a location. Returns facilities within a radius of given coordinates.
Inputs: lat (required), lon (required), radius, facilities.
get-price-per-meterB
Get price per m² statistics (average, median, time series) for properties matching filters. Useful for market analysis and property valuation.
Inputs: lat, lon, page, radius, +73 more.
get-propertyA
Get full details for a single property by UUID, including all adverts, price history events, photos, contact info, and nearby transit stations.
Inputs: id (required).
get-searchA
Get details of a specific saved search by its ID.
Inputs: id (required).
list-searchesA
List all saved searches for the authenticated user. Can filter by notification status and title.
Inputs: page, title, orderByTitle, notificationEnabled.
location-autocompleteA
Autocomplete cities and departments by search query. Returns IDs needed for location filters in search-properties and create-search.
Inputs: query (required), excludeCities, excludeDepartments.
search-propertiesA
Search French real estate properties with extensive filters for location, price, size, rooms, energy rating, and more. Returns paginated results with property details, adverts, photos, and nearby stations. Use location-autocomplete first to resolve city/department IDs.
Inputs: lat, lon, page, radius, +77 more.
test-webhookA
Test webhook delivery by sending a simulated match or event payload to an endpoint. Useful for verifying webhook integration.
Inputs: type (required), endpoint (required).
update-searchA
Update an existing saved search with new criteria, filters, or webhook configuration.
Inputs: id (required), lat, lon, title, +37 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools target distinct resources and actions. The only potential confusion is between get-cities and location-autocomplete, which both resolve location identifiers, but their descriptions clarify different use cases (exact search vs autocomplete).
The majority follow a consistent verb_noun pattern (search-properties, create-search, update-search). However, location-autocomplete deviates from this pattern by placing the noun first, which is a minor inconsistency.
13 tools is well within the appropriate range for a real estate search API, covering property discovery, saved search management, location resolution, and auxiliary features like webhooks and pricing stats. Each tool has a clear role.
The tool set provides full CRUD for saved searches, comprehensive property search and detail retrieval, location resolution, and market analysis. No significant gaps for the stated domain of French real estate search.
Maintenance
Related MCP Connectors
French real estate listings, market data and property alerts (Stream Estate API v2).
Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels. Search live hotel rates and flights, look up places, airports and hotel details, then prebook and book. Remote Streamable HTTP endpoint, no API key required.
MCP server for real-estate agents: listings, CRM, German market data and AI media tools.
Related MCP Servers
AlicenseCqualityBmaintenanceMCP server for the Offorte API - Create & send proposals using AI1887 npm5MIT- FlicenseNot gradedqualityDmaintenanceAn MCP server built with Smithery that provides a foundation for real estate data harvesting capabilities. Currently includes example functionality for testing and development purposes.2-
- AlicenseBqualityDmaintenanceAn MCP server for accessing the Fotocasa1 API to search real estate listings and retrieve detailed property information in Spain. It supports location suggestions, property filtering by type and price, and fetching specific property details.3MIT
- FlicenseNot gradedqualityCmaintenanceMCP server for querying real estate agents registered with CRECI-SP. Enables searching by name, CRECI number, city, or status, retrieving agent details, and getting statistics.-