BatchData MCP (Real Estate & Contact Data)

BatchData MCP Server

BatchData là nền tảng dữ liệu bất động sản Hoa Kỳ theo hướng API-first. BatchData MCP Server là máy chủ Model Context Protocol được lưu trữ, cho phép trợ lý và tác nhân AI tra cứu bất động sản, lấy dữ liệu bất động sản tương tự, tìm kiếm bất động sản, truy tìm thông tin chủ sở hữu và liên hệ, kiểm tra tuân thủ quy định về điện thoại, xác minh và mã hóa địa lý địa chỉ, cũng như sử dụng bộ dữ liệu bất động sản và tiêu chí mua bất động sản của nhà đầu tư bằng các yêu cầu bằng ngôn ngữ tự nhiên.

URL máy chủ	https://mcp.batchdata.com
Giao thức truyền tải	Streamable HTTP (từ xa, do BatchData lưu trữ; không cần cài đặt hoặc chạy cục bộ)
Xác thực	Đăng nhập OAuth 2.1 qua trình duyệt bằng tài khoản BatchData (PKCE, đăng ký ứng dụng khách động), hoặc gửi mã thông báo API BatchData dưới dạng Authorization: Bearer <token>
Tài khoản	Cần có tài khoản BatchData. Máy chủ MCP tính phí theo mức sử dụng; xem giá hoặc liên hệ bộ phận kinh doanh để biết chi tiết về quyền truy cập.
Tên trong MCP Registry	io.github.batchdataco/batchdata-mcp-server
Tài liệu	batchdata.io/mcp-server · developer.batchdata.com
Hỗ trợ	support@batchservice.com

Bắt đầu nhanh

Claude (Desktop và Web; không thể thêm connector từ thiết bị di động)

1. Mở Settings → Connectors → Add custom connector.
2. Nhập URL https://mcp.batchdata.com rồi nhấp Add.
3. Đăng nhập bằng tài khoản BatchData khi trình duyệt mở ra.
4. Trong cuộc trò chuyện, nhấp + rồi bật connector BatchData.

Claude Code

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

Sau đó chạy /mcp trong Claude Code và chọn batchdata để đăng nhập.

Cursor

Thêm vào Cursor

Hoặc thêm nội dung sau vào ~/.cursor/mcp.json (hoặc .cursor/mcp.json trong một dự án):

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

Lần đầu sử dụng một công cụ, Cursor sẽ mở cửa sổ trình duyệt để đăng nhập.

VS Code (GitHub Copilot)

Thêm nội dung sau vào .vscode/mcp.json trong không gian làm việc của bạn (hoặc chạy MCP: Add Server từ Command Palette):

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

Hoặc chạy từ terminal:

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

ChatGPT (Developer Mode)

Vào Settings → Apps & Connectors → Advanced settings, bật Developer mode, sau đó nhấp Create để tạo connector có tên BatchData với MCP Server URL https://mcp.batchdata.com và đăng nhập bằng tài khoản BatchData.

Claude Desktop với mã thông báo API (các ứng dụng khách không hỗ trợ OAuth)

Claude Desktop cũng có thể truy cập máy chủ thông qua mcp-remote bằng mã thông báo API BatchData của bạn. Yêu cầu 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"
      }
    }
  }
}

Với mọi ứng dụng khách MCP khác: kết nối đến https://mcp.batchdata.com bằng giao thức truyền tải Streamable HTTP và, nếu ứng dụng không hỗ trợ OAuth, gửi header Authorization: Bearer YOUR_API_TOKEN_HERE.

Hướng dẫn từng bước, cách chuyển từ mã thông báo API sang OAuth và cách khắc phục sự cố có trong docs/setup-guide.md.

Công cụ

Máy chủ đăng ký 21 công cụ.

