io.github.allamiwayl-27/rabatrealestate-mcp MCP Server

This MCP server provides real estate capabilities for Morocco, focused on Rabat, Salé, and Témara. It supports property search, valuation, market analysis, and lead management, and exposes 17 tools via both stdio (e.g., Claude Desktop, opencode, Cursor) and an HTTP/SSE mode.

🛠️ Key Features

Real estate search, property valuation, market analysis, and lead management
Coverage: Rabat, Salé, and Témara, Morocco
17 tools total
Tool example: search_listings (filter by type, location, budget, surface, rooms)

🚀 Use Cases

Finding properties using structured filters (type, location, budget, surface, rooms)
Supporting valuation and market analysis workflows for the specified areas
Managing leads related to property search and analysis

⚡ Developer Benefits

Works as an MCP server for the Model Context Protocol
Can run as an npm stdio server (npm start) or an HTTP/SSE server (npm start:http)
PostgreSQL-backed setup via .env (copy .env.example and set the connection string)

⚠️ Limitations

Tool list details beyond search_listings are not included in the provided data
Functionality scope is limited to Rabat, Salé, and Témara, Morocco

Real Estate Capitale — MCP Server

MCP server for real estate search, property valuation, market analysis, and lead management in Rabat, Salé, and Témara, Morocco.

Quick Start

bash

# Install
npm install

# Set database URL
cp .env.example .env
# Edit .env with your PostgreSQL connection string

# Start stdio server (for Claude Desktop, opencode, Cursor)
npm start

# Or start HTTP/SSE server
npm start:http

17 Tools

Tool	Description
`search_listings`	Search properties with filters (type, location, budget, surface, rooms)
`get_listing`	Get full listing details by ID
`estimate_property`	Estimate property value by quartier and surface
`get_market_trends`	Price trends over time by quartier
`get_quartier_stats`	Aggregated stats per quartier (price/m², count)
`list_quartiers`	List all available quartiers
`list_villes`	List all available cities
`create_lead`	Create a lead (contact client)
`get_comparables`	Find similar listings for valuation
`get_investor_alerts`	Identify undervalued properties
`get_price_analytics`	Price/m² analysis with distribution
`get_rental_yield`	Rental yield by quartier
`get_market_predictions`	90-day price predictions
`get_quartier_comparison`	Compare two quartiers side-by-side
`get_suspicious_listings`	Detect outlier pricing
`get_liquidity`	Market liquidity index
`get_agency_leaderboard`	Agency ranking by volume

Transports

stdio (local)

bash

node bin/mcp-server

For Claude Desktop, opencode, Cursor — reads JSON-RPC from stdin, writes to stdout.

HTTP/SSE (remote)

bash

node bin/mcp-server-http
# Listens on port 3001

Endpoints:

GET / — Server info (Streamable HTTP discovery)
POST / — Synchronous JSON-RPC
GET /sse — SSE stream
POST /messages?sessionId=... — SSE session messages
GET /health — Health check

Configuration

Claude Desktop

Copy config/claude-desktop.json to your Claude Desktop MCP config, or add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "realestatecapitale": {
      "command": "node",
      "args": ["/path/to/rabatrealestate/bin/mcp-server"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/mubawab"
      }
    }
  }
}

opencode

json

{
  "mcp": {
    "realestatecapitale": {
      "type": "local",
      "command": ["node", "bin/mcp-server"],
      "env": { "DATABASE_URL": "..." }
    }
  }
}

Remote (HTTP)

json

{
  "mcp": {
    "realestatecapitale": {
      "type": "remote",
      "url": "https://realestatecapitale.ma/mcp"
    }
  }
}

Query Tool

bash

# List tools
node bin/query "tools/list"

# Call a tool
node bin/query 'tools/call {"name":"list_villes","arguments":{}}'

# Query remote server
MCP_URL=https://realestatecapitale.ma/mcp node bin/query "tools/list"

Testing

bash

npm test

Architecture

code

┌─────────────┐     stdio      ┌──────────────┐
│ Claude Desktop│ ◄──────────── │ bin/mcp-server│
│ opencode     │               │ (stdio)       │
└─────────────┘               └──────┬───────┘
                                      │
┌─────────────┐     HTTP/SSE  ┌──────┴───────┐
│ Remote AI   │ ◄──────────── │ bin/mcp-     │
│ clients     │               │ server-http  │
└─────────────┘               │ (port 3001)  │
                              └──────┬───────┘
                                     │
                              ┌──────┴───────┐
                              │ src/core/     │
                              │ mcp-core.js   │
                              │ (17 tools)    │
                              └──────┬───────┘
                                     │
                              ┌──────┴───────┐
                              │ PostgreSQL    │
                              │ (mubawab)     │
                              └──────────────┘

License

MIT

Real Estate Capitale MCP

io.github.allamiwayl-27/rabatrealestate-mcp MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

Real Estate Capitale — MCP Server

Quick Start

17 Tools

Transports

stdio (local)

HTTP/SSE (remote)

Configuration

Claude Desktop

opencode

Remote (HTTP)

Query Tool

Testing

Architecture

License

Install

Remote endpoint

Related servers