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
npm install
cp .env.example .env
npm start
npm start:http
| 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)
For Claude Desktop, opencode, Cursor — reads JSON-RPC from stdin, writes to stdout.
HTTP/SSE (remote)
Endpoints:
GET / — Server info (Streamable HTTP discovery)POST / — Synchronous JSON-RPCGET /sse — SSE streamPOST /messages?sessionId=... — SSE session messagesGET /health — Health check
Configuration
Claude Desktop
Copy config/claude-desktop.json to your Claude Desktop MCP config, or add to claude_desktop_config.json:
{
"mcpServers": {
"realestatecapitale": {
"command": "node",
"args": ["/path/to/rabatrealestate/bin/mcp-server"],
"env": {
"DATABASE_URL": "postgresql://user:pass@localhost:5432/mubawab"
}
}
}
}
opencode
{
"mcp": {
"realestatecapitale": {
"type": "local",
"command": ["node", "bin/mcp-server"],
"env": { "DATABASE_URL": "..." }
}
}
}
Remote (HTTP)
{
"mcp": {
"realestatecapitale": {
"type": "remote",
"url": "https://realestatecapitale.ma/mcp"
}
}
}
node bin/query "tools/list"
node bin/query 'tools/call {"name":"list_villes","arguments":{}}'
MCP_URL=https://realestatecapitale.ma/mcp node bin/query "tools/list"
Testing
Architecture
┌─────────────┐ 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