Israel Real Estate MCP

A Python-based Mission Control Program (MCP) for interacting with the Israeli government’s public real estate data API (Govmap). This project provides both a Python library and an MCP server that allows real estate agents, professionals, and AI agents to query recent property deals, analyze market trends, and retrieve detailed real estate information.

Description

This project provides a comprehensive Python interface to the Israeli government’s Govmap API, enabling users to:

• Search for property addresses using autocomplete
• Find geographical coordinates for addresses
• Retrieve block (Gush) and parcel (Helka) information
• Query recent real estate deals by location
• Get detailed street and neighborhood deal information
• Analyze market trends in specific areas

Features

• Address Autocomplete: Search for addresses using free text and get precise coordinates
• Geospatial Data: Retrieve block and parcel information for any coordinate point
• Deal Discovery: Find real estate deals within a specified radius of any location
• Street Analysis: Get detailed deal information for specific streets
• Neighborhood Insights: Analyze deals within entire neighborhoods
• Time-based Filtering: Search for deals within specific date ranges
• Comprehensive Search: High-level function that combines all features to find deals for any address
• Error Handling: Robust error handling for network issues and API failures
• Logging: Detailed logging for debugging and monitoring

Installation

Prerequisites

• Python 3.7 or higher
• pip package manager

Setup Instructions

1. Clone the repository:

   git clone 
   cd nadlan-mcp
   

2. Create a virtual environment:

   python -m venv venv
   

3. Activate the virtual environment:

   • On Windows:

     venv\Scripts\activate
     

   • On macOS/Linux:

     source venv/bin/activate
     

4. Install the package:

   pip install -e .
   

   Or for development with all dev dependencies:

   pip install -e .[dev]
   

Usage

MCP Server (Recommended for AI Agents)

The project includes an MCP (Model Context Protocol) server that allows AI agents to access Israeli real estate data. The server provides multiple deployment options:

1. FastMCP Server (Recommended)

NEW: Using FastMCP for better compatibility and reliability

python run_fastmcp_server.py

This starts the FastMCP server which resolves compatibility issues with the standard MCP library.

2. Interactive Demo Server

For testing and demonstration purposes:

python simple_mcp_server.py

This runs an interactive demo where you can test the tools directly in the terminal.

3. Alternative: Interactive Demo

For testing and demonstrations:

python simple_mcp_server.py