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