BatchData MCP (Real Estate & Contact Data)

BatchData MCP Server

BatchData é uma plataforma de dados imobiliários dos EUA com foco em API. O BatchData MCP Server é um servidor hospedado do Model Context Protocol que permite que assistentes e agentes de IA consultem imóveis, obtenham comparáveis, pesquisem imóveis, façam skip trace de proprietários e contatos, verifiquem a conformidade de telefones, validem e geocodifiquem endereços e usem conjuntos de dados imobiliários e critérios de compra de investidores por meio de solicitações em linguagem natural.

URL do servidor	https://mcp.batchdata.com
Transporte	Streamable HTTP (remoto, hospedado pela BatchData; não é necessário instalar nem executar nada localmente)
Autenticação	Login OAuth 2.1 pelo navegador com sua conta BatchData (PKCE, registro dinâmico de cliente) ou um token de API da BatchData enviado como Authorization: Bearer <token>
Conta	É necessária uma conta BatchData. O servidor MCP é um serviço cobrado conforme o uso; consulte preços ou entre em contato com a equipe de vendas para obter detalhes de acesso.
Nome no registro MCP	io.github.batchdataco/batchdata-mcp-server
Documentação	batchdata.io/mcp-server · developer.batchdata.com
Suporte	support@batchservice.com

Início rápido

Claude (Desktop e Web; não é possível adicionar conectores pelo celular)

1. Abra Settings → Connectors → Add custom connector.
2. Insira a URL https://mcp.batchdata.com e clique em Add.
3. Faça login com sua conta BatchData quando o navegador abrir.
4. Em um chat, clique em + e ative o conector BatchData.

Claude Code

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

Em seguida, execute /mcp no Claude Code e escolha batchdata para fazer login.

Plugin do Claude Code (skills e servidor MCP juntos)

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

O plugin se conecta ao mesmo servidor e adiciona skills para consulta de imóveis, comparáveis, pesquisa de imóveis e listas de leads, skip tracing, verificações de telefone DNC e TCPA, busca de investidores e licenças de construção (as licenças estão disponíveis apenas pela REST API, não como ferramenta MCP). As skills estão em skills/.

Cursor

Adicionar ao Cursor

Ou adicione isto a ~/.cursor/mcp.json (ou a .cursor/mcp.json em um projeto):

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

O Cursor abrirá uma janela do navegador para login na primeira vez que uma ferramenta for usada.

VS Code (GitHub Copilot)

Instalar no VS Code (abre o VS Code e solicita a instalação do servidor; use vscode-insiders: em vez de vscode: para Insiders)

Ou configure manualmente. Adicione isto a .vscode/mcp.json no seu workspace (ou execute MCP: Add Server na Paleta de Comandos):

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

Ou, em um terminal:

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

Replit

Ou, no Replit, abra Integrations → MCP Servers → + Add MCP server, defina o nome de exibição como BatchData e a URL como https://mcp.batchdata.com, clique em Test & save e faça login com sua conta BatchData.

ChatGPT (Modo de desenvolvedor)

Acesse Settings → Apps & Connectors → Advanced settings, ative o Developer mode e, em seguida, clique em Create para criar um conector chamado BatchData com a URL do servidor MCP https://mcp.batchdata.com e faça login com sua conta BatchData.

Claude Desktop com um token de API (clientes sem OAuth)

O Claude Desktop também pode acessar o servidor por meio de mcp-remote com seu token de API da BatchData. Requer 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 qualquer outro cliente MCP: aponte-o para https://mcp.batchdata.com usando o transporte Streamable HTTP e, se não houver suporte a OAuth, envie o cabeçalho Authorization: Bearer YOUR_API_TOKEN_HERE.

Guias passo a passo, migração de tokens de API para OAuth e solução de problemas estão em docs/setup-guide.md.

Ferramentas

O servidor registra 21 ferramentas.

