dld-mcp 0.2.0__tar.gz

dld_mcp-0.2.0/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE/Editor
+.idea/
+.vscode/
+*.swp
+
+# Local config
+.env
+.env.local
+
+# Claude Code
+.claude/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Internal docs (not for public)
+PLAN.md

dld_mcp-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OfferBrief
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dld_mcp-0.2.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: dld-mcp
+Version: 0.2.0
+Summary: MCP server for Dubai real estate - DLD transactions and Ejari rentals
+Project-URL: Homepage, https://offerbrief.com
+Project-URL: Repository, https://github.com/level09/dld-mcp
+Author-email: OfferBrief <hello@offerbrief.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dld,dubai,ejari,mcp,property,real-estate,rentals,uae
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Description-Content-Type: text/markdown
+
+# DLD MCP Server
+
+MCP server for Dubai real estate data. Query 1.6M+ DLD sales transactions and 9.5M+ Ejari rental contracts.
+
+## Installation
+
+```bash
+uvx dld-mcp
+```
+
+## Claude Desktop Setup
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "dld": {
+      "command": "uvx",
+      "args": ["dld-mcp"]
+    }
+  }
+}
+```
+
+## Tool: query_dld
+
+One flexible tool to query all Dubai property data.
+
+### Parameters
+
+| Parameter | Values | Default |
+|-----------|--------|---------|
+| area | Area name or building (fuzzy search) | required |
+| type | `sales`, `rentals` | sales |
+| property_type | `all`, `apartment`, `villa`, `townhouse` | all |
+| bedrooms | `all`, `studio`, `1`, `2`, `3`, `4`, `5+` | all |
+| date_from | YYYY-MM-DD | 12 months ago |
+| date_to | YYYY-MM-DD | today |
+| metric | `stats`, `count`, `list` | stats |
+| limit | 1-50 (for list mode) | 10 |
+
+### Examples
+
+```
+"What's the median price in Marina?"
+→ query_dld(area="Marina")
+
+"How many villas sold in Palm Jumeirah in 2024?"
+→ query_dld(area="Palm", property_type="villa", date_from="2024-01-01", metric="count")
+
+"Average rent for 2BR in Downtown"
+→ query_dld(area="Downtown", type="rentals", bedrooms="2")
+
+"Show me recent sales in JBR"
+→ query_dld(area="JBR", metric="list", limit=10)
+
+"Compare Business Bay vs Marina apartment prices"
+→ Two calls with different areas
+```
+
+### Supported Aliases
+
+Marina, JBR, Downtown, Palm, JVC, JLT, Business Bay, Sports City, Motor City, Silicon Oasis, Arabian Ranches, Discovery Gardens, International City, Creek Harbour, City Walk, Town Square, DAMAC Hills
+
+## Development
+
+```bash
+git clone https://github.com/level09/dld-mcp
+cd dld-mcp
+uv sync
+uv run dld-mcp
+```
+
+## License
+
+MIT - [OfferBrief](https://offerbrief.com)

dld_mcp-0.2.0/README.md

@@ -0,0 +1,77 @@
+# DLD MCP Server
+
+MCP server for Dubai real estate data. Query 1.6M+ DLD sales transactions and 9.5M+ Ejari rental contracts.
+
+## Installation
+
+```bash
+uvx dld-mcp
+```
+
+## Claude Desktop Setup
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "dld": {
+      "command": "uvx",
+      "args": ["dld-mcp"]
+    }
+  }
+}
+```
+
+## Tool: query_dld
+
+One flexible tool to query all Dubai property data.
+
+### Parameters
+
+| Parameter | Values | Default |
+|-----------|--------|---------|
+| area | Area name or building (fuzzy search) | required |
+| type | `sales`, `rentals` | sales |
+| property_type | `all`, `apartment`, `villa`, `townhouse` | all |
+| bedrooms | `all`, `studio`, `1`, `2`, `3`, `4`, `5+` | all |
+| date_from | YYYY-MM-DD | 12 months ago |
+| date_to | YYYY-MM-DD | today |
+| metric | `stats`, `count`, `list` | stats |
+| limit | 1-50 (for list mode) | 10 |
+
+### Examples
+
+```
+"What's the median price in Marina?"
+→ query_dld(area="Marina")
+
+"How many villas sold in Palm Jumeirah in 2024?"
+→ query_dld(area="Palm", property_type="villa", date_from="2024-01-01", metric="count")
+
+"Average rent for 2BR in Downtown"
+→ query_dld(area="Downtown", type="rentals", bedrooms="2")
+
+"Show me recent sales in JBR"
+→ query_dld(area="JBR", metric="list", limit=10)
+
+"Compare Business Bay vs Marina apartment prices"
+→ Two calls with different areas
+```
+
+### Supported Aliases
+
+Marina, JBR, Downtown, Palm, JVC, JLT, Business Bay, Sports City, Motor City, Silicon Oasis, Arabian Ranches, Discovery Gardens, International City, Creek Harbour, City Walk, Town Square, DAMAC Hills
+
+## Development
+
+```bash
+git clone https://github.com/level09/dld-mcp
+cd dld-mcp
+uv sync
+uv run dld-mcp
+```
+
+## License
+
+MIT - [OfferBrief](https://offerbrief.com)

dld_mcp-0.2.0/pyproject.toml

@@ -0,0 +1,41 @@
+[project]
+name = "dld-mcp"
+version = "0.2.0"
+description = "MCP server for Dubai real estate - DLD transactions and Ejari rentals"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "OfferBrief", email = "hello@offerbrief.com" }
+]
+keywords = ["mcp", "dubai", "real-estate", "dld", "property", "ejari", "rentals", "uae"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+]
+
+[project.scripts]
+dld-mcp = "dld_mcp:main"
+
+[project.urls]
+Homepage = "https://offerbrief.com"
+Repository = "https://github.com/level09/dld-mcp"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dld_mcp"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"

