BatchData MCP (Real Estate & Contact Data)

BatchData MCP Server

BatchData, API öncelikli bir ABD gayrimenkul veri platformudur. BatchData MCP Server, yapay zekâ asistanlarının ve ajanlarının doğal dildeki isteklerle mülkleri sorgulamasını, emsal mülkleri getirmesini, mülk araması yapmasını, mülk sahipleri ve kişileri için skip trace yapmasını, telefon uyumluluğunu kontrol etmesini, adresleri doğrulayıp coğrafi kodlamasını ve mülk veri kümeleriyle yatırımcı satın alma kriterlerini kullanmasını sağlayan, barındırılan bir Model Context Protocol sunucusudur.

Sunucu URL'si	https://mcp.batchdata.com
Aktarım	Streamable HTTP (uzak, BatchData tarafından barındırılır; yerel olarak yüklemeniz veya çalıştırmanız gerekmez)
Kimlik doğrulama	BatchData hesabınızla OAuth 2.1 tarayıcı oturumu açma (PKCE, dinamik istemci kaydı) veya Authorization: Bearer <token> olarak gönderilen bir BatchData API token'ı
Hesap	BatchData hesabı gereklidir. MCP sunucusu kullanıma dayalı bir hizmettir; erişim ayrıntıları için fiyatlandırmaya bakın veya satış ekibiyle iletişime geçin.
MCP Registry adı	io.github.batchdataco/batchdata-mcp-server
Belgeler	batchdata.io/mcp-server · developer.batchdata.com
Destek	support@batchservice.com

Hızlı başlangıç

Claude (Masaüstü ve Web; mobil cihazlardan bağlayıcı eklenemez)

1. Settings → Connectors → Add custom connector bölümünü açın.
2. https://mcp.batchdata.com URL'sini girin ve Add'e tıklayın.
3. Tarayıcı açıldığında BatchData hesabınızla oturum açın.
4. Bir sohbette + simgesine tıklayın ve BatchData bağlayıcısını etkinleştirin.

Claude Code

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

Ardından Claude Code içinde /mcp komutunu çalıştırın ve oturum açmak için batchdata'yı seçin.

Claude Code eklentisi (beceriler ve MCP sunucusu birlikte)

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

Eklenti aynı sunucuya bağlanır ve mülk sorgulama, emsal mülkler, mülk arama ve potansiyel müşteri listeleri, skip trace, DNC ve TCPA telefon kontrolleri, yatırımcı bulma ve yapı ruhsatları için beceriler ekler (ruhsatlar MCP aracı olarak değil, yalnızca REST API üzerinden kullanılabilir). Beceriler skills/ konumunda bulunur.

Cursor

Cursor'a ekle

Ya da bunu ~/.cursor/mcp.json dosyasına (veya bir projede .cursor/mcp.json dosyasına) ekleyin:

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

Cursor, bir araç ilk kez kullanıldığında oturum açmanız için bir tarayıcı penceresi açar.

VS Code (GitHub Copilot)

VS Code'a yükle (VS Code'u açar ve sunucuyu yüklemenizi ister; Insiders için vscode: yerine vscode-insiders: kullanın)