Área	Ferramenta	O que faz
Imóvel	lookup_property	Retorna detalhes de um imóvel com base em seu propertyId, endereço no formato (rua + cidade + estado + CEP) ou número de parcela no formato (countyFipsCode + APN).
Comparáveis	comparable_property_count	Retorna a contagem total de imóveis comparáveis e métricas agregadas (estimatedValue, averagePrice, averagePricePerSqft), sem retornar registros individuais de imóveis comparáveis.
Comparáveis	comparable_property_preview	Retorna uma prévia rápida dos 10 primeiros imóveis comparáveis, com campos resumidos (endereço, preço, área em pés quadrados, quartos/banheiros, data da venda, distância), além da contagem total e métricas agregadas.
Comparáveis	comparable_property_page	Acesso paginado a imóveis comparáveis com detalhes completos (tamanho da página: 10).
Comparáveis	comparable_property	Obsoleta. Use comparable_property_count, comparable_property_preview ou comparable_property_page. Retorna todos os imóveis comparáveis, o que pode sobrecarregar as janelas de contexto.
Pesquisa	search_properties_count	Retorna a contagem total de imóveis que correspondem aos critérios de pesquisa e detalhamentos de quicklist.
Pesquisa	search_properties_preview	Retorna uma prévia rápida dos 10 primeiros imóveis com campos essenciais, além da contagem total.
Pesquisa	search_properties_page	Pesquisa paginada de imóveis com detalhes completos (tamanho da página: 10).
Skip trace e contato	skip_trace_property	Retorna informações de contato do proprietário e de outras pessoas associadas a um imóvel com base no endereço no formato (rua + cidade + estado + CEP), (rua + cidade + estado) ou (rua + CEP), ou no número de parcela no formato (estado + condado + APN) ou (countyFipsCode + APN).
Skip trace e contato	reverse_skip_trace	Retorna informações de pessoas associadas (nome, endereços, telefones, e-mails) para um ou mais números de telefone ou endereços de e-mail.
Conformidade de telefone	verify_phone	Retorna detalhes completos da verificação de um número de telefone, incluindo disponibilidade, status DNC, informações da operadora, status de litigante TCPA e muito mais.
Conformidade de telefone	check_dnc_status	Verifica apenas o status DNC (Do Not Call) de um número de telefone.
Conformidade de telefone	check_tcpa_status	Verifica apenas o status de litigante TCPA de um número de telefone.
Endereço	verify_address	Aceita um endereço de imóvel no formato rua + cidade + estado + CEP, rua + cidade + estado ou rua + CEP e retorna o endereço formatado de acordo com as convenções do USPS.
Endereço	geocode_address	Aceita um endereço de imóvel como uma única string de texto que representa rua + cidade + estado + CEP, rua + cidade + estado ou rua + CEP e retorna as coordenadas geográficas do endereço solicitado.
Endereço	reverse_geocode_address	Aceita coordenadas geográficas na forma de valores de latitude e longitude e retorna o endereço correspondente a essas coordenadas.
Conjuntos de dados e critérios de compra de investidores	list_property_datasets	Retorna todos os conjuntos de dados imobiliários disponíveis, com contagens de campos e exemplos de campos.
Conjuntos de dados e critérios de compra de investidores	list_property_dataset_fields	Retorna a lista completa de caminhos de campos de um conjunto de dados imobiliários específico.
Conjuntos de dados e critérios de compra de investidores	investor_buybox_count	Retorna a contagem total de investidores que correspondem aos critérios de compra e os metadados agregados dos resultados, sem retornar registros individuais de investidores. Esta ferramenta não é gratuita: a cobrança é feita por 1 registro.
Conjuntos de dados e critérios de compra de investidores	investor_buybox_preview	Retorna uma prévia rápida dos 10 primeiros perfis de investidores classificados que correspondem aos critérios de compra, além da contagem total e dos metadados agregados dos resultados.
Conjuntos de dados e critérios de compra de investidores	investor_buybox_page	Acesso paginado a investidores que correspondem aos critérios de compra, com detalhes completos (tamanho da página: 10).

O skip tracing (v3) precisa ser habilitado para sua equipe por um administrador, e os tokens de API precisam ter as permissões correspondentes para os endpoints.

Exemplos de solicitações

• "Consulte o imóvel em 123 Main Street, Los Angeles, CA."
• "Encontre imóveis comparáveis para 789 Pine Road, Austin, TX."
• "Pesquise imóveis vagos em Miami, FL."
• "Faça skip trace do proprietário de 456 Oak Avenue, Miami, FL."
• "Verifique este número de telefone e diga se ele está na lista Do Not Call."
• "Verifique e padronize este endereço: 100 main st los angeles ca."
• "Faça um reverse skip trace do proprietário associado a este número de telefone."
• "Quais investidores correspondem aos critérios de compra para 123 Main Street, Los Angeles, CA?"

Suporte

Dúvidas ou problemas: support@batchservice.com. Para consultar a referência da API, acesse developer.batchdata.com.

Licença

Este repositório contém apenas documentação e configuração e está licenciado sob a licença MIT. O servidor BatchData MCP em mcp.batchdata.com, a API BatchData e seus dados são proprietários e regidos pelos termos de serviço da BatchData.

© BatchData