dld_mcp-0.2.0/src/dld_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""DLD MCP Server - Dubai Land Department property data for AI assistants."""
+
+from .server import main, mcp
+
+__all__ = ["main", "mcp"]

dld_mcp-0.2.0/src/dld_mcp/server.py

@@ -0,0 +1,89 @@
+"""MCP server for Dubai Land Department property data."""
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+API_BASE = "https://offerbrief.com/api"
+
+mcp = FastMCP(
+    "Dubai Land Department",
+    instructions="""Query Dubai property data: 1.6M+ DLD sales transactions and 9.5M+ Ejari rental contracts.
+Use query_dld with filters for area, property type, bedrooms, dates, etc.
+Supports fuzzy search and aliases (Marina, JBR, Downtown, Palm, JVC, JLT).""",
+)
+
+
+@mcp.tool()
+def query_dld(
+    area: str,
+    type: str = "sales",
+    property_type: str = "all",
+    bedrooms: str = "all",
+    date_from: str = "",
+    date_to: str = "",
+    metric: str = "stats",
+    limit: int = 10,
+) -> dict:
+    """Query Dubai property data - sales transactions or rental contracts.
+
+    Args:
+        area: Location to search (e.g., "Marina", "JBR", "Downtown", "Palm Jumeirah", or building name)
+        type: "sales" for DLD transactions, "rentals" for Ejari contracts
+        property_type: "all", "apartment", "villa", or "townhouse" (sales only)
+        bedrooms: "all", "studio", "1", "2", "3", "4", "5+"
+        date_from: Start date YYYY-MM-DD (default: last 12 months for sales, 24 for rentals)
+        date_to: End date YYYY-MM-DD (default: today)
+        metric: "stats" (aggregated statistics), "count" (just count), "list" (individual records)
+        limit: Max records for list mode (1-50, default 10)
+
+    Returns:
+        For stats: median/avg/min/max prices, transaction count, total volume
+        For count: just the count of matching records
+        For list: individual transaction/contract records
+
+    Examples:
+        - "How many villas sold in Palm Jumeirah in 2024?"
+          query_dld(area="Palm", property_type="villa", date_from="2024-01-01", metric="count")
+
+        - "Average rent for 2BR in Marina"
+          query_dld(area="Marina", type="rentals", bedrooms="2")
+
+        - "Recent sales in Downtown"
+          query_dld(area="Downtown", metric="list", limit=10)
+
+        - "Compare JBR vs Marina prices"
+          Call twice with different areas
+    """
+    if not area or len(area) < 2:
+        return {"error": "area must be at least 2 characters"}
+
+    params = {
+        "area": area,
+        "type": type,
+        "property_type": property_type,
+        "bedrooms": bedrooms,
+        "metric": metric,
+        "limit": min(max(1, limit), 50),
+    }
+    if date_from:
+        params["date_from"] = date_from
+    if date_to:
+        params["date_to"] = date_to
+
+    try:
+        with httpx.Client(timeout=30) as client:
+            r = client.get(f"{API_BASE}/query", params=params)
+            r.raise_for_status()
+            return r.json()
+    except httpx.HTTPStatusError as e:
+        if e.response.status_code == 404:
+            return e.response.json()
+        return {"error": f"API error: {e.response.status_code}"}
+
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()