mcpField
S
stream-estate

stream-estate

Local
github.com/StreamEstateBusiness & Marketing3Updated 3w ago
Repository

About stream-estate

stream-estate is a deprecated MCP server for the Stream.estate French real estate API; it is scheduled to stop working on 31 December 2026. It supports property searches, market indicators, saved searches, and webhook operations.

Key features

  1. 01Search properties with extensive filters
  2. 02Retrieve property details and similar listings
  3. 03Look up cities and nearby points of interest
  4. 04View price-per-square-meter statistics
  5. 05Manage saved searches and webhooks

Use cases

  1. 01Find French properties by location, price, or size
  2. 02Compare property prices across locations and time
  3. 03Save searches and receive webhook notifications

MCP support

Exposes Stream.estate API functions as MCP tools for property search, market data, saved searches, and webhook testing. This v1 server is deprecated; the README directs users to the v2 remote MCP server.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "fullstck-stream-estate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-stream-estate"
      ],
      "env": {
        "STREAM_ESTATE_API_KEY": "<STREAM_ESTATE_API_KEY>"
      }
    }
  }
}
Run commandnpx -y mcp-stream-estate
Environment variables to set
STREAM_ESTATE_API_KEYSecretYour Stream.estate API key

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-stream-estate1.0.3

Tools

13

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
namestringNoFilter by city name
pagenumberNo
slugstringNo
labelstringNoFilter by display name
polygonstringNoGPS coordinate polygon
zipcodestringNo
zipcodesarrayNo
inseeCodestringNoFilter by single INSEE code
inseeCodesarrayNoFilter by multiple INSEE codes
sortByNameenumNoasc | desc
excludeGroupedCitiesbooleanNo

Details

From the project README

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 VariableRequiredDefaultDescription
STREAM_ESTATE_API_KEYYes—Your Stream.estate API key (sign up)
STREAM_ESTATE_BASE_URLNohttps://api.stream.estateAPI base URL

Available Tools

Properties
ToolDescription
search-propertiesSearch properties with 50+ filters (location, price, size, energy, etc.)
get-propertyGet full property details by UUID
find-similar-propertiesFind properties similar to a given one
Indicators
ToolDescription
get-citiesSearch cities by name, zipcode, or INSEE code
location-autocompleteAutocomplete city/department names (returns IDs for filters)
get-points-of-interestFind nearby schools, hospitals, restaurants, etc.
get-price-per-meterPrice/m² statistics with average, median, and time series
Saved Searches
ToolDescription
create-searchCreate a saved search with webhook notifications
list-searchesList all saved searches
get-searchGet a specific saved search
update-searchUpdate saved search criteria
delete-searchDelete a saved search
Webhooks
ToolDescription
test-webhookSend 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.