BatchData 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

Clone or download this MCP server to your local machine
Install dependencies:
cd batchdata-mcp-real-estate npm install
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
Build the TypeScript project:
npm run build
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

Variable	Description	Required
`BATCHDATA_API_KEY`	Your BatchData.io API key	Yes

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

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.

Related MCP Servers

mcp-server-code-assist
abhishekbhakat
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
Last updated -
12
Python
MIT License
IP Geolocation MCP Server
briandconnelly
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
5
Python
MIT License
MCP Blockchain Query Server
pavel-bc
-
security
F
license
-
quality
A Model Context Protocol server providing tools for querying Bitcoin blockchain data via Blockchain Data and Query APIs, supporting various BTC information retrieval functions.
Last updated -
Python
Dual MCP Server for IoT & Memory
jordy33
-
security
F
license
-
quality
Provides two Model Context Protocol servers that enable controlling IoT devices and managing persistent memory storage with semantic search capabilities.
Last updated -
1
Python

View all related MCP servers

BatchData MCP Server