{
  "markdown": "# Stream.estate MCP Server\n\nMCP server for the [Stream.estate](https://stream.estate) French real estate API. Search properties, get market statistics, manage saved searches with webhook notifications, and more.\n\n## Prerequisites\n\n- Node.js >= 20\n- [Stream.estate API key](https://stream.estate/signup)\n\n## Quick Start\n\n### Claude Code (one command)\n\n```bash\nclaude mcp add -e STREAM_ESTATE_API_KEY=your-api-key stream-estate -- npx mcp-stream-estate\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"stream-estate\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-stream-estate\"],\n      \"env\": {\n        \"STREAM_ESTATE_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\n| Environment Variable | Required | Default | Description |\n|---------------------|----------|---------|-------------|\n| `STREAM_ESTATE_API_KEY` | Yes | — | Your Stream.estate API key ([sign up](https://stream.estate/signup)) |\n| `STREAM_ESTATE_BASE_URL` | No | `https://api.stream.estate` | API base URL |\n\n## Available Tools\n\n### Properties\n| Tool | Description |\n|------|-------------|\n| `search-properties` | Search properties with 50+ filters (location, price, size, energy, etc.) |\n| `get-property` | Get full property details by UUID |\n| `find-similar-properties` | Find properties similar to a given one |\n\n### Indicators\n| Tool | Description |\n|------|-------------|\n| `get-cities` | Search cities by name, zipcode, or INSEE code |\n| `location-autocomplete` | Autocomplete city/department names (returns IDs for filters) |\n| `get-points-of-interest` | Find nearby schools, hospitals, restaurants, etc. |\n| `get-price-per-meter` | Price/m² statistics with average, median, and time series |\n\n### Saved Searches\n| Tool | Description |\n|------|-------------|\n| `create-search` | Create a saved search with webhook notifications |\n| `list-searches` | List all saved searches |\n| `get-search` | Get a specific saved search |\n| `update-search` | Update saved search criteria |\n| `delete-search` | Delete a saved search |\n\n### Webhooks\n| Tool | Description |\n|------|-------------|\n| `test-webhook` | Send a test payload to a webhook endpoint |\n\n## Key Concepts\n\n- **Property types**: 0=Flat, 1=House, 2=Building, 3=Parking, 4=Office, 5=Land, 6=Shop\n- **Transaction types**: 0=Sell, 1=Rent\n- **Publisher types**: 0=Individual, 1=Professional\n- **Energy categories**: A (most efficient) through G (least efficient)\n- Use `location-autocomplete` first to find city/department IDs for search filters\n\n## Development\n\n```bash\npnpm run dev    # Watch mode\npnpm run build  # Production build\npnpm start      # Run server\n```\n\n## License\n\nMIT\n",
  "bytes": 2675,
  "sha": "298dbd7d11e45cd2d821f46305cb82ac3b882e6eb146f1659a2144df6f9d09a3",
  "repo_slug": "streamestate/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_fullstck_stream_estate_9efeeebe/readme"
}