Back to Directory/Developer Tools

io.github.fullstck/stream-estate

MCP server for the Stream.estate French real estate API

Developer ToolsTypeScriptv1.0.3

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

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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y mcp-stream-estate

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-fullstck-stream-estate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-stream-estate"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

mcp-stream-estatenpm

Compatible MCP Clients

io.github.fullstck/stream-estate works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More