DA Leads MCP

Consultas de inteligência de aplicações de desenvolvimento e propriedades australianas para agentes de IA.

Documentação

DA Leads MCP

O DA Leads MCP permite que Claude, Cursor e outros clientes MCP consultem pedidos de desenvolvimento australianos e inteligência de propriedades em nível de endereço por meio da API DA Leads.

Ele expõe 36 ferramentas para busca de DA, busca canônica de projetos e monitoramento, aplicações/projetos próximos, consultas de conselhos e categorias, análise SQL somente leitura, inteligência genérica de propriedades filtrada por elegibilidade, o contrato público fechado Full Property, triagem focada em Ruído, Inundação, Incêndio Florestal e Caminhabilidade, Property Core sem pontuação, Suburb Signals, cenários SA2, Contexto de Vizinhança, Recurso Solar, amostras sem chave e endereços sandbox.

Instalação

Execute sem instalar globalmente:

uvx daleads-mcp

Ou instale com pipx:

pipx install daleads-mcp
daleads-mcp

Configuração

Ferramentas pagas usam uma chave da API DA Leads. As ferramentas de amostra de propriedades funcionam sem chave.

{
  "mcpServers": {
    "da-leads": {
      "command": "uvx",
      "args": ["daleads-mcp"],
      "env": {
        "DALEADS_API_KEY": "dk_live_xxx"
      }
    }
  }
}

DALEADS_API_KEY é a única variável de ambiente lida por este pacote. Trate-a como um segredo. Ela é enviada apenas ao endpoint fixo oficial da API HTTPS em https://daleads.com.au/api.

Para Claude Code 2.1+, adicione o servidor stdio ao projeto atual com:

claude mcp add --scope project da-leads -- uvx daleads-mcp

As ferramentas de amostra sem chave funcionam imediatamente. Para ferramentas pagas, inicie o Claude Code a partir de um ambiente que já forneça DALEADS_API_KEY; não envie uma chave real para a configuração MCP do projeto.

Skills oficiais

As 10 Skills de Agente canônicas estão em skills/. Um checkout do repositório expõe os mesmos arquivos ao Codex por meio de .agents/skills/ e ao Claude Code por meio de .claude/skills/; ambos os diretórios são symlinks relativos finos, portanto há apenas uma fonte de instrução mantida. As Skills guiam os agentes por identidade de assunto, cobertura, atribuição e limites específicos do produto. Elas não concedem elegibilidade de API nem expandem direitos de dados.

Ferramentas

Pedidos de desenvolvimento

search_das — Pesquisa pedidos de desenvolvimento australianos com filtros, mais recentes primeiro. Parâmetros: state (NSW, VIC, QLD, SA, WA, TAS, NT, ACT), council (nome completo do conselho, ex.: City of Melbourne), category (categoria comercial, ex.: Renovation / Extension), suburb, postcode, since (data ISO YYYY-MM-DD, protocolado em ou após), status_group (pending, advertised, approved, rejected, other), is_residential (bool), page (padrão 1), limit (por página, padrão 20, máx. 100). Retorna {data: [registro DA, ...], meta: {total, page, per_page, pages}}. Cada registro contém id, endereço, subúrbio, CEP, conselho, estado, categoria comercial, data de protocolo, status, grupo de status, latitude, longitude, info_url e links de documentos; planos pagos adicionam descrição, resumo, subcategoria, custo do desenvolvimento, campos de decisão, número de unidades habitacionais, tipo de construção, andares e a lista completa de documentos. Nomes de requerentes nunca são retornados em nenhum plano.

get_da — Recupera um pedido de desenvolvimento completo. Parâmetros: da_id (id inteiro do registro, conforme retornado por search_das ou nearby_das). Retorna {data: DA record} com o mesmo conjunto de campos acima.

nearby_das — Encontra pedidos de desenvolvimento dentro de um raio de um ponto, mais próximos primeiro. Parâmetros: lat, lng (graus decimais WGS84), radius_km (padrão 5, máx. 50), category, since, status_group, page, limit (máx. 100). Retorna a mesma forma {data, meta} que search_das, com um extra distance_km em cada registro.