Lĩnh vực	Công cụ	Chức năng
Bất động sản	lookup_property	Trả về thông tin chi tiết về bất động sản dựa trên propertyId, địa chỉ theo định dạng (đường phố + thành phố + tiểu bang + mã ZIP) hoặc số thửa đất theo định dạng (countyFipsCode + APN).
Bất động sản tương tự	comparable_property_count	Trả về tổng số bất động sản tương tự và các chỉ số tổng hợp (estimatedValue, averagePrice, averagePricePerSqft) mà không trả về từng bản ghi bất động sản tương tự.
Bất động sản tương tự	comparable_property_preview	Trả về bản xem trước nhanh gồm 10 bất động sản tương tự đầu tiên với các trường tóm tắt (địa chỉ, giá, diện tích tính bằng sqft, số phòng ngủ/phòng tắm, ngày bán, khoảng cách), cùng tổng số và các chỉ số tổng hợp.
Bất động sản tương tự	comparable_property_page	Truy cập phân trang vào các bất động sản tương tự với thông tin chi tiết đầy đủ (kích thước trang: 10).
Bất động sản tương tự	comparable_property	Không còn được dùng. Thay vào đó, hãy dùng comparable_property_count, comparable_property_preview hoặc comparable_property_page. Trả về tất cả bất động sản tương tự, có thể làm quá tải cửa sổ ngữ cảnh.
Tìm kiếm	search_properties_count	Trả về tổng số bất động sản khớp với tiêu chí tìm kiếm và phân tích theo quicklist.
Tìm kiếm	search_properties_preview	Trả về bản xem trước nhanh gồm 10 bất động sản đầu tiên với các trường thiết yếu, cùng tổng số.
Tìm kiếm	search_properties_page	Tìm kiếm bất động sản có phân trang với thông tin chi tiết đầy đủ (kích thước trang: 10).
Truy tìm thông tin và liên hệ	skip_trace_property	Trả về thông tin liên hệ của chủ sở hữu và những người khác có liên quan đến bất động sản, dựa trên địa chỉ theo định dạng (đường phố + thành phố + tiểu bang + mã ZIP), (đường phố + thành phố + tiểu bang), (đường phố + mã ZIP) hoặc số thửa đất theo định dạng (tiểu bang + quận + APN) hoặc (countyFipsCode + APN).
Truy tìm thông tin và liên hệ	reverse_skip_trace	Trả về thông tin về những người có liên quan (tên, địa chỉ, số điện thoại, email) cho một hoặc nhiều số điện thoại hoặc địa chỉ email.
Tuân thủ quy định về điện thoại	verify_phone	Trả về thông tin xác minh đầy đủ của một số điện thoại, bao gồm khả năng liên lạc, trạng thái DNC, thông tin nhà mạng, trạng thái người khởi kiện theo TCPA và nhiều thông tin khác.
Tuân thủ quy định về điện thoại	check_dnc_status	Chỉ kiểm tra trạng thái DNC (Do Not Call) của một số điện thoại.
Tuân thủ quy định về điện thoại	check_tcpa_status	Chỉ kiểm tra trạng thái người khởi kiện theo TCPA của một số điện thoại.
Địa chỉ	verify_address	Nhận địa chỉ bất động sản theo định dạng đường phố + thành phố + tiểu bang + mã ZIP, đường phố + thành phố + tiểu bang hoặc đường phố + mã ZIP, rồi trả về địa chỉ được định dạng theo quy ước của USPS.
Địa chỉ	geocode_address	Nhận địa chỉ bất động sản dưới dạng một chuỗi văn bản duy nhất theo định dạng đường phố + thành phố + tiểu bang + mã ZIP, đường phố + thành phố + tiểu bang hoặc đường phố + mã ZIP, rồi trả về tọa độ địa lý của địa chỉ được yêu cầu.
Địa chỉ	reverse_geocode_address	Nhận tọa độ địa lý dưới dạng giá trị vĩ độ và kinh độ, rồi trả về địa chỉ tại tọa độ đó.
Bộ dữ liệu và tiêu chí mua bất động sản của nhà đầu tư	list_property_datasets	Trả về tất cả bộ dữ liệu bất động sản hiện có cùng số lượng trường và các trường mẫu.
Bộ dữ liệu và tiêu chí mua bất động sản của nhà đầu tư	list_property_dataset_fields	Trả về danh sách đầy đủ các đường dẫn trường cho một bộ dữ liệu bất động sản cụ thể.
Bộ dữ liệu và tiêu chí mua bất động sản của nhà đầu tư	investor_buybox_count	Trả về tổng số nhà đầu tư khớp với tiêu chí mua bất động sản và siêu dữ liệu tổng hợp của kết quả, không trả về từng bản ghi nhà đầu tư. Công cụ này không miễn phí: tính phí cho 1 bản ghi.
Bộ dữ liệu và tiêu chí mua bất động sản của nhà đầu tư	investor_buybox_preview	Trả về bản xem trước nhanh gồm 10 hồ sơ nhà đầu tư được xếp hạng đầu tiên khớp với tiêu chí mua bất động sản, cùng tổng số và siêu dữ liệu tổng hợp của kết quả.
Bộ dữ liệu và tiêu chí mua bất động sản của nhà đầu tư	investor_buybox_page	Truy cập phân trang vào các nhà đầu tư khớp với tiêu chí mua bất động sản, kèm thông tin chi tiết đầy đủ (kích thước trang: 10).

Quản trị viên phải bật tính năng truy tìm thông tin (v3) cho nhóm của bạn; mã thông báo API cũng cần có quyền tương ứng với endpoint.

Ví dụ câu lệnh

• "Tra cứu bất động sản tại 123 Main Street, Los Angeles, CA."
• "Tìm bất động sản tương tự với 789 Pine Road, Austin, TX."
• "Tìm bất động sản bỏ trống ở Miami, FL."
• "Truy tìm thông tin chủ sở hữu của 456 Oak Avenue, Miami, FL."
• "Xác minh số điện thoại này và cho tôi biết số đó có nằm trong danh sách Do Not Call không."
• "Xác minh và chuẩn hóa địa chỉ này: 100 main st los angeles ca."
• "Truy tìm ngược thông tin chủ sở hữu của số điện thoại này."
• "Những nhà đầu tư nào đáp ứng tiêu chí mua bất động sản tại 123 Main Street, Los Angeles, CA?"

Hỗ trợ

Nếu có câu hỏi hoặc gặp sự cố: support@batchservice.com. Để xem tài liệu tham khảo API, hãy truy cập developer.batchdata.com.

Giấy phép

Kho lưu trữ này chỉ chứa tài liệu và cấu hình, được cấp phép theo MIT. Máy chủ BatchData MCP tại mcp.batchdata.com, BatchData API và dữ liệu của dịch vụ là tài sản độc quyền, chịu sự điều chỉnh của điều khoản dịch vụ BatchData.

© BatchData