Skip to main content
Glama

Real Estate Data MCP Server by BatchData

BatchData - Real Estate Data - MCP Server

A Model Context Protocol (MCP) server that integrates with BatchData.io's comprehensive property and address APIs. This server provides access to property data, address verification, skip tracing, geocoding, and advanced property search capabilities.

Features

Address Operations

  • verify-address: Validate and standardize addresses using USPS verification
  • autocomplete-address: Get intelligent address suggestions as you type
  • geocode-address: Convert addresses to latitude/longitude coordinates
  • reverse-geocode: Convert coordinates back to readable addresses

Property Operations

  • lookup-property: Get detailed property information by address or APN (Assessor Parcel Number)
  • search-properties: Advanced property search with comprehensive filters
  • search-properties-by-boundary: Geographic boundary searches using bounding boxes or radius
  • count-properties: Get property counts matching specific criteria (lightweight operation)

Installation

Installing via Smithery

To install batchdata-mcp-real-estate for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @zellerhaus/batchdata-mcp-real-estate --client claude

Manual Installation

  1. Clone or download this MCP server to your local machine
  2. Install dependencies:
    cd batchdata-mcp-real-estate npm install
  3. Configure your API key:
    BATCHDATA_API_KEY=your_actual_api_key_here
  4. Build the TypeScript project:
    npm run build
  5. Test the server:
    npm start

Quick Setup

Use the automated setup scripts:

Linux/macOS:

chmod +x setup.sh && ./setup.sh

Windows:

setup.bat

Docker Support

Quick Start with Docker

  1. Build and test the Docker container:
    chmod +x docker-manage.sh ./docker-manage.sh test
  2. Run with Docker Compose:
    ./docker-manage.sh run
  3. View logs:
    ./docker-manage.sh logs

Docker Management Commands

The docker-manage.sh script provides convenient commands:

  • build: Build the Docker image
  • run: Start with docker-compose
  • stop: Stop the service
  • logs: View server logs
  • test: Build and test the server
  • clean: Clean up Docker resources
  • run-direct: Run directly with Docker (for testing)

Manual Docker Usage

Build the image:

docker build -t batchdata-mcp-server:latest .

Run with environment file:

docker run --rm --env-file .env batchdata-mcp-server:latest

Run with Docker Compose:

docker-compose up -d

Docker Features

  • Multi-stage build for optimized image size
  • Non-root user for enhanced security
  • Health checks for monitoring
  • Resource limits and logging configuration
  • Production-ready with proper signal handling

Development Commands

  • Build: npm run build - Compiles TypeScript to JavaScript
  • Start: npm start - Runs the compiled JavaScript server
  • Dev: npm run dev - Builds and runs in one command
  • Clean: npm run clean - Removes compiled JavaScript files

Configuration for Claude Desktop

To use this MCP server with Claude Desktop, add the following to your Claude configuration file:

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "batchdata": { "command": "node", "args": ["/path/to/batchdata-mcp-real-estate/batchdata_mcp_server.js"], "env": { "BATCHDATA_API_KEY": "your_api_key_here" } } } }

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json:

{ "mcpServers": { "batchdata": { "command": "node", "args": ["C:\\path\\to\\batchdata-mcp-real-estate\\batchdata_mcp_server.js"], "env": { "BATCHDATA_API_KEY": "your_api_key_here" } } } }

Docker Configuration for Claude Desktop

If running via Docker, you can configure Claude Desktop to use the containerized server:

{ "mcpServers": { "batchdata": { "command": "docker", "args": ["exec", "-i", "batchdata-mcp-server", "node", "batchdata_mcp_server.js"], "env": { "BATCHDATA_API_KEY": "your_api_key_here" } } } }

Tools Available

Address Tools

  • verify-address - USPS address verification and standardization
  • autocomplete-address - Smart address suggestions
  • geocode-address - Convert address to coordinates
  • reverse-geocode - Convert coordinates to address

Property Tools

  • lookup-property - Detailed property data by address/APN
  • search-properties - Advanced filtered property search
  • search-properties-by-boundary - Geographic area searches
  • count-properties - Property count queries

Example Usage

Count Properties in Phoenix

I need to count single-family homes in Phoenix, AZ between $250,000 and $600,000

Find Comparable Properties

Find properties similar to 2800 N 24th St, Phoenix, AZ 85008 within 1 mile

Verify an Address

Verify this address: 2800 N 24th St, Phoenix, Arizona 85008

API Rate Limits

BatchData.io rate limits per endpoint:

  • Address Verification: 5,000 max (1,000 recommended per batch)
  • Address Geocoding: 90 max (75 recommended per batch)
  • Property Search: 1,000 max requests
  • Property Lookup: Standard API limits

Environment Variables

VariableDescriptionRequired
BATCHDATA_API_KEYYour BatchData.io API keyYes

Error Handling

The server includes comprehensive error handling for:

  • Invalid API keys
  • Network request failures
  • Malformed requests
  • API rate limit exceeded
  • Invalid parameter combinations

Dependencies

  • @modelcontextprotocol/sdk: Core MCP framework
  • zod: Runtime type validation
  • dotenv: Environment variable loading
  • typescript: TypeScript compiler
  • @types/node: Node.js type definitions

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT License - See LICENSE for details.

Support


Real Estate professionals and developers: This MCP server enables Claude to access comprehensive property data, perform address verification, and conduct advanced property searches directly through natural language queries.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

  1. Features
    1. Address Operations
    2. Property Operations
  2. Installation
    1. Installing via Smithery
    2. Manual Installation
  3. Quick Setup
    1. Docker Support
      1. Quick Start with Docker
      2. Docker Management Commands
      3. Manual Docker Usage
      4. Docker Features
    2. Development Commands
      1. Configuration for Claude Desktop
        1. macOS
        2. Windows
        3. Docker Configuration for Claude Desktop
      2. Tools Available
        1. Address Tools
        2. Property Tools
      3. Example Usage
        1. Count Properties in Phoenix
        2. Find Comparable Properties
        3. Verify an Address
      4. API Rate Limits
        1. Environment Variables
          1. Error Handling
            1. Dependencies
              1. Contributing
                1. License
                  1. Support

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that retrieves detailed geographic information about IP addresses using the ipinfo.io API, helping determine user location and network details.
                      Last updated -
                      1
                      24
                      Python
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A server that implements the Model Context Protocol, providing a standardized way to connect AI models to different data sources and tools.
                      Last updated -
                      3
                      5
                      TypeScript
                      MIT License
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.
                      Last updated -
                      Python
                    • A
                      security
                      F
                      license
                      A
                      quality
                      A Model Context Protocol server that provides tools for fetching and posting HTTP data, with built-in prompts for URL summarization and API analysis.
                      Last updated -
                      2
                      TypeScript

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/zellerhaus/batchdata-mcp-real-estate'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server