Batchdata Mcp (real Estate & Contact Data)

by batchdataco

173 downloads
Not rated
GitHub

About

BatchData MCP Server Connect your AI agents directly to the nation's most accurate property database. This server empowers LLMs to perform rigorous research, skip tracing, and comp analysis without hallucinations. Just ask your AI to "find high-equity owners" or "verify contacts"

Details

Author
batchdataco
Downloads
173
Categories
Search, Other

- Connects AI agents to the most accurate property database
- Enables skip tracing and comp analysis without hallucinations
- Returns precise, real‑time data on demand
- Supports natural language queries like “find high‑equity owners”
- Allows contact verification through simple AI commands

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Batchdata Mcp (real Estate & Contact Data)
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Users connect the server to their AI agents and then issue natural language queries such as “find high‑equity owners” or “verify contacts” to retrieve property and contact data. No specific install or configuration commands are mentioned in the README.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "batchdata mcp (real estate & contact data)": {
            "batchdata": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "-e",
                    "BATCHDATA_API_KEY=YOUR_BATCHDATA_API_KEY_HERE",
                    "batchdata-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "batchdata": {
        "command": "docker",
        "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "BATCHDATA_API_KEY=YOUR_BATCHDATA_API_KEY_HERE",
            "batchdata-mcp-server"
        ]
    }
}

BatchData MCP (Real Estate & Contact Data)

Real Estate & Contact Enrichment Data MCP

What can you do with BatchData (Real Estate & Contact Data) MCP?

- Look up property details— Retrieve full property information by address, parcel number, or ID usinglookup_property.
- Find comparable properties— Get counts, previews, or paginated details of comparable properties withcomparable_property_count,comparable_property_preview, andcomparable_property_page.
- Search for properties— Discover properties matching criteria like vacancy status or location, with count, preview, and paginated access viasearch_properties_count,search_properties_preview, andsearch_properties_page.
- Skip trace property owners— Obtain owner names and contact information for a given property address or parcel number withskip_trace_property.
- Verify and standardize addresses— Validate addresses to USPS standards, geocode an address to coordinates, or reverse geocode coordinates to an address usingverify_address,geocode_address, andreverse_geocode_address.
- Verify phone numbers— Check a phone's reachability, carrier, DNC status, and TCPA litigator status withverify_phone,check_dnc_status, orcheck_tcpa_status.

- 1Introduction
- 2
Authentication Methods

- 2.1[](#OAuth-Authentication-(Recommended))<<<OAuth Authentication (Recommended)
- 2.2[](#API-Token-Authentication-(Alternative))<<<API Token Authentication (Alternative)

- 4.1Prerequisites
- 4.2
[](#Claude-Setup-(Desktop%2C-Web-%26-Mobile))<<<Claude Setup (Desktop, Web & Mobile)

- 4.2.1Step 1: Add the BatchData Connector
- 4.2.2
Step 2: Authenticate
- 4.2.3
Step 3: Enable the Connector
- 4.2.4
Step 4: Approve Initial Tool Use
- 4.2.5
Using on Mobile
- 4.2.6
Subsequent Connections

- 4.5.1Prerequisites
- 4.5.2
Step 1: Enable Developer Mode
- 4.5.3
Step 2: Create the BatchData Connector
- 4.5.4
Step 3: Authenticate
- 4.5.5
Using BatchData Tools in ChatGPT
- 4.5.6
Managing the Connection

- 5.1Prerequisites
- 5.2
Claude Desktop Setup with API Token

- 5.2.1Step 1: Install Node.js 22
- 5.2.2
Step 2: Configure Claude Desktop

- 6.1Claude Desktop
- 6.2
Claude Code
- 6.3
ChatGPT
- 6.4
Benefits of Migrating

- 7.1Property Lookup & Details
- 7.2
Comparable Property Analysis
- 7.3
Property Search
- 7.4
Contact Information
- 7.5
Phone Verification
- 7.6
Address Processing

- 8.1OAuth Issues
- 8.2
ChatGPT Issues
- 8.3
API Token Issues
- 8.4
General Issues
- 8.5
Getting Help

This guide documents how to connect to the BatchData Remote MCP Server using your MCP-compatible client.

The BatchData MCP Server supports two authentication methods:

OAuth provides a streamlined connection experience:

- No API token configuration needed— Just provide the server URL
- Browser-based login— Authenticate with your BatchData account credentials
- Automatic token management— Access tokens refresh automatically
- Familiar login experience— Use email/password or Google Sign-In

For users who prefer direct API token configuration or are using custom MCP clients that don't support OAuth:

- Requires obtaining and configuring your BatchData API token manually
- Token must be managed and protected as a sensitive credential
- Useful for debugging, automation scripts, or clients without OAuth support

Future Enhancement: OAuth Access Control (Coming Soon)

We are developing enhanced access control features for OAuth authentication:

- Permission verification— OAuth login will automatically verify whether your account has been granted permission to use the MCP server
- Centralized access management— Team owners will be able to grant or revoke MCP server access for team members through the BatchData platform

- A BatchData account with valid credentials
- An MCP-compatible client (Claude Desktop/Web/Mobile, ChatGPT, Cursor, Claude Code, or similar)

Claude Setup (Desktop, Web & Mobile)

Claude supports MCP servers through the desktop app, web interface, and mobile app.

Mobile Note: Connectors cannot be added from the mobile app. Add the connector on Desktop or Web first, and it will automatically be available on mobile for the same account.

Teams/Enterprise Note: Workspace admins must first add the BatchData connector to the list of available connectors before team members can configure it. Contact your admin if you don't see the connector in your list.
- Open Claude (Desktop or Web)
- Go toSettings → Connectors(orSettings → MCP Servers)
- ClickAdd Connector(orAdd Server)
- Enter the server URL:

- Email and password— Enter your BatchData account credentials
- Google Sign-In— Click the Google button to authenticate
- After successful login, you'll be redirected back to Claude

Connectors arenot enabled by defaultafter adding them. Enable it once and the setting is saved:
- Open any chat
- Click the+button (or connectors icon) in the chat input area
- FindBatchDatain the list of available connectors
- Toggle itonto enable it

The connector will now be available in all your conversations.

The first time Claude uses any BatchData tool, you'll be asked to approve it:
- When Claude attempts to use a tool, a permission prompt will appear
- Review the tool and action being requested
- ClickAllowto approve
- Select"Always allow"if you want to skip approval for future uses of that tool

Note: After initial approval (or selecting "Always allow"), subsequent tool uses won't require additional confirmation.

Once you've added and authenticated the connector on Desktop or Web:

- Open the Claude mobile app with the same account
- The BatchData connector will be available in your connector list
- If not already enabled, toggle it on via the+button in the chat input (setting syncs across devices)
- Tool approvals granted on Desktop/Web carry over to mobile
- All tools work the same as on Desktop/Web

- Access tokens are cached and refresh automatically across all devices
- You won't need to log in again unless your session expires (typically after 14 days of inactivity)
- If prompted to re-authenticate, simply log in again through your browser (on Desktop or Web)
- Open Cursor Settings
- Navigate to the MCP configuration section
- ClickAdd MCP Server
- Enter the server URL:
- On first use, authenticate through the browser popup

Add the BatchData MCP server directly via the CLI:

claude mcp add BatchData --url https://mcp.batchdata.com

On first use, you'll be prompted to authenticate through your browser.

ChatGPT supports MCP servers throughDeveloper Mode, which provides fullModel Context Protocolclient support.

- A ChatGPT Plus or Pro subscription
- For Business/Enterprise: Admin must enable developer mode in Workspace Settings
- Open
ChatGPT
- Go toSettings → Apps & Connectors → Advanced settings
- ToggleDeveloper modeto on

- Admins must first enable developer mode fromWorkspace Settings → Permissions & Roles → Connected Data → Developer mode / Create custom MCP connectors
- In ChatGPT, go toSettings → Connectors
- ClickCreate
- Enter the following details:

- Connector name:BatchData
- MCP Server URL:https://mcp.batchdata.com

- Email and password— Enter your BatchData account credentials
- Google Sign-In— Click the Google button to authenticate
- After successful login, you'll be redirected back to ChatGPT
- The BatchData connector is now ready to use

Once connected, you can use BatchData tools in conversations:
- Start a new chat
- Click the+button, then select your connector from theMoremenu
- Alternatively, chooseDeveloper modefrom thePlus menuand select BatchData
- Ask property-related questions — ChatGPT will use the appropriate tools

- "Look up the property at 123 Main Street, Los Angeles, CA"
- "Find comparable properties for 456 Oak Avenue"
- "Skip trace the owner of 789 Pine Road, Miami, FL"

- To disconnect: Go toSettings → Connectors, click BatchData, and disconnect
- To reconnect: Click the connector and re-authenticate
- Session expiry: If your session expires (typically after 14 days), you'll be prompted to reconnect

Once connected, simply ask about property data or skip-tracing and the LLM will automatically use the BatchData tools.

- "Look up the property at 123 Main Street, Los Angeles, CA"
- "Skip trace the owner of 456 Oak Avenue, Miami, FL"
- "Find comparable properties for 789 Pine Road, Austin, TX"
- "Search for vacant properties in Miami, FL"
- "Verify this phone number: 555-123-4567"
- "Verify and standardize this address: 100 main st los angeles ca"
- "Get the coordinates for 200 Park Avenue, New York, NY"

Claude or ChatGPT will recognize the intent and use the appropriate BatchData tools to fetch the information.

- Your MCP client doesn't support OAuth
- You need to debug or automate MCP server connections
- You prefer explicit token management

- Your BatchData API Token (obtain from the BatchData Web App)
- An MCP-compatible client
- Node.js 22+ (for Claude Desktop)

Claude Desktop's bundled Node.js is outdated. Install Node.js 22 separately:

# Install Volta (Node.js version manager) curl https://get.volta.sh | bash # Restart terminal, then install Node.js 22 volta install node@22 # Find your username for the config below whoami

Download and install Node.js 22.x LTS fromnodejs.org
- Open Claude Desktop
- Go toSettings > Developer > Edit Config
- Add the following configuration:

{ "mcpServers": { "BatchData": { "command": "/Users/YOUR_USERNAME/.volta/bin/npx", "args": [ "-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN_HERE" } } } }
{ "mcpServers": { "BatchData": { "command": "/home/YOUR_USERNAME/.volta/bin/npx", "args": [ "-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN_HERE" } } } }
{ "mcpServers": { "BatchData": { "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": [ "-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN_HERE" } } } }

- ReplaceYOUR_USERNAMEwith your actual username
- ReplaceYOUR_API_TOKEN_HEREwith your BatchData API Token
- Save the file and restart Claude Desktop

{ "server_url": "https://mcp.batchdata.com", "headers": { "Authorization": "Bearer YOUR_API_TOKEN_HERE" } }
npx mcp-remote https://mcp.batchdata.com --header "Authorization:Bearer YOUR_API_TOKEN_HERE"

If you previously set up BatchData using the API token method and want to switch to OAuth for a simpler experience, follow these steps:
- Open Claude Desktop
- Go toSettings → Developer → Edit Config
- Remove the existing BatchData configuration (the entire block withcommand,args, andenv)
- Save and close the config file
- Follow the[](#Claude-Setup-(Desktop,-Web-&amp;-Mobile))<<<Claude Setup (Desktop, Web & Mobile)instructions to add the connector via the UI
- Authenticate with your BatchData account when prompted

{ "mcpServers": { "BatchData": { "command": "/Users/YOUR_USERNAME/.volta/bin/npx", "args": ["-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN" } } } }

After (OAuth):Configured via UI — no JSON editing required.

claude mcp add BatchData --url https://mcp.batchdata.com

- Authenticate through your browser when prompted

If you were using a workaround with API tokens, simply:
- Remove any existing BatchData connector fromSettings → Connectors
- Follow the[](#ChatGPT-Setup-(Developer-Mode))<<<ChatGPT Setupinstructions to create a new connector
- Authenticate with your BatchData account

Once connected, the BatchData MCP Server provides the following tools:

- API Token issues: Log into the BatchData Web App to manage your server-side tokens
- Permission issues: Contact your BatchData team administrator
- Technical issues: Contact the BatchData support team

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.