list_categories — Lista todas as categorias comerciais com sua contagem de registros, para descobrir valores válidos de category. Sem parâmetros. Retorna {data: [{name, slug, is_residential, record_count}, ...], meta: {total}} — categorias como Renovação / Ampliação, Piscina / Spa, Flat para Avós / Unidade Secundária e Demolição.

list_councils — Lista conselhos com cobertura e atualização, para descobrir valores válidos de council. Parâmetros: limit (máx. de conselhos a retornar, padrão 50). Retorna {data: [{council, state, record_count, last_lodgement, last_fetched}, ...], meta}.

get_stats — Resumo de cobertura para todo o conjunto de dados. Sem parâmetros. Retorna {data: {total_records, records_last_7_days, date_range: {earliest, latest}, by_state: [...], by_category: [...]}}.

sql_query — Executa uma consulta SQL somente leitura para agregação personalizada que as ferramentas de filtro não conseguem expressar. Somente plano Pro. Parâmetros: query (um único SELECT contra a tabela das), params (lista opcional de valores para espaços reservados %s). Colunas disponíveis: id, address, address_suburb, address_postcode, council_name, council_reference, state, trade_category, sub_category, application_type, is_residential, lodgement_date, status, cost_of_development, decision_date, decision_status, on_notice_from, on_notice_to, number_of_dwellings, lot_count, land_use, building_type, storeys, latitude, longitude, data_source, date_fetched, documents, info_url. Descrição e resumo estão deliberadamente indisponíveis aqui porque o texto livre do conselho pode conter dados de contato pessoais. Somente SELECT, limitado a 1000 linhas com tempo limite de 10 segundos. Retorna {columns: [...], rows: [[...], ...], row_count, truncated}.

Inteligência de projetos

Estas ferramentas usam o mesmo DALEADS_API_KEY que todas as outras ferramentas pagas. A API aplica a elegibilidade project_intelligence da chave e a projeção de campos com direitos limpos; o pacote MCP não mantém uma segunda lista de capacidades.

search_projects — Pesquisa projetos canônicos em vez de registros DA independentes. Parâmetros: q, state, stage normalizado, project_type normalizado, changed_since (carimbo de data/hora ISO-8601), page e limit (máx. 100). O cliente envia o parâmetro canônico per_page do provedor. Retorna um envelope {data, meta} com contract_version: project-intelligence-v1.

get_project — Recupera um projeto canônico. Parâmetro: project_uid (o identificador estável retornado por search_projects). A resposta atual v1 contém identidade, status normalizado, localização, aplicações vinculadas e relações do projeto. Campos com restrição de direitos são omitidos em vez de representados como cobertura ou metadados de conflito.

get_project_changes — Recupera alterações duráveis para um projeto. Parâmetros: project_uid, since inicial opcional, cursor de continuação e limit (máx. 100). Persista meta.cursor após cada resposta. Use um meta.next_cursor não nulo apenas para buscar a próxima página imediatamente. Os valores de alteração permanecem editados até que a proveniência de entrega em nível de campo esteja disponível.

nearby_projects — Pesquisa projetos canônicos ao redor de um ponto WGS84. Parâmetros: lat, lng, radius_km, stage e project_type opcionais, page e limit.

create_project_watch — Cria ou reproduz de forma idempotente um callback assinado persistente para eventos futuros com direitos limpos em um project_uid. Parâmetros: project_uid, um callback_url HTTPS público e um idempotency_key estável. Esta ferramenta altera o estado externo e retorna o segredo de assinatura.

list_project_watches — Lista os watches de propriedade da chave de API atual. Segredos de assinatura nunca são retornados pela operação de listagem.

