BatchData MCP (Real Estate & Contact Data)

BatchData MCP Server

BatchData ist eine API-first-Plattform für Immobiliendaten in den USA. Der BatchData MCP Server ist ein gehosteter Model Context Protocol-Server, mit dem KI-Assistenten und Agenten mithilfe von Anfragen in natürlicher Sprache Immobilien nachschlagen, Vergleichsobjekte abrufen, nach Immobilien suchen, Eigentümer und Kontakte per Skip Tracing ermitteln, die Telefonkonformität prüfen, Adressen verifizieren und geocodieren sowie Immobiliendatensätze und Investor-Buy-Boxes nutzen können.

Server-URL	https://mcp.batchdata.com
Transport	Streamable HTTP (remote, von BatchData gehostet; keine lokale Installation oder Ausführung erforderlich)
Authentifizierung	OAuth 2.1-Browseranmeldung mit Ihrem BatchData-Konto (PKCE, dynamische Clientregistrierung) oder ein BatchData-API-Token, das als Authorization: Bearer <token> gesendet wird
Konto	Ein BatchData-Konto ist erforderlich. Der MCP-Server wird nutzungsbasiert abgerechnet; Informationen finden Sie unter Preise oder erhalten Sie vom Vertrieb.
MCP-Registry-Name	io.github.batchdataco/batchdata-mcp-server
Dokumentation	batchdata.io/mcp-server · developer.batchdata.com
Support	support@batchservice.com

Schnellstart

Claude (Desktop und Web; Connectoren können nicht über Mobilgeräte hinzugefügt werden)

1. Öffnen Sie Einstellungen → Connectoren → Benutzerdefinierten Connector hinzufügen.
2. Geben Sie die URL https://mcp.batchdata.com ein und klicken Sie auf Hinzufügen.
3. Melden Sie sich mit Ihrem BatchData-Konto an, wenn sich der Browser öffnet.
4. Klicken Sie in einem Chat auf + und aktivieren Sie den Connector BatchData.

Claude Code

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

Führen Sie anschließend /mcp in Claude Code aus und wählen Sie batchdata, um sich anzumelden.

Claude Code-Plugin (Skills und MCP-Server zusammen)

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

Das Plugin verbindet denselben Server und fügt Skills für die Immobiliensuche, Vergleichsobjekte, Immobiliensuche und Lead-Listen, Skip Tracing, DNC- und TCPA-Telefonprüfungen, Investorensuche und Baugenehmigungen hinzu (Genehmigungen sind nur über die REST API verfügbar, nicht als MCP-Tool). Die Skills befinden sich in skills/.

Cursor

Zu Cursor hinzufügen

Oder fügen Sie dies zu ~/.cursor/mcp.json hinzu (oder zu .cursor/mcp.json in einem Projekt):

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

Cursor öffnet bei der ersten Verwendung eines Tools ein Browserfenster zur Anmeldung.

VS Code (GitHub Copilot)

In VS Code installieren (öffnet VS Code und fordert zur Installation des Servers auf; verwenden Sie für Insiders vscode-insiders: statt vscode:)

Oder konfigurieren Sie den Server manuell. Fügen Sie dies in Ihrem Arbeitsbereich zu .vscode/mcp.json hinzu (oder führen Sie MCP: Add Server über die Befehlspalette aus):

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

Oder über ein Terminal:

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

Replit

Oder öffnen Sie in Replit Integrationen → MCP-Server → + MCP-Server hinzufügen, legen Sie den Anzeigenamen auf BatchData und die URL auf https://mcp.batchdata.com fest, klicken Sie dann auf Testen und speichern und melden Sie sich mit Ihrem BatchData-Konto an.

ChatGPT (Entwicklermodus)

Gehen Sie zu Einstellungen → Apps und Connectoren → Erweiterte Einstellungen, aktivieren Sie den Entwicklermodus und erstellen Sie dann einen Connector mit dem Namen BatchData und der MCP-Server-URL https://mcp.batchdata.com. Melden Sie sich anschließend mit Ihrem BatchData-Konto an.

Claude Desktop mit einem API-Token (Clients ohne OAuth)

Claude Desktop kann den Server auch über mcp-remote mit Ihrem BatchData-API-Token erreichen. Erfordert 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"
      }
    }
  }
}

Für jeden anderen MCP-Client: Verwenden Sie https://mcp.batchdata.com mit dem Streamable-HTTP-Transport und senden Sie, falls der Client OAuth nicht unterstützt, den Header Authorization: Bearer YOUR_API_TOKEN_HERE.

Schritt-für-Schritt-Anleitungen, die Migration von API-Tokens zu OAuth und Tipps zur Fehlerbehebung finden Sie in docs/setup-guide.md.

Tools

Der Server registriert 21 Tools.

