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:

config.json

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

opencode

config.json

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

Remote (HTTP)

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

Terminal

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