deactivate_project_watch — Interrompe um watch de propriedade por watch_uid. As linhas de auditoria de entrega permanecem duráveis. O trabalho pendente é suprimido, mas uma solicitação HTTPS já em andamento não pode ser cancelada e permanece visível na auditoria. Os receptores devem desduplicar o cabeçalho estável de callback Idempotency-Key.

O repositório inclui skills/daleads-project-monitoring para polling por cursor e gerenciamento explícito de callbacks. Ele é instalado a partir do repositório GitHub, não incluído no wheel do PyPI.

Inteligência de propriedades

property_intelligence — Consulta genérica de propriedade em nível de endereço filtrada por elegibilidade para chaves existentes e emitidas manualmente. Parâmetros: address (texto livre, ex.: 34 Mary St Clayton VIC) ou lat + lng juntos, e components opcional (subconjunto separado por vírgulas a solicitar). Um nome solicitado nunca concede uma capacidade: a API o cruza com a elegibilidade no servidor da chave e a política de direitos em nível de campo. Esta ferramenta não é prova de uma elegibilidade Full Self-Serve; novos fluxos Full devem usar a ferramenta fechada abaixo.

full_property_intelligence — Consulta fechada pública Full Property Intelligence Self-Serve. Parâmetros: address (recomendado) ou lat + lng juntos. Ela solicita os fatos básicos das, poi, planning, transport, utilities, administrative e public_housing; folhas de perigo nomeadas para incêndio florestal, inundação, costeiro, deslizamento e histórico de incêndio; e folhas ambientais nomeadas para contexto de solo, área protegida, patrimônio, espécies ameaçadas, Ramsar, koala, ecológico, EPBC, biorregião e biodiversidade. Os nomes exatos das folhas ambientais estão fixados em contracts/focused-api-v1.json.

Ela também solicita exatamente estas folhas de pontuação: scores.noise, scores.aircraft_noise, scores.flood e scores.bushfire. Ela nunca solicita hazards, environment ou scores de nível superior, portanto um novo campo do provedor não pode entrar no Full automaticamente. Fatos oficiais explícitos de contaminação e registro com restrição de direitos podem retornar como contexto Property Core; eles não concedem scores.contamination nem publicam o produto independente de Contaminação. Solar, Calor de Vizinhança, Abertura de Paisagem e o Piloto de Caminhabilidade são excluídos. A chave Full carrega capacidades separadas property_core e suburb_intelligence, que não adicionam campos a esta resposta. Portões de origem e direitos do lado do provedor ainda se aplicam a cada campo retornado.

property_core — Contexto de propriedade fechado sem pontuação. Parâmetros: address (recomendado) ou lat + lng. Retorna identidade resolvida de endereço/lote, pedidos de desenvolvimento, POI, planejamento, riscos, ambiente, transporte, serviços públicos, fatos administrativos e de habitação pública, além de cobertura específica da resposta e obrigações de fonte. Nunca retorna pontuações, superfícies ou blocos futuros desconhecidos. A chave deve incluir o conjunto completo explícito de componentes Core.

Inteligência de subúrbios e regional

find_suburbs — Resolve um prefixo de nome de subúrbio para códigos ABS SAL antes de uma chamada de sinais. Parâmetros: query, state opcional, limit (máx. 100). Retorna as linhas existentes licenciadas do Census com sal_code; nomes repetidos permanecem separados em vez de serem adivinhados.

suburb_signals — Contexto do Census e atividade de desenvolvimento enxuta de privacidade para um código SAL. Parâmetro: sal_code. Retorna contagens atuais/anteriores de registros DA de 12 meses, momentum, status e cobertura de publicação de unidades habitacionais, mix de categorias e um contrato de máquina declarando que a desduplicação de projetos não foi aplicada. Ele nunca anexa uma previsão absoluta de população SA2 ao SAL.

find_sa2_regions — Resolve um nome de região exato ou parcial para códigos ASGS 2021 SA2. Parâmetros: query, state opcional, limit (máx. 50). Use o código retornado com sa2_population_forecast; nunca o infira a partir de um nome de subúrbio.