Bereich	Tool	Funktion
Immobilie	lookup_property	Gibt Immobiliendetails für eine Immobilie anhand ihrer propertyId, ihrer Adresse im Format (Straße + Stadt + Bundesstaat + Postleitzahl) oder ihrer Flurstücknummer im Format (countyFipsCode + APN) zurück.
Vergleichsobjekte	comparable_property_count	Gibt die Gesamtzahl vergleichbarer Immobilien und aggregierte Kennzahlen (estimatedValue, averagePrice, averagePricePerSqft) zurück, ohne einzelne Vergleichsdatensätze auszugeben.
Vergleichsobjekte	comparable_property_preview	Gibt eine schnelle Vorschau der ersten 10 vergleichbaren Immobilien mit Zusammenfassungsfeldern (Adresse, Preis, Quadratmeterzahl, Schlafzimmer/Badezimmer, Verkaufsdatum, Entfernung) sowie die Gesamtzahl und aggregierte Kennzahlen zurück.
Vergleichsobjekte	comparable_property_page	Seitennummerierter Zugriff auf vergleichbare Immobilien mit vollständigen Details (Seitengröße: 10).
Vergleichsobjekte	comparable_property	Veraltet. Verwenden Sie stattdessen comparable_property_count, comparable_property_preview oder comparable_property_page. Gibt alle Vergleichsobjekte zurück, was Kontextfenster überlasten kann.
Suche	search_properties_count	Gibt die Gesamtzahl der Immobilien zurück, die den Suchkriterien entsprechen, sowie Aufschlüsselungen nach Quicklists.
Suche	search_properties_preview	Gibt eine schnelle Vorschau der ersten 10 Immobilien mit den wichtigsten Feldern sowie die Gesamtzahl zurück.
Suche	search_properties_page	Seitennummerierte Immobiliensuche mit vollständigen Details (Seitengröße: 10).
Skip Tracing und Kontakte	skip_trace_property	Gibt Kontaktinformationen zum Immobilieneigentümer und zu weiteren mit der Immobilie verbundenen Personen zurück. Die Suche erfolgt anhand der Adresse im Format (Straße + Stadt + Bundesstaat + Postleitzahl), (Straße + Stadt + Bundesstaat) oder (Straße + Postleitzahl) oder anhand der Flurstücknummer im Format (Bundesstaat + Landkreis + APN) oder (countyFipsCode + APN).
Skip Tracing und Kontakte	reverse_skip_trace	Gibt Informationen zu zugehörigen Personen (Name, Adressen, Telefonnummern, E-Mail-Adressen) für eine oder mehrere Telefonnummern oder E-Mail-Adressen zurück.
Telefonkonformität	verify_phone	Gibt vollständige Verifizierungsdetails zu einer Telefonnummer zurück, darunter Erreichbarkeit, DNC-Status, Anbieterinformationen, TCPA-Klägerstatus und mehr.
Telefonkonformität	check_dnc_status	Prüft ausschließlich den DNC-Status (Do Not Call) einer Telefonnummer.
Telefonkonformität	check_tcpa_status	Prüft ausschließlich den TCPA-Klägerstatus einer Telefonnummer.
Adresse	verify_address	Nimmt eine Immobilienadresse im Format Straße + Stadt + Bundesstaat + Postleitzahl, Straße + Stadt + Bundesstaat oder Straße + Postleitzahl entgegen und gibt eine gemäß den USPS-Konventionen formatierte Adresse zurück.
Adresse	geocode_address	Nimmt eine Immobilienadresse als einzelne Textzeichenfolge im Format Straße + Stadt + Bundesstaat + Postleitzahl, Straße + Stadt + Bundesstaat oder Straße + Postleitzahl entgegen und gibt die geografischen Koordinaten der angefragten Adresse zurück.
Adresse	reverse_geocode_address	Nimmt geografische Koordinaten in Form von Breiten- und Längengrad entgegen und gibt die Adresse an diesen Koordinaten zurück.
Datensätze und Investor-Buy-Box	list_property_datasets	Gibt alle verfügbaren Immobiliendatensätze mit der Anzahl der Felder und Beispielfeldern zurück.
Datensätze und Investor-Buy-Box	list_property_dataset_fields	Gibt die vollständige Liste der Feldpfade für einen bestimmten Immobiliendatensatz zurück.
Datensätze und Investor-Buy-Box	investor_buybox_count	Gibt die Gesamtzahl der Investoren zurück, die den Buy-Box-Kriterien entsprechen, sowie aggregierte Metadaten zu den Ergebnissen, ohne einzelne Investorendatensätze auszugeben. Dies ist nicht kostenlos: Es wird 1 Datensatz berechnet.
Datensätze und Investor-Buy-Box	investor_buybox_preview	Gibt eine schnelle Vorschau der ersten 10 nach Rangfolge sortierten Investorenprofile zurück, die den Buy-Box-Kriterien entsprechen, sowie die Gesamtzahl und aggregierte Metadaten zu den Ergebnissen.
Datensätze und Investor-Buy-Box	investor_buybox_page	Seitennummerierter Zugriff auf Investoren, die den Buy-Box-Kriterien entsprechen, mit vollständigen Details (Seitengröße: 10).

Skip Tracing (v3) muss von einem Administrator für Ihr Team aktiviert werden. API-Tokens benötigen außerdem die entsprechenden Berechtigungen für die Endpunkte.

Beispielanfragen

• „Schlage die Immobilie unter 123 Main Street, Los Angeles, CA nach.“
• „Finde vergleichbare Immobilien für 789 Pine Road, Austin, TX.“
• „Suche nach leerstehenden Immobilien in Miami, FL.“
• „Ermittle per Skip Tracing den Eigentümer von 456 Oak Avenue, Miami, FL.“
• „Überprüfe diese Telefonnummer und teile mir mit, ob sie auf der Do-Not-Call-Liste steht.“
• „Verifiziere und standardisiere diese Adresse: 100 main st los angeles ca.“
• „Ermittle per Reverse Skip Tracing den Eigentümer hinter dieser Telefonnummer.“
• „Welche Investoren entsprechen der Buy-Box für 123 Main Street, Los Angeles, CA?“

Support

Fragen oder Probleme: support@batchservice.com. Die API-Referenz finden Sie unter developer.batchdata.com.

Lizenz

Dieses Repository enthält ausschließlich Dokumentation und Konfiguration und ist unter der MIT-Lizenz lizenziert. Der BatchData MCP-Server unter mcp.batchdata.com, die BatchData API und deren Daten sind proprietär und unterliegen den BatchData-Nutzungsbedingungen.

© BatchData