BatchData MCP (Real Estate & Contact Data)

BatchData MCP Server

BatchData は、API ファーストの米国不動産データプラットフォームです。BatchData MCP Server はホスト型の Model Context Protocol サーバーで、AI アシスタントやエージェントが自然言語でのリクエストを使って、物件の検索、比較物件の取得、物件検索、所有者や連絡先のスキップトレース、電話番号のコンプライアンス確認、住所の検証とジオコーディング、物件データセットや投資家の購入条件の利用を行えます。

サーバー URL	https://mcp.batchdata.com
トランスポート	Streamable HTTP（リモート、BatchData がホスト。ローカルでのインストールや実行は不要）
認証	BatchData アカウントを使った OAuth 2.1 ブラウザーサインイン（PKCE、動的クライアント登録）、または Authorization: Bearer <token> として送信する BatchData API トークン
アカウント	BatchData アカウントが必要です。MCP サーバーは従量課金制のサービスです。詳細は料金をご覧いただくか、アクセス方法について営業にお問い合わせください。
MCP Registry 名	io.github.batchdataco/batchdata-mcp-server
ドキュメント	batchdata.io/mcp-server · developer.batchdata.com
サポート	support@batchservice.com

クイックスタート

Claude（Desktop および Web。モバイルからコネクターを追加することはできません）

1. Settings → Connectors → Add custom connector を開きます。
2. URL https://mcp.batchdata.com を入力し、Add をクリックします。
3. ブラウザーが開いたら、BatchData アカウントでサインインします。
4. チャットで + をクリックし、BatchData コネクターをオンにします。

Claude Code

claude mcp add --transport http batchdata https://mcp.batchdata.com

次に、Claude Code 内で /mcp を実行し、batchdata を選択してサインインします。

Claude Code プラグイン（スキルと MCP サーバーをまとめて利用）

/plugin marketplace add batchdataco/batchdata-mcp-server
/plugin install batchdata --marketplace batchdataco/batchdata-mcp-server

このプラグインは同じサーバーに接続し、物件検索、比較物件、物件検索とリードリスト、スキップトレース、DNC および TCPA の電話番号確認、投資家検索、建築許可に関するスキルを追加します（建築許可は REST API でのみ利用でき、MCP ツールとしては利用できません）。スキルは skills/ にあります。

Cursor

Cursor に追加

または、~/.cursor/mcp.json（プロジェクト内では .cursor/mcp.json）に次の内容を追加します。

{
  "mcpServers": {
    "batchdata": {
      "url": "https://mcp.batchdata.com"
    }
  }
}

Cursor は、初めてツールを使用するときにサインイン用のブラウザーウィンドウを開きます。

VS Code（GitHub Copilot）

VS Code にインストール（VS Code を開いてサーバーのインストールを促します。Insiders では vscode: の代わりに vscode-insiders: を使用してください）

または、手動で設定します。ワークスペースの .vscode/mcp.json に次の内容を追加します（または、コマンドパレットから MCP: Add Server を実行します）。

{
  "servers": {
    "batchdata": {
      "type": "http",
      "url": "https://mcp.batchdata.com"
    }
  }
}

または、ターミナルから実行します。

code --add-mcp '{"name":"batchdata","type":"http","url":"https://mcp.batchdata.com"}'

Replit

または、Replit で Integrations → MCP Servers → + Add MCP server を開き、表示名に BatchData、URL に https://mcp.batchdata.com を設定して、Test & save をクリックし、BatchData アカウントでサインインします。

ChatGPT（Developer Mode）

Settings → Apps & Connectors → Advanced settings に移動し、Developer mode を有効にします。次に、BatchData という名前のコネクターを Create で作成し、MCP Server URL に https://mcp.batchdata.com を指定して、BatchData アカウントでサインインします。

API トークンを使った Claude Desktop（OAuth 非対応クライアント）

Claude Desktop は、BatchData API トークンを使って mcp-remote 経由でサーバーに接続することもできます。Node.js 22 以降が必要です。

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

その他の MCP クライアントでは、Streamable HTTP トランスポートを使って https://mcp.batchdata.com に接続してください。OAuth に対応していない場合は、ヘッダー Authorization: Bearer YOUR_API_TOKEN_HERE を送信します。

手順ごとのガイド、API トークンから OAuth への移行方法、トラブルシューティングについては、docs/setup-guide.md をご覧ください。

ツール

このサーバーは 21 個のツールを登録します。

