BatchData MCP (Real Estate & Contact Data)

官方

房地产与联系人增强数据MCP

你可以用 BatchData (Real Estate & Contact Data) MCP 做什么？

房产查询 — 按地址、房产 ID 或地块编号查询房产详情。
可比房产 — 获取目标房产的可比房产数量、预览信息，或分页查询可比房产及其价格和距离指标。
房产搜索 — 统计、预览或分页查询符合条件的房产，例如某个城市中的空置房产。
跳查 — 查找房产所有者及相关联系人，或通过电话号码或电子邮件进行反向跳查。
电话合规性 — 验证电话号码的可接通性、DNC 状态、运营商及 TCPA 诉讼人状态。
地址工具 — 将地址标准化为 USPS 格式、对地址进行地理编码，或对坐标进行反向地理编码。

文档

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（桌面版和网页版；无法从移动端添加连接器）

打开 Settings → Connectors → Add custom connector。
输入 URL https://mcp.batchdata.com，然后点击 Add。
浏览器打开后，使用 BatchData 账户登录。
在聊天中点击 +，然后启用 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-insiders:，而不是 vscode:）

或者手动配置。将以下内容添加到工作区中的 .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（开发者模式）

前往 Settings → Apps & Connectors → Advanced settings，启用 Developer mode，然后创建一个名为 BatchData、MCP Server URL 为 https://mcp.batchdata.com 的连接器，并使用 BatchData 账户登录。

使用 API 令牌的 Claude Desktop（不支持 OAuth 的客户端）

Claude Desktop 也可以通过 mcp-remote 使用 BatchData API 令牌访问服务器。需要 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`	分页获取可比房产的完整详情（每页 10 条）。
可比房产	`comparable_property`	已弃用。请改用 comparable_property_count、comparable_property_preview 或 comparable_property_page。此工具会返回所有可比房产，可能导致上下文窗口超载。
搜索	`search_properties_count`	返回符合搜索条件的房产总数和快速列表分类统计。
搜索	`search_properties_preview`	快速预览前 10 套房产及关键字段，并返回总数。
搜索	`search_properties_page`	分页搜索房产并返回完整详情（每页 10 条）。
跳查和联系人	`skip_trace_property`	根据房地产房产的地址（street + city + state + zip、street + city + state 或 street + zip）或地块编号（state + county + APN 或 countyFipsCode + APN），返回业主及其他相关人员的联系信息。
跳查和联系人	`reverse_skip_trace`	根据一个或多个电话号码或电子邮件地址，返回相关人员信息（姓名、地址、电话、电子邮件）。
电话合规性	`verify_phone`	返回电话号码的完整验证详情，包括可接通性、DNC 状态、运营商信息、TCPA 诉讼人状态等。
电话合规性	`check_dnc_status`	仅检查电话号码的 DNC（请勿致电）状态。
电话合规性	`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`	分页获取符合收购标准的投资者完整详情（每页 10 条）。

管理员必须为团队启用跳查（v3），且 API 令牌需要具备相应端点权限。

示例提示

"查询位于 123 Main Street, Los Angeles, CA 的房产。"
"查找位于 789 Pine Road, Austin, TX 的可比房产。"
"搜索 Miami, FL 的空置房产。"
"跳查位于 456 Oak Avenue, Miami, FL 的业主。"
"验证这个电话号码，并告诉我它是否在请勿致电名单上。"
"验证并规范化此地址：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 服务条款约束。