Used for version control and distribution of the MCP server code, with instructions for cloning the repository.
Hosts the repository for the MCP server, with instructions for cloning from GitHub provided in the installation section.
Provides comprehensive testing capabilities for the MCP server, including unit tests, integration tests, and coverage reporting.
The server is built with Python, with examples showing how to install dependencies and run the server using Python commands.
Real Estate MCP Server
A comprehensive Model Context Protocol (MCP) server for real estate data management. This server provides tools, resources, and prompts for property listings, agent management, market analysis, client relationships, and area intelligence.
🏗️ Architecture
The server is built with a modular, componentized architecture for maintainability and scalability:
🚀 Features
MCP Capabilities
30+ Tools: Comprehensive real estate operations
10 Resources: 5 static resources + 5 dynamic resource templates
11 Prompts: User-controlled analysis templates across 4 categories
SSE Transport: Web-compatible Server-Sent Events endpoint
Tool Categories
🏠 Property Management (7 tools)
Search and filter properties by multiple criteria
Get property details and comprehensive insights
Area-based and agent-based property listings
Market context and comparable analysis
👥 Agent Operations (6 tools)
Agent profiles and specializations
Performance dashboards and metrics
Client and property portfolio management
Sales tracking and analytics
📊 Market Analysis (7 tools)
Market overview and price analytics
Area-specific market performance
Investment opportunity analysis
Comparative area analysis
Transaction tracking
🤝 Client Management (3 tools)
Client profiles and preferences
Property matching algorithms
Budget and criteria-based recommendations
🏘️ Area Intelligence (9 tools)
Comprehensive area reports
Amenities and demographics
Schools, parks, shopping, healthcare data
City overview and area comparisons
⚙️ System Management (2 tools)
Data refresh and cache management
System statistics and summaries
Resources
Static Resources
realestate://all-properties
: Complete property listingsrealestate://all-agents
: Agent directoryrealestate://market-overview
: Current market trendsrealestate://all-areas
: Area informationrealestate://amenities
: Complete amenities database
Dynamic Resource Templates
realestate://properties/area/{area}
: Area-specific propertiesrealestate://agent/{agent_id}/dashboard
: Agent performance dashboardrealestate://market/area/{area}
: Area market analysisrealestate://property/{property_id}/insights
: Property insightsrealestate://client/{client_id}/matches
: Client property matches
Prompts (11 total)
Property Prompts (2 prompts)
Property Analysis: Comprehensive property evaluation and insights
Property Comparison: Side-by-side property comparison analysis
Client Prompts (3 prompts)
Client Matching: Personalized property recommendations
Client Consultation: Structured consultation framework
Client Feedback Analysis: Search strategy refinement
Market Prompts (3 prompts)
Market Reports: Comprehensive area market analysis
Investment Analysis: ROI and opportunity assessment
Comparative Market Analysis: Multi-area comparison
Agent Prompts (3 prompts)
Agent Performance: Performance dashboards and analysis
Agent Marketing Strategy: Business development and marketing
Agent Training Development: Skill enhancement and training plans
📦 Installation
Clone the repository:
git clone https://github.com/agentic-ops/real-estate-mcp.git cd real-estate-mcpInstall dependencies:
pip install -r requirements.txtRun the server:
python main.py
🔍 MCP Inspector
To inspect and debug your MCP server, you can use the MCP Inspector tool:
This will launch the MCP Inspector interface, allowing you to:
Monitor MCP messages in real-time
Debug tool and resource calls
Inspect server responses
Test server functionality
🌐 Server Transport
The server uses Server-Sent Events (SSE) transport, making it compatible with:
Web browsers and HTTP clients
Traditional MCP clients
Custom integrations
Connection Details
SSE Endpoint:
http://127.0.0.1:8000/sse
(for establishing SSE connection)Message Endpoint:
http://127.0.0.1:8000/messages/
(for posting MCP messages)Transport: SSE (Server-Sent Events)
Protocol: MCP (Model Context Protocol)
Web Client Example
🔧 Component Details
Core Components
utils.py
- Data Management
RealEstateDataManager
: Central data access classPropertyFilter
: Search and filtering utilitiesJSON data loading and caching
Cross-referencing and relationship mapping
main.py
- Server Entry Point
FastMCP server initialization
Component registration orchestration
SSE transport configuration
Startup logging and diagnostics
Tool Modules
Each tool module follows a consistent pattern:
Resource Modules
Resources are organized by domain for better maintainability:
Property Resources (property_resources.py
)
Property listings and search results
Property insights and market context
Area-based property filtering
Agent Resources (agent_resources.py
)
Agent profiles and directories
Performance dashboards and metrics
Market Resources (market_resources.py
)
Market overview and trends
Area-specific market analysis
Client Resources (client_resources.py
)
Client preference matching
Property recommendations
Location Resources (location_resources.py
)
Area information and demographics
Amenities and local services
Each module follows a consistent pattern:
Prompt Templates
Prompts guide AI analysis:
📊 Data Structure
The server operates on comprehensive real estate data:
5 Properties: Victorian homes, contemporary, luxury, townhouses
3 Agents: Specialized real estate professionals
6 Clients: Buyers, sellers, investors with preferences
Multiple Sales: Recent transaction history
5 Areas: Downtown Riverside, Woodcrest, Canyon Crest, Arlington Heights, La Sierra
Amenities: Schools, parks, shopping, healthcare facilities
🔍 Usage Examples
MCP Client Examples
For proper MCP client integration, use the MCP protocol with the correct endpoints:
🧪 Testing
The project includes a comprehensive test suite covering all components and functionality.
Test Structure
Test Categories
Unit Tests (tests/unit/
)
Data Manager Tests: Core functionality of
RealEstateDataManager
Filter Tests: Property filtering logic and edge cases
Utility Functions: Helper functions and data validation
Integration Tests (tests/integration/
)
Property Tools: Search, filter, insights, and area-based queries
Agent Tools: Profile management, performance dashboards
Market Tools: Market analysis and trend calculations
Client Tools: Client matching and preference algorithms
Area Tools: Area intelligence and amenities data
System Tools: Data refresh and system statistics
Resources: Static resources and dynamic templates
Prompts: Template generation and parameter handling (11 prompts across 4 categories)
Running Tests
Prerequisites
Quick Test Commands
Using the Test Runner Script
Test Features
Fixtures and Test Data
Isolated Test Environment: Each test uses temporary data directories
Mock Data: Consistent test data across all test cases
Shared Fixtures: Reusable test components in
conftest.py
Data Manager Mocking: Isolated testing without file system dependencies
Coverage and Reporting
Code Coverage: Comprehensive coverage reporting with pytest-cov
HTML Reports: Visual coverage reports in
htmlcov/index.html
Missing Lines: Identification of uncovered code paths
Branch Coverage: Logic branch testing
Test Configuration
pytest.ini: Centralized test configuration
Automatic Discovery: Tests auto-discovered by naming convention
Parallel Execution: Support for parallel test execution
Filtering: Warning filters for clean test output
Test Data Validation
The test suite validates:
✅ All 30+ tools function correctly with mock and real data
✅ Property filtering logic handles edge cases
✅ Search functionality is case-insensitive and comprehensive
✅ Agent performance calculations are accurate
✅ Market analysis tools process data correctly
✅ Client matching algorithms work as expected
✅ Area intelligence aggregates data properly
✅ Resource endpoints return valid JSON
✅ Prompt templates generate proper instructions
✅ Error handling for missing or invalid data
✅ Data refresh and caching mechanisms
✅ System statistics and summaries
Continuous Integration
For CI/CD pipelines, use:
Writing New Tests
When adding new functionality:
Unit Tests: Add to
tests/unit/
for core logicIntegration Tests: Add to appropriate
tests/integration/test_*.py
Use Fixtures: Leverage existing fixtures in
conftest.py
Mock External Dependencies: Use
unittest.mock
for isolationTest Edge Cases: Include boundary conditions and error scenarios
Follow Naming Convention:
test_*.py
files,Test*
classes,test_*
methods
🛠️ Development
Adding New Tools
Choose appropriate category in
tools/
Add tool function with
@mcp.tool()
decoratorRegister in the category's
register_*_tools()
functionImport and call registration in
main.py
Add Tests: Create corresponding tests in
tests/integration/
Adding New Resources
Choose appropriate domain module in
resources/
(property, agent, market, client, location)Add resource function with
@mcp.resource()
decorator and URI patternRegister in the domain's
register_*_resources()
functionImport and call registration in
main.py
Add Tests: Include resource tests in
tests/integration/test_resources.py
Adding New Prompts
Choose appropriate category in
prompts/
(property, client, market, or agent)Add prompt function with
@mcp.prompt()
decoratorInclude parameter defaults and comprehensive instructions
Register in the category's
register_*_prompts()
functionAdd Tests: Include prompt tests in
tests/integration/test_prompts.py
Adding New Prompt Categories
Create new file in
prompts/
directory (e.g.,prompts/new_category_prompts.py
)Follow the existing pattern with
register_new_category_prompts(mcp)
functionImport and register in
prompts/__init__.py
Add Tests: Create corresponding test fixtures and test methods
🔄 Benefits of SSE Transport
Web Compatible: Direct browser integration
Real-time: Server-sent events for live updates
HTTP Standard: Works with standard HTTP tools
Firewall Friendly: Uses standard HTTP port
Scalable: Supports multiple concurrent connections
📝 License
This project is licensed under the MIT License.
🤝 Contributing
Fork the repository
Create a feature branch
Add your component following the established patterns
Test thoroughly
Submit a pull request
📖 Further Reading
For a comprehensive deep dive into the architecture, design principles, and real-world applications of this MCP server, read the detailed blog post:
🔌 MCP Servers - Model Context Protocol Implementation
The blog post covers:
Understanding MCP Servers and their business impact
Architecture deep dive with code examples
MCP Tools, Prompts, and Resources explained
Real-world usage scenarios and implementation patterns
Security considerations and best practices
Future implications of MCP technology
Built with the Model Context Protocol (MCP) for seamless AI integration
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A comprehensive Model Context Protocol server for real estate data management that provides tools and resources for property listings, agent management, market analysis, client relationships, and area intelligence.
Related MCP Servers
- -securityAlicense-qualityA server that implements the Model Context Protocol, providing a standardized way to connect AI models to different data sources and tools.Last updated -010MIT License
- -securityAlicense-qualityA Model Context Protocol server that provides real-time access to Zillow real estate data, enabling property search, detailed information retrieval, Zestimates, market trends analysis, and mortgage calculations.Last updated -4MIT License
- -securityAlicense-qualityA Model Context Protocol server that provides access to property data, address verification, skip tracing, geocoding, and advanced property search capabilities through BatchData.io's APIs.Last updated -19TypeScriptMIT License
- AsecurityAlicenseAqualityA comprehensive Model Context Protocol server providing access to 70+ IT tools for developers and system administrators, including encoding/decoding, text manipulation, hashing, and network utilities.Last updated -7610112TypeScriptMIT License