分野	ツール	機能
物件	lookup_property	propertyId、住所（street + city + state + zip）、または区画番号（countyFipsCode + APN）に基づいて、不動産物件の詳細を返します。
比較物件	comparable_property_count	個々の比較物件レコードを返さずに、比較物件の総数と集計指標（estimatedValue、averagePrice、averagePricePerSqft）を返します。
比較物件	comparable_property_preview	最初の 10 件の比較物件の概要フィールド（住所、価格、面積、ベッドルーム数／バスルーム数、売却日、距離）に加え、総数と集計指標をすばやくプレビューします。
比較物件	comparable_property_page	詳細情報を含む比較物件をページ単位で取得します（1 ページあたり 10 件）。
比較物件	comparable_property	非推奨。 代わりに comparable_property_count、comparable_property_preview、または comparable_property_page を使用してください。すべての比較物件を返すため、コンテキストウィンドウを圧迫する可能性があります。
検索	search_properties_count	検索条件に一致する物件の総数とクイックリストの内訳を返します。
検索	search_properties_preview	最初の 10 件の物件の主要フィールドをすばやくプレビューし、総数も返します。
検索	search_properties_page	詳細情報を含む物件検索をページ単位で行います（1 ページあたり 10 件）。
スキップトレースと連絡先	skip_trace_property	住所（street + city + state + zip、street + city + state、または street + zip）、または区画番号（state + county + APN、または countyFipsCode + APN）に基づいて、不動産物件の所有者および関連するその他の人物の連絡先情報を返します。
スキップトレースと連絡先	reverse_skip_trace	1 つ以上の電話番号またはメールアドレスに関連付けられた人物の情報（氏名、住所、電話番号、メールアドレス）を返します。
電話番号コンプライアンス	verify_phone	到達可能性、DNC ステータス、通信事業者情報、TCPA 訴訟者ステータスなど、電話番号の完全な検証情報を返します。
電話番号コンプライアンス	check_dnc_status	電話番号の DNC（Do Not Call）ステータスのみを確認します。
電話番号コンプライアンス	check_tcpa_status	電話番号の TCPA 訴訟者ステータスのみを確認します。
住所	verify_address	street + city + state + zip、street + city + state、または street + zip の形式で物件住所を受け取り、USPS の規則に準拠した形式の住所を返します。
住所	geocode_address	street + city + state + zip、street + city + state、または street + zip を表す単一のテキスト文字列形式で物件住所を受け取り、指定された住所の地理座標を返します。
住所	reverse_geocode_address	緯度と経度の値で表された地理座標を受け取り、その座標に対応する住所を返します。
データセットと投資家の購入条件	list_property_datasets	利用可能なすべての物件データセットと、フィールド数およびフィールドのサンプルを返します。
データセットと投資家の購入条件	list_property_dataset_fields	特定の物件データセットのフィールドパス一覧をすべて返します。
データセットと投資家の購入条件	investor_buybox_count	購入条件に一致する投資家の総数と集計結果のメタデータを返します。個々の投資家レコードは返しません。無料ではなく、1 レコード分の料金が発生します。
データセットと投資家の購入条件	investor_buybox_preview	購入条件に一致する、ランキング上位 10 件の投資家プロフィールをすばやくプレビューし、総数と集計結果のメタデータも返します。
データセットと投資家の購入条件	investor_buybox_page	購入条件に一致する投資家を、詳細情報を含めてページ単位で取得します（1 ページあたり 10 件）。

スキップトレース（v3）は管理者がチームで有効にする必要があります。また、API トークンには対応するエンドポイントの権限が必要です。

プロンプトの例

• 「123 Main Street, Los Angeles, CA の物件を調べて。」
• 「789 Pine Road, Austin, TX の比較物件を探して。」
• 「Miami, FL の空き物件を検索して。」
• 「456 Oak Avenue, Miami, FL の所有者をスキップトレースして。」
• 「この電話番号を確認して、Do Not Call リストに登録されているか教えて。」
• 「この住所を検証して標準化して: 100 main st los angeles ca。」
• 「この電話番号の持ち主を逆スキップトレースして。」
• 「123 Main Street, Los Angeles, CA の購入条件に一致する投資家は？」

サポート

ご質問や問題がある場合は、support@batchservice.com までお問い合わせください。API リファレンスについては、developer.batchdata.com をご覧ください。

ライセンス

このリポジトリにはドキュメントと設定のみが含まれており、MIT ライセンスで提供されています。mcp.batchdata.com の BatchData MCP サーバー、BatchData API、およびそのデータは独占的なものであり、BatchData の利用規約が適用されます。

© BatchData