BatchData MCP (Real Estate & Contact Data)

Servidor MCP de BatchData

BatchData es una plataforma de datos inmobiliarios de EE. UU. con una API como prioridad. El servidor MCP de BatchData es un servidor alojado de Model Context Protocol que permite a los asistentes y agentes de IA consultar propiedades, obtener comparables, buscar propiedades, rastrear propietarios y contactos, comprobar el cumplimiento telefónico, verificar y geocodificar direcciones, y usar conjuntos de datos inmobiliarios y criterios de búsqueda de inversores mediante solicitudes en lenguaje natural.

URL del servidor	https://mcp.batchdata.com
Transporte	HTTP transmisible (remoto, alojado por BatchData; no hay que instalar ni ejecutar nada localmente)
Autenticación	Inicio de sesión en el navegador con OAuth 2.1 y tu cuenta de BatchData (PKCE, registro dinámico de clientes), o un token de API de BatchData enviado como Authorization: Bearer <token>
Cuenta	Se requiere una cuenta de BatchData. El servidor MCP es un servicio de pago por uso; consulta los precios o contacta con el equipo de ventas para obtener información sobre el acceso.
Nombre en el registro MCP	io.github.batchdataco/batchdata-mcp-server
Documentación	batchdata.io/mcp-server · developer.batchdata.com
Soporte	support@batchservice.com

Inicio rápido

Claude (escritorio y web; no se pueden añadir conectores desde el móvil)

1. Abre Settings → Connectors → Add custom connector.
2. Introduce la URL https://mcp.batchdata.com y haz clic en Add.
3. Inicia sesión con tu cuenta de BatchData cuando se abra el navegador.
4. En un chat, haz clic en + y activa el conector BatchData.

Claude Code

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

Luego, ejecuta /mcp en Claude Code y elige batchdata para iniciar sesión.

Plugin de Claude Code (skills y servidor MCP juntos)

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

El plugin se conecta al mismo servidor y añade skills para consultar propiedades, obtener comparables, buscar propiedades y listas de clientes potenciales, rastrear propietarios, comprobar números de teléfono en las listas DNC y el cumplimiento de la TCPA, buscar inversores y consultar permisos de construcción (los permisos solo están disponibles a través de la API REST, no como herramienta MCP). Las skills están en skills/.

Cursor

Añadir a Cursor

O añade esto a ~/.cursor/mcp.json (o a .cursor/mcp.json en un proyecto):

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

Cursor abrirá una ventana del navegador para iniciar sesión la primera vez que se use una herramienta.

VS Code (GitHub Copilot)

Instalar en VS Code (abre VS Code y solicita instalar el servidor; usa vscode-insiders: en lugar de vscode: para Insiders)

O configúralo manualmente. Añade esto a .vscode/mcp.json en tu espacio de trabajo (o ejecuta MCP: Add Server desde la paleta de comandos):

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

O desde una terminal:

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

Replit

O, en Replit, abre Integrations → MCP Servers → + Add MCP server, establece el nombre visible como BatchData y la URL como https://mcp.batchdata.com, luego haz clic en Test & save e inicia sesión con tu cuenta de BatchData.

ChatGPT (modo de desarrollador)

Ve a Settings → Apps & Connectors → Advanced settings, activa Developer mode y luego haz clic en Create para crear un conector llamado BatchData con la URL del servidor MCP https://mcp.batchdata.com; después, inicia sesión con tu cuenta de BatchData.

Claude Desktop con un token de API (clientes sin OAuth)

Claude Desktop también puede acceder al servidor mediante mcp-remote con tu token de API de BatchData. Requiere 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"
      }
    }
  }
}

Para cualquier otro cliente MCP: conéctalo a https://mcp.batchdata.com mediante el transporte HTTP transmisible y, si no admite OAuth, envía el encabezado Authorization: Bearer YOUR_API_TOKEN_HERE.

Encontrarás guías paso a paso, instrucciones para migrar de tokens de API a OAuth y soluciones a problemas en docs/setup-guide.md.

Herramientas

El servidor registra 21 herramientas.

Área	Herramienta	Función
Propiedades	lookup_property	Devuelve los detalles de una propiedad inmobiliaria a partir de su propertyId, su dirección (calle + ciudad + estado + código postal) o su número de parcela (countyFipsCode + APN).
Comparables	comparable_property_count	Devuelve el número total de propiedades comparables y métricas agregadas (estimatedValue, averagePrice, averagePricePerSqft), sin devolver registros individuales de propiedades comparables.
Comparables	comparable_property_preview	Devuelve una vista previa rápida de las primeras 10 propiedades comparables con campos resumidos (dirección, precio, pies cuadrados, habitaciones/baños, fecha de venta y distancia), además del número total y métricas agregadas.
Comparables	comparable_property_page	Acceso paginado a propiedades comparables con todos los detalles (tamaño de página: 10).
Comparables	comparable_property	Obsoleta. Usa comparable_property_count, comparable_property_preview o comparable_property_page. Devuelve todos los comparables, lo que puede sobrecargar las ventanas de contexto.
Búsqueda	search_properties_count	Devuelve el número total de propiedades que coinciden con los criterios de búsqueda y desgloses de listas rápidas.
Búsqueda	search_properties_preview	Devuelve una vista previa rápida de las primeras 10 propiedades con los campos esenciales, además del número total.
Búsqueda	search_properties_page	Búsqueda paginada de propiedades con todos los detalles (tamaño de página: 10).
Rastreo de propietarios y contactos	skip_trace_property	Devuelve la información de contacto del propietario y de cualquier otra persona asociada a una propiedad inmobiliaria a partir de su dirección (calle + ciudad + estado + código postal), (calle + ciudad + estado), (calle + código postal) o su número de parcela (estado + condado + APN) o (countyFipsCode + APN).
Rastreo de propietarios y contactos	reverse_skip_trace	Devuelve información de las personas asociadas (nombre, direcciones, teléfonos y correos electrónicos) para uno o varios números de teléfono o direcciones de correo electrónico.
Cumplimiento telefónico	verify_phone	Devuelve todos los detalles de verificación de un número de teléfono, incluidos su disponibilidad, estado en la lista DNC, información del operador, estado como litigante de la TCPA y más.
Cumplimiento telefónico	check_dnc_status	Comprueba únicamente si un número de teléfono está en la lista DNC (Do Not Call).
Cumplimiento telefónico	check_tcpa_status	Comprueba únicamente si un número de teléfono está asociado a un litigante de la TCPA.
Direcciones	verify_address	Acepta una dirección de propiedad con el formato calle + ciudad + estado + código postal, calle + ciudad + estado o calle + código postal, y devuelve una dirección formateada según las convenciones del USPS.
Direcciones	geocode_address	Acepta una dirección de propiedad como una sola cadena de texto que representa calle + ciudad + estado + código postal, calle + ciudad + estado o calle + código postal, y devuelve las coordenadas geográficas de la dirección solicitada.
Direcciones	reverse_geocode_address	Acepta coordenadas geográficas en forma de valores de latitud y longitud y devuelve la dirección correspondiente a esas coordenadas.
Conjuntos de datos y criterios de búsqueda de inversores	list_property_datasets	Devuelve todos los conjuntos de datos inmobiliarios disponibles, con el número de campos y campos de ejemplo.
Conjuntos de datos y criterios de búsqueda de inversores	list_property_dataset_fields	Devuelve la lista completa de rutas de campos de un conjunto de datos inmobiliarios específico.
Conjuntos de datos y criterios de búsqueda de inversores	investor_buybox_count	Devuelve el número total de inversores que coinciden con los criterios de búsqueda y metadatos agregados de los resultados, sin devolver registros individuales de inversores. No es gratis: se cobra por 1 registro.
Conjuntos de datos y criterios de búsqueda de inversores	investor_buybox_preview	Devuelve una vista previa rápida de los primeros 10 perfiles de inversores clasificados que coinciden con los criterios de búsqueda, además del número total y metadatos agregados de los resultados.
Conjuntos de datos y criterios de búsqueda de inversores	investor_buybox_page	Acceso paginado a los inversores que coinciden con los criterios de búsqueda, con todos los detalles (tamaño de página: 10).

Un administrador debe habilitar el rastreo de propietarios (v3) para tu equipo, y los tokens de API necesitan los permisos correspondientes para los endpoints.

Ejemplos de solicitudes

• "Consulta la propiedad en 123 Main Street, Los Angeles, CA."
• "Encuentra propiedades comparables para 789 Pine Road, Austin, TX."
• "Busca propiedades vacantes en Miami, FL."
• "Rastrea al propietario de 456 Oak Avenue, Miami, FL."
• "Verifica este número de teléfono y dime si está en la lista Do Not Call."
• "Verifica y normaliza esta dirección: 100 main st los angeles ca."
• "Rastrea al propietario asociado a este número de teléfono."
• "¿Qué inversores cumplen los criterios de búsqueda para 123 Main Street, Los Angeles, CA?"

Soporte

Si tienes preguntas o problemas: support@batchservice.com. Consulta la referencia de la API para obtener información.

Licencia

Este repositorio contiene únicamente documentación y configuración, y está bajo licencia MIT. El servidor MCP de BatchData en mcp.batchdata.com, la API de BatchData y sus datos son propiedad de BatchData y se rigen por sus condiciones del servicio.

© BatchData