sa2_population_forecast — Cenário Beta de população regional por código. Parâmetro: sa2_code de nove dígitos. Retorna histórico, modelo/safra, status de restrição habitacional e erros correspondentes de origem rolante de 1/3/5 anos. SA2s estabelecidos incluem cenários baixo/médio/alto. Valores futuros de alto crescimento e greenfield são retidos enquanto o artefato não tiver restrição de unidades habitacionais DA; retido não é crescimento zero. noise_screening — Consulta focada de Inteligência de Ruído. Parâmetros: address (recomendado) ou lat + lng. Ela solicita exatamente scores.noise e scores.aircraft_noise, retornando contexto modelado de rodovias/ferrovias, estimativas Lden/dia/noite, setores de fachada, evidências de confiança e avaliação de sobreposição de aeronaves. Não é uma medição em campo, resultado de LA90 ou avaliação de conformidade acústica. Use os campos de Ruído em property_sample como a pré-visualização atual de forma sem chave; os outros campos da amostra genérica não fazem parte do direito de uso de Ruído.

flood_screening — Consulta focada de Inteligência de Inundação. Parâmetros: address (recomendado) ou lat + lng. Ela solicita exatamente scores.flood,hazards.flood e mantém o modelo nacional de triagem, as evidências oficiais mapeadas e qualquer profundidade específica de estudo separados. Profundidade ou mapeamento ausentes são um estado de cobertura, não profundidade zero ou prova de que o risco de inundação está ausente. A triagem é nacional; a profundidade modelada oficial atualmente vem de 55 rasters de produção (48 em Brisbane e 7 em NSW).

bushfire_screening — Consulta focada comercial de Triagem de Incêndio Florestal. Parâmetros: address (recomendado) ou lat + lng juntos. Ela sempre solicita exatamente scores.bushfire,hazards.bushfire, retornando identidade do imóvel, status oficial de sobreposição, ocorrências de perigo licenciadas, combustível vegetal modelado, terreno, histórico de incêndios disponível, cobertura e ressalvas. Quando disponível, a resposta inclui uma faixa BAL indicativa preliminar com intervalo e confiança, além de sua isenção de responsabilidade obrigatória. Não é uma avaliação BAL certificada e não pode ser usada para aprovação de construção. Consultas somente por coordenadas são rotuladas como tal e não devem ser tratadas como localização de edificação.

walkability_screening — Consulta focada do Piloto de Triagem de Amenidades e Caminhabilidade. Parâmetros: address (recomendado) ou lat + lng. Ela solicita exatamente scores.walkability: metros em linha reta para 24 cenários de amenidades, além de ajustes divulgados de rodovias, grandes corpos d'água e declividade regional. Não é um percurso a pé, isócrona ou resultado de tempo de viagem. Leia cada estado de coverage e preserve a atribuição de meta.amenity_sources quando nomes ou coordenadas aparecerem.

neighbourhood_context — Consulta focada do Beta de Contexto de Vizinhança. Parâmetros: address (recomendado) ou lat + lng juntos. Ela solicita exatamente scores.heat_island,scores.view_quality. O Calor de Vizinhança mantém sua temperatura de aproximadamente 1 km separada do contexto de cobertura do solo de 10 m e informa a antiguidade da fonte e o status de pixels emprestados. A chave legada view_quality retorna o produto público de Abertura da Paisagem, incluindo seis fatores, cobertura ausente/parcial e exclusões explícitas de linha de visada. Não é temperatura do lote, clima em tempo real, conforto interno, uso de energia do edifício ou uma vista garantida.

solar_resource — Consulta focada da Pré-visualização de Desenvolvedor de Recurso Solar. Parâmetros: address (recomendado) ou lat + lng juntos. Ela solicita exatamente scores.solar e retorna GHI/DNI/GTI de horizonte aberto regional, PVOUT, inclinação ótima, resolução por campo, antiguidade, licença e atribuição. Ela não identifica planos de telhado, área utilizável, sombreamento de edifícios ou árvores, obstruções, tarifas, autoconsumo ou baterias e não deve ser usada como projeto de telhado.

property_sample — Inspecione a forma genérica de resposta de Inteligência de Propriedade antes de ter uma chave. Nenhuma chave de API necessária. Sem parâmetros. Retorna o payload real de produção para 163 Grattan St, Carlton VIC (um sobrado histórico com atividade de DA). Ruído e Full público atualmente compartilham esta pré-visualização porque eles ainda não têm rotas de amostra dedicadas. É uma demonstração de esquema, não um manifesto de direito de uso: campos de Pré-visualização presentes nele não estão, por isso, incluídos em Ruído ou no Full público de Autoatendimento.

property_core_sample — Inspecione o contrato fechado do Núcleo de Propriedade v1 sem pontuação. Nenhuma chave de API necessária. Retorna uma resposta real de Carlton contendo apenas os blocos de fatos explícitos do Núcleo, cobertura e inventário de fontes.

suburb_signals_sample — Inspecione uma resposta Beta real de sinais de desenvolvimento SAL em Carlton. Nenhuma chave de API necessária.

sa2_population_forecast_sample — Inspecione o Beta de previsão SA2 de Carlton, incluindo evidências correspondentes de erro de origem móvel. Nenhuma chave de API necessária.

property_walkability_sample — Inspecione o contrato focado de Triagem de Amenidades e Caminhabilidade para Carlton. Nenhuma chave de API necessária. As distâncias são explicitamente em linha reta e nenhum tempo de percurso é fornecido.

property_flood_sample — Inspecione um componente de perigo pontuado em detalhe. Nenhuma chave de API necessária. Sem parâmetros. Retorna o bloco de produção scores.flood para um ponto coberto por estudo em Rocklea QLD: profundidade modelada oficial de 1% AEP, status de sobreposição, contexto de terreno, notas de cobertura e proveniência.

property_bushfire_sample — Inspecione o contrato padrão de Triagem de Incêndio Florestal. Nenhuma chave de API necessária. Sem parâmetros. Retorna uma amostra focada real de Katoomba NSW com identidade de imóvel resolvida, evidências oficiais/modeladas, cobertura, atribuição e um estado BAL indicativo explícito específico da resposta. O instantâneo pré-definido pode anteceder o campo; respostas ao vivo podem incluir a faixa preliminar.

property_context_sample — Inspecione o contrato coordenado do Beta de Contexto de Vizinhança e da Pré-visualização de Desenvolvedor de Recurso Solar. Nenhuma chave de API necessária. Sem parâmetros. Retorna uma resposta real com formato de produção de Carlton contendo apenas Calor de Vizinhança, Abertura da Paisagem e Recurso Solar, com suas chaves v1 legadas, níveis de medição, fontes, ressalvas e limites não modelados.

property_sandbox_addresses — Liste os endereços que você pode avaliar gratuitamente. Nenhuma chave de API necessária. Sem parâmetros. Retorna {sandbox_addresses: [{address, label}, ...], note} — 12 endereços reais abrangendo todos os oito estados, escolhidos por perfis distintos de perigo e planejamento. Consultas desses endereços por meio de property_intelligence nunca contam para a cota mensal de uma chave.

Limite de dados

O código do adaptador e os dados retornados pela DA Leads têm limites de licença separados. Instalar este pacote não concede um direito de uso de API ou um direito de redistribuir os dados da API. O Full público de Autoatendimento suporta análise interna e relatórios estáticos atribuídos a clientes sob seus termos de clickwrap. Incorporação interativa, white labelling, acesso posterior, revenda, redistribuição bruta, geometria especial e SLAs personalizados exigem direitos de Editor ou Enterprise. Consulte os Termos da DA Leads, Política de Privacidade e Atribuições de Dados.

O servidor reutiliza a autenticação da API DA Leads, os limites do plano e os controles de privacidade. A API pública e as respostas do MCP não expõem nomes de requerentes.