What is Batchdata Mcp Real Estate

batchdata-mcp-real-estate is a Model Context Protocol (MCP) server that integrates with BatchData.io’s property and address APIs, providing access to various real estate data functionalities.

Use cases

Use cases include validating addresses for real estate listings, searching for properties within specific geographic boundaries, and integrating property data into AI assistants for enhanced user experiences.

How to use

To use batchdata-mcp-real-estate, clone the repository, install dependencies, configure your API key in the .env file, build the project, and start the server using npm commands.

Key features

Key features include address verification, intelligent address suggestions, geocoding, reverse geocoding, detailed property lookups, advanced property searches, and property count queries.

Where to use

batchdata-mcp-real-estate can be used in real estate applications, property management systems, geographic information systems (GIS), and any application requiring property and address data integration.

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:

   • Get your API key from BatchData Settings or register here.
   • Create or update the .env file in the project root:

   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

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"
      }
    }
  }
}

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

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

• BatchData API: Documentation | Dashboard
• MCP Protocol: Documentation
• Issues: GitHub Issues

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.