Ya da sunucuyu elle yapılandırın. Çalışma alanınızdaki .vscode/mcp.json dosyasına bunu ekleyin (veya Komut Paleti'nden MCP: Add Server komutunu çalıştırın):

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

Ya da bir terminalden:

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

Replit

Ya da Replit'te Integrations → MCP Servers → + Add MCP server bölümünü açın, görünen adı BatchData, URL'yi https://mcp.batchdata.com olarak ayarlayın, ardından Test & save'e tıklayıp BatchData hesabınızla oturum açın.

ChatGPT (Geliştirici Modu)

Settings → Apps & Connectors → Advanced settings bölümüne gidin, Developer mode'u etkinleştirin, ardından BatchData adlı ve MCP Server URL'si https://mcp.batchdata.com olan bir bağlayıcı Create edin ve BatchData hesabınızla oturum açın.

API token'ı kullanan Claude Desktop (OAuth desteklemeyen istemciler)

Claude Desktop, BatchData API token'ınızla mcp-remote üzerinden de sunucuya erişebilir. Node.js 22+ gereklidir.

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

Diğer tüm MCP istemcileri için Streamable HTTP aktarımını kullanarak https://mcp.batchdata.com adresine bağlanın ve OAuth desteklenmiyorsa Authorization: Bearer YOUR_API_TOKEN_HERE başlığını gönderin.

Adım adım kılavuzlar, API token'larından OAuth'a geçiş ve sorun giderme bilgileri docs/setup-guide.md dosyasındadır.

Araçlar

Sunucu 21 araç kaydeder.

Alan	Araç	Ne işe yarar
Mülk	lookup_property	Bir gayrimenkul mülkünün ayrıntılarını propertyId'ye, (sokak + şehir + eyalet + posta kodu) biçimindeki adresine veya (countyFipsCode + APN) biçimindeki parsel numarasına göre döndürür.
Emsal mülkler	comparable_property_count	Tek tek emsal kayıtlarını döndürmeden, emsal mülklerin toplam sayısını ve toplu ölçümleri (estimatedValue, averagePrice, averagePricePerSqft) döndürür.
Emsal mülkler	comparable_property_preview	İlk 10 emsal mülkün özet alanlarını (adres, fiyat, sqft, yatak odası/banyo sayısı, satış tarihi, mesafe) içeren hızlı bir önizlemesini, toplam sayıyla ve toplu ölçümlerle birlikte döndürür.
Emsal mülkler	comparable_property_page	Emsal mülklere tam ayrıntılarla sayfalandırılmış erişim sağlar (sayfa boyutu: 10).
Emsal mülkler	comparable_property	Kullanımdan kaldırıldı. Bunun yerine comparable_property_count, comparable_property_preview veya comparable_property_page kullanın. Tüm emsal mülkleri döndürür; bu, bağlam pencerelerini aşırı yükleyebilir.
Arama	search_properties_count	Arama ölçütleriyle eşleşen mülklerin toplam sayısını ve hızlı liste dökümlerini döndürür.
Arama	search_properties_preview	İlk 10 mülkün temel alanlarını içeren hızlı bir önizlemesini ve toplam sayıyı döndürür.
Arama	search_properties_page	Tam ayrıntılarla sayfalandırılmış mülk araması sağlar (sayfa boyutu: 10).
Skip trace ve iletişim	skip_trace_property	Bir gayrimenkul mülkünün sahibine ve mülkle ilişkili diğer kişilere ait iletişim bilgilerini; (sokak + şehir + eyalet + posta kodu), (sokak + şehir + eyalet), (sokak + posta kodu), (eyalet + ilçe + APN) veya (countyFipsCode + APN) biçimindeki adresine ya da parsel numarasına göre döndürür.
Skip trace ve iletişim	reverse_skip_trace	Bir veya daha fazla telefon numarası ya da e-posta adresi için ilişkili kişi bilgilerini (ad, adresler, telefonlar, e-postalar) döndürür.
Telefon uyumluluğu	verify_phone	Erişilebilirlik, DNC durumu, operatör bilgileri, TCPA davacı durumu ve daha fazlası dahil olmak üzere bir telefon numarasının tüm doğrulama ayrıntılarını döndürür.
Telefon uyumluluğu	check_dnc_status	Yalnızca bir telefon numarasının DNC (Aranmayacaklar) durumunu kontrol eder.
Telefon uyumluluğu	check_tcpa_status	Yalnızca bir telefon numarasının TCPA davacı durumunu kontrol eder.
Adres	verify_address	Sokak + şehir + eyalet + posta kodu, sokak + şehir + eyalet veya sokak + posta kodu biçimindeki bir mülk adresini kabul eder ve USPS kurallarına uygun biçimlendirilmiş bir adres döndürür.
Adres	geocode_address	Sokak + şehir + eyalet + posta kodu, sokak + şehir + eyalet veya sokak + posta kodunu temsil eden tek bir metin dizisi biçimindeki mülk adresini kabul eder ve istenen adresin coğrafi koordinatlarını döndürür.
Adres	reverse_geocode_address	Enlem ve boylam değerleri biçimindeki coğrafi koordinatları kabul eder ve bu koordinatlardaki adresi döndürür.
Veri kümeleri ve yatırımcı satın alma kriterleri	list_property_datasets	Kullanılabilir tüm mülk veri kümelerini, alan sayıları ve örnek alanlarla birlikte döndürür.
Veri kümeleri ve yatırımcı satın alma kriterleri	list_property_dataset_fields	Belirli bir mülk veri kümesinin alan yollarının tam listesini döndürür.
Veri kümeleri ve yatırımcı satın alma kriterleri	investor_buybox_count	Satın alma kriterleriyle eşleşen yatırımcıların toplam sayısını ve toplu sonuç meta verilerini, tek tek yatırımcı kayıtlarını döndürmeden verir. Ücretsiz değildir: 1 kayıt için ücret alınır.
Veri kümeleri ve yatırımcı satın alma kriterleri	investor_buybox_preview	Satın alma kriterleriyle eşleşen, sıralanmış ilk 10 yatırımcı profilinin hızlı bir önizlemesini; toplam sayıyla ve toplu sonuç meta verileriyle birlikte döndürür.
Veri kümeleri ve yatırımcı satın alma kriterleri	investor_buybox_page	Satın alma kriterleriyle eşleşen yatırımcılara tam ayrıntılarla sayfalandırılmış erişim sağlar (sayfa boyutu: 10).

Skip tracing (v3), bir yönetici tarafından ekibiniz için etkinleştirilmelidir ve API token'larının ilgili uç nokta izinlerine sahip olması gerekir.

Örnek istemler

• "Los Angeles, CA'deki 123 Main Street adresindeki mülkü sorgula."
• "Austin, TX'deki 789 Pine Road için emsal mülkleri bul."
• "Miami, FL'de boş mülkleri ara."
• "Miami, FL'deki 456 Oak Avenue adresindeki mülkün sahibine skip trace uygula."
• "Bu telefon numarasını doğrula ve Aranmayacaklar listesinde olup olmadığını söyle."
• "Bu adresi doğrula ve standartlaştır: 100 main st los angeles ca."
• "Bu telefon numarasının arkasındaki mülk sahibine ters skip trace uygula."
• "Los Angeles, CA'deki 123 Main Street için satın alma kriterlerine uyan yatırımcılar hangileri?"

Destek

Sorularınız veya sorunlarınız için: support@batchservice.com. API başvurusu için developer.batchdata.com adresine bakın.

Lisans

Bu depo yalnızca belgeler ve yapılandırma içerir ve MIT lisansına sahiptir. mcp.batchdata.com adresindeki BatchData MCP sunucusu, BatchData API'si ve verileri tescillidir ve BatchData hizmet koşullarına tabidir.

© BatchData