How do I use Property MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Property MCP Server get property details for 123 Main St, Anytown, CA 90210" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Property MCP Server

A minimal Model Context Protocol server that connects Claude AI to real estate data via the ATTOM Data API.

Quick Start

# Install dependencies
pip install -r requirements.txt

# Set up .env file
echo "ATTOM_API_KEY=your_key_here" > .env

# Test the tool
python test_tool.py "1600 Amphitheatre Parkway, Mountain View, CA 94043"

# Run the server (for Claude Desktop)
python -m mcp_server.server

Architecture

mcp_server/
├── server.py            # Entry point
├── tools/
│   └── property_info_tool.py  # tool interface
├── services/
│   └── attom_client.py  # HTTP client
├── config.py            # Environment config
└── utils/
    └── errors.py        # Exceptions

Error Handling

Errors are caught and returned as structured JSON responses:

{
  "error": True,
  "message": "ATTOM API error: 400 Bad Request",
  "status_code": 400
}

API errors: HTTP errors parsed from ATTOM API responses
Network errors: Connection failures wrapped in APIError
Config errors: Missing API key raises ConfigError at startup
Tool layer: Catches APIError and returns error dict (never raises)

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "property-mcp": {
      "command": "/path/to/venv/bin/python3.12",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/path/to/property-MCP",
      "env": {
        "PYTHONPATH": "/path/to/property-MCP"
      }
    }
  }
}