Skip to main content
Glama
stream-estate

stream-estate

Official
by StreamEstate

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

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-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

Available Tools

13 tools
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).

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).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 13 tools

    Disambiguation4/5

    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).

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An 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.
      3
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP 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.
      -