Handles environment variable loading for API key management and server configuration.
Enables running the MCP server using Node.js runtime, allowing Claude to access BatchData.io's property data services.
Uses TypeScript for type-safe development of the MCP server, providing robust integration with BatchData.io's APIs.
Integrates with USPS verification services to validate and standardize addresses through the verify-address tool.
Provides runtime type validation for MCP server requests and responses when interacting with BatchData.io's APIs.
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:
Manual Installation
- Clone or download this MCP server to your local machine
- Install dependencies:
- Configure your API key:
- Get your API key from BatchData Settings or register here.
- Create or update the
.env
file in the project root:
- Build the TypeScript project:
- Test the server:
Quick Setup
Use the automated setup scripts:
Linux/macOS:
Windows:
Docker Support
Quick Start with Docker
- Build and test the Docker container:
- Run with Docker Compose:
- View 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:
Run with environment file:
Run with Docker Compose:
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
:
Windows
Edit %APPDATA%\Claude\claude_desktop_config.json
:
Docker Configuration for Claude Desktop
If running via Docker, you can configure Claude Desktop to use the containerized server:
Tools Available
Address Tools
verify-address
- USPS address verification and standardizationautocomplete-address
- Smart address suggestionsgeocode-address
- Convert address to coordinatesreverse-geocode
- Convert coordinates to address
Property Tools
lookup-property
- Detailed property data by address/APNsearch-properties
- Advanced filtered property searchsearch-properties-by-boundary
- Geographic area searchescount-properties
- Property count queries
Example Usage
Count Properties in Phoenix
Find Comparable Properties
Verify an Address
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
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.
Related MCP Servers
- AsecurityAlicenseAqualityA 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 -124PythonMIT License
- -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 -35TypeScriptMIT License
- -securityFlicense-qualityA 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
- AsecurityFlicenseAqualityA 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 -2TypeScript