BatchData Remote MCP Server Setup Guide

• 1 Introduction
• 2 Authentication Methods
  • 2.1 OAuth Authentication (Recommended))
  • 2.2 API Token Authentication (Alternative))
• 3 Future Enhancement: OAuth Access Control (Coming Soon))
• 4 OAuth Setup (Recommended))
  • 4.1 Prerequisites
  • 4.2 Claude Setup (Desktop, Web & Mobile))
    • 4.2.1 Step 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.3 Cursor Setup
  • 4.4 Claude Code Setup
  • 4.5 ChatGPT Setup (Developer Mode))
    • 4.5.1 Prerequisites
    • 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
  • 4.6 Verification
• 5 API Token Setup (Alternative))
  • 5.1 Prerequisites
  • 5.2 Claude Desktop Setup with API Token
    • 5.2.1 Step 1: Install Node.js 22
    • 5.2.2 Step 2: Configure Claude Desktop
  • 5.3 Custom MCP Client Setup
• 6 Migrating from API Token to OAuth
  • 6.1 Claude Desktop
  • 6.2 Claude Code
  • 6.3 ChatGPT
  • 6.4 Benefits of Migrating
• 7 Available Tools
  • 7.1 Property Lookup & Details
  • 7.2 Comparable Property Analysis
  • 7.3 Property Search
  • 7.4 Contact Information
  • 7.5 Phone Verification
  • 7.6 Address Processing
• 8 Troubleshooting
  • 8.1 OAuth Issues
  • 8.2 ChatGPT Issues
  • 8.3 API Token Issues
  • 8.4 General Issues
  • 8.5 Getting Help

Introduction

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

Authentication Methods

The BatchData MCP Server supports two authentication methods:

OAuth Authentication (Recommended)

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

API Token Authentication (Alternative)

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

• * *

OAuth Setup (Recommended)

Prerequisites

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

Step 1: Add the BatchData Connector

1. Open Claude (Desktop or Web)

2. Go to Settings → Connectors (or Settings → MCP Servers)

3. Click Add Connector (or Add Server)

4. Enter the server URL:

https://mcp.batchdata.com

5. Click Add or Connect

Step 2: Authenticate

1. Your browser will open to the BatchData login page

2. Sign in using either:

3. After successful login, you'll be redirected back to Claude

Step 3: Enable the Connector

Connectors are not enabled by default after adding them. Enable it once and the setting is saved:

1. Open any chat

2. Click the + button (or connectors icon) in the chat input area

3. Find BatchData in the list of available connectors

4. Toggle it on to enable it

The connector will now be available in all your conversations.

Step 4: Approve Initial Tool Use

The first time Claude uses any BatchData tool, you'll be asked to approve it:

1. When Claude attempts to use a tool, a permission prompt will appear

2. Review the tool and action being requested

3. Click Allow to approve

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

Using on Mobile

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

Subsequent Connections

After initial authentication:

• 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)

Cursor Setup

1. Open Cursor Settings

2. Navigate to the MCP configuration section

3. Click Add MCP Server

4. Enter the server URL:

https://mcp.batchdata.com

5. On first use, authenticate through the browser popup

Claude Code Setup

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 Setup (Developer Mode)

ChatGPT supports MCP servers through Developer Mode, which provides full Model Context Protocol client support.

Prerequisites

• A ChatGPT Plus or Pro subscription
• For Business/Enterprise: Admin must enable developer mode in Workspace Settings

Step 1: Enable Developer Mode

1. Open ChatGPT

2. Go to Settings → Apps & Connectors → Advanced settings

3. Toggle Developer mode to on

For Business/Enterprise workspaces:

• Admins must first enable developer mode from Workspace Settings → Permissions & Roles → Connected Data → Developer mode / Create custom MCP connectors

Step 2: Create the BatchData Connector

1. In ChatGPT, go to Settings → Connectors

2. Click Create

3. Enter the following details:

4. Click Create

Step 3: Authenticate

1. After creating the connector, ChatGPT will prompt you to authenticate

2. Your browser will open to the BatchData login page

3. Sign in using either:

4. After successful login, you'll be redirected back to ChatGPT

5. The BatchData connector is now ready to use

Using BatchData Tools in ChatGPT

Once connected, you can use BatchData tools in conversations:

1. Start a new chat

2. Click the + button, then select your connector from the More menu

3. Alternatively, choose Developer mode from the Plus menu and select BatchData

4. Ask property-related questions — ChatGPT will use the appropriate tools

Example prompts:

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

Managing the Connection

• To disconnect: Go to Settings → 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

Verification

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

Example prompts:

• "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.

• * *

API Token Setup (Alternative)

Use this method if:

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

Prerequisites

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

Claude Desktop Setup with API Token

Step 1: Install Node.js 22

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

macOS/Linux:

# 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

Windows:

Download and install Node.js 22.x LTS from nodejs.org

Step 2: Configure Claude Desktop

1. Open Claude Desktop

2. Go to Settings > Developer > Edit Config

3. Add the following configuration:

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

Linux Configuration:

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

Windows Configuration:

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

4. Replace `YOUR_USERNAME` with your actual username

5. Replace `YOUR_API_TOKEN_HERE` with your BatchData API Token

6. Save the file and restart Claude Desktop

Custom MCP Client Setup

For custom MCP client implementations:

Connection Details:

Configuration Example:

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

Using npx:

npx mcp-remote https://mcp.batchdata.com --header "Authorization:Bearer YOUR_API_TOKEN_HERE"

• * *

Migrating from API Token to OAuth

If you previously set up BatchData using the API token method and want to switch to OAuth for a simpler experience, follow these steps:

Claude Desktop

1. Open Claude Desktop

2. Go to Settings → Developer → Edit Config

3. Remove the existing BatchData configuration (the entire block with `command`, `args`, and `env`)

4. Save and close the config file

5. Follow the Claude Setup (Desktop, Web & Mobile) "#Claude-Setup-(Desktop,-Web-&-Mobile)") instructions to add the connector via the UI

6. Authenticate with your BatchData account when prompted

Before (API Token):

{ "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 Code

1. Remove the existing configuration:

claude mcp remove BatchData

2. Add it back using OAuth:

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

3. Authenticate through your browser when prompted

ChatGPT

If you were using a workaround with API tokens, simply:

1. Remove any existing BatchData connector from Settings → Connectors

2. Follow the ChatGPT Setup "#ChatGPT-Setup-(Developer-Mode)") instructions to create a new connector

3. Authenticate with your BatchData account

Benefits of Migrating

• * *

Available Tools

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

Property Lookup & Details

Comparable Property Analysis

Property Search

Contact Information

Phone Verification

Address Processing

• * *

Troubleshooting

OAuth Issues

ChatGPT Issues

API Token Issues

General Issues

Getting Help

• 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

• * *

© BatchData 2025