DA Leads MCP

DA Leads MCP позволяет Claude, Cursor и другим MCP-клиентам запрашивать данные по заявкам на развитие в Австралии и адресному уровню недвижимости через DA Leads API.

Он предоставляет 36 инструментов для поиска DA, канонического поиска проектов и мониторинга, поиска близлежащих заявок/проектов, lookup-ы councils и категорий, анализа SQL в режиме только чтения, generic entitlement-filtered property intelligence, закрытого публичного Full Property contract, целенаправленный screening по Noise, Flood, Bushfire и Walkability, score-free Property Core, Suburb Signals, SA2 scenarios, Neighbourhood Context, Solar Resource, keyless samples и sandbox addresses.

Install

Запуск без глобальной установки:

uvx daleads-mcp

Или установка через pipx:

pipx install daleads-mcp
daleads-mcp

Конфигурация

Платные инструменты используют ключ DA Leads API. Инструменты образцов недвижимости работают без ключа.

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

DALEADS_API_KEY — единственная переменная окружения, читаемая этим пакетом. Относитесь к ней как к секрету. Она отправляется только на фиксированный официальный HTTPS API-эндпойнт по адресу

https://daleads.com.au/api.

Для Claude Code 2.1+ добавьте stdio-сервер в текущий проект с:

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

Инструменты без ключа работают немедленно. Для платных инструментов запуск Claude Code из окружения, которое уже обеспечивает DALEADS_API_KEY; не коммитьте реальный ключ в конфигурацию проекта MCP.

Official Skills

10 канонических Agent Skills размещаются в skills/. Из-за копии репозитория те же файлы доступны Codex через .agents/skills/ и Claude Code через .claude/skills/; оба каталога — тонкие относительные симлинки, поэтому источник инструкций единый и поддерживаемый. Руководство по Skills проводит агентов по темам идентичности субъекта, охвата, атрибуции и ограничений, специфичных для продукта. Они не предоставляют entitlement API и не расширяют права на данные.

Tools

Development applications

search_das — Поиск заявок на развитие в Австралии с фильтрами, сначала новые. Параметры: state (NSW, VIC, QLD, SA, WA, TAS, NT, ACT), council (полное имя совета, напр., City of Melbourne), category (категория сделки, напр., Renovation / Extension), suburb, postcode, since (ISO дата YYYY-MM-DD, подано на или после), status_group (pending, advertised, approved, rejected, other), is_residential (bool), page (по умолчанию 1), limit (на страницу, по умолчанию 20, максимум 100). Возвращает {data: [DA запись, ...], meta: {total, page, per_page, pages}}. Каждая запись содержит id, address, suburb, postcode, council, state, trade_category, lodgement_date, status, status_group, latitude, longitude, info_url и ссылки на документы; платные планы добавляют description, summary, sub_category, cost_of_development, decision fields, number_of_dwellings, building_type, storeys и полный список документов. Имена заявителей никогда не возвращаются по любому плану.

get_da — Получить одну заявку на развитие в полном объёме. Параметры: da_id (целочисленный идентификатор записи, как возвращено search_das или nearby_das). Возвращает {data: DA record} с тем же набором полей, что выше.

nearby_das — Найти заявки на развитие в радиусе от точки, ближайшие сначала. Параметры: lat, lng (WGS84 десятичные градусы), radius_km (по умолчанию 5, максимум 50), category, since, status_group, page, limit (макс 100). Возвращает ту же форма {data, meta} как и search_das, с дополнительным полем distance_km у каждой записи.

list_categories — Перечень всех торговых категорий с количеством записей, для поиска допустимых значений category. Без параметров. Возвращает {data: [{name, slug, is_residential, record_count}, ...], meta: {total}} — категории вроде Renovation / Extension, Swimming Pool / Spa, Granny Flat / Secondary Dwelling и Demolition.

list_councils — Перечень советов с охватом и актуальностью, для поиска допустимых значений council. Параметры: limit (макс число советов, по умолчанию 50). Возвращает {data: [{council, state, record_count, last_lodgement, last_fetched}, ...], meta}.

get_stats — Сводка охвата всего набора данных. Без параметров. Возвращает {data: {total_records, records_last_7_days, date_range: {earliest, latest}, by_state: [...], by_category: [...]}}.

sql_query — Выполнить только чтение SQL-запроса для пользовательской агрегации, которую фильтры инструментов не могут выразить. Только для Pro-плана. Параметры: query (один SELECT против таблицы das), params (необязательный список значений для заполнителей %s). Доступные столбцы: 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. Описания и резюме здесь намеренно недоступны, потому что произвольный текст совета может содержать личные данные. SELECT только, максимум 1000 строк, таймаут 10 секунд. Возвращает {columns: [...], rows: [[...], ...], row_count, truncated}.

Project intelligence

Эти инструменты используют тот же DALEADS_API_KEY, что и все остальные платные инструменты. API обеспечивает entitlement project_intelligence и rights-cleared полевые проекции; пакет MCP не поддерживает отдельный список возможностей.

search_projects — Поиск канонических проектов, а не независимых DA-записей. Параметры: q, state, нормализованный stage, нормализованный project_type, changed_since (ISO-8601 временная метка), page и limit (макс 100). Клиент отправляет каноничный параметр провайдера per_page. Возвращает оболочку {data, meta} с contract_version: project-intelligence-v1.

get_project — Получить один канонический проект. Параметр: project_uid (стабильный идентификатор, возвращаемый search_projects). Текущий v1-ответ содержит идентичность, нормализованный статус, расположение, связанные заявки и проектные отношения. Права-доступа ограниченные поля опускаются, вместо того чтобы отображаться как охват или конфликтная метаданные.

get_project_changes — Получить стойкие изменения одного проекта. Параметры: project_uid, необязательный начальный since, продолжение cursor, и limit (макс 100). Сохраняйте meta.cursor после каждого ответа. Используйте не-null meta.next_cursor только для немедленного получения следующей страницы. Изменения остаются скрытыми до появления доставки с provenance на уровне поля.

nearby_projects — Поиск канонических проектов вокруг точки WGS84. Параметры: lat, lng, radius_km, необязательные stage и project_type, page, и limit.

create_project_watch — Создать или идиоматически повторить постоянный подписанный коллбек для будущих событий с очищенными правами по одному project_uid. Параметры: project_uid, публичный HTTPS callback_url и стабильный idempotency_key. Этот инструмент изменяет внешнее состояние и возвращает секрет подписи.

list_project_watches — Перечень подписок, принадлежащих текущему API-key. Секреты подписи никогда не возвращаются в списке.

deactivate_project_watch — Остановить одну подписку по watch_uid. Записи аудита доставки остаются надёжными. Отложенная работа подавляется, но HTTPS-запрос, уже находящийся в полёте, не может быть отозван и остаётся видимым в аудите. Приемники должны устранить дубликаты заголовка стабильного callback Idempotency-Key.

В репозитории есть skills/daleads-project-monitoring для курсора-поллинга и явного управления коллбэками. Устанавливается из GitHub-репозитория, а не внутри PyPI wheel.

Property intelligence

property_intelligence — Generic entitlement-filtered address-level property lookup for existing and manually issued keys. Параметры: address (свободный текст, напр. 34 Mary St Clayton VIC) или lat + lng вместе, и необязательный components (перечень через запятую подлежащих запросу элементов). Запрашиваемое имя не дает никакой возможности: API сопоставляет его с entitlement ключа на стороне сервера и политикой прав доступа на уровне полей. Этот инструмент не является доказательством полноценного Self-Serve entitlement; новые полноценные рабочие процессы должны использовать приведённый ниже закрытый инструмент.

full_property_intelligence — Закрытая публичная Full Property Intelligence Self-Serve выборка. Параметры: address (рекомендуется) или lat + lng. Запрашивает базовые факты das, poi, planning, transport, utilities, administrative и public_housing; помеченные угрозы для bushfire, flood, coastal, landslide и fire history; и помеченные экологические блоки для почвы, protected-area, heritage, threatened-species, Ramsar, koala, экологического характера, EPBC, биорегиона и контекст биоразнообразия. Точные названия экологических листьев зафиксированы в contracts/focused-api-v1.json. Также запрашиваются точно эти leaves рейтингов: scores.noise, scores.aircraft_noise, scores.flood, и scores.bushfire. Он никогда не запрашивает верхнеуровневые hazards, environment или scores, чтобы новый поставщик не мог автоматически получить раздел «Full». Официальные, ограниченные по правам контаминации и факты регистрации могут возвращаться как Context of Property Core; они не дают scores.contamination или публикацию продукта Contamination отдельно. Solar, Neighbourhood Heat, Landscape Openness и Walkability Pilot исключены. Ключ Full имеет отдельные возможности property_core и suburb_intelligence, которые не добавляют полей в этот ответ. Право доступа на стороне поставщика по-прежнему применяется ко всем возвращаемым полям.

property_core — Закрытый контекст недвижимости без skórise. Параметры: address (рекомендуется) или lat + lng. Возвращает идентификацию адреса/пакета, заявки на развитие, POI, planning, hazards, environment, transport, utilities, administrative и факты по общежитиям, плюс ответ-специфические охват и источники. Никогда не возвращает баллы, поверхности или неизвестные будущие блоки. Ключ должен включать полный набор явных Core компонентов.

Suburb and regional intelligence

find_suburbs — Разрешить префикс названия suburb в ABS SAL-коды перед вызовом signals. Параметры: query, необязательный state, limit (макс 100). Возвращает существующие лицензированные строки Census с sal_code; повторяющиеся названия остаются отдельными, а не угадываются.

suburb_signals — Контекст Census и приватная сводка разработки для одного SAL-кода. Параметр: sal_code. Возвращает текущие/за последние 12 месяцев данные по DA-записям, импульс, охват и публикацию категорий, а также машинный контракт, подтверждающий отсутствие дедупликации проектов. Не прикрепляет SA2 абсолютный прогноз населения к SAL.

find_sa2_regions — Разрешить точное или частичное имя региона к кодам ASGS 2021 SA2. Параметры: query, необязательный state, limit (макс 50). Используйте возвращённый код с sa2_population_forecast; не выводите по suburb name.

sa2_population_forecast — Код-ключевая региональная сценарная модель Beta. Параметр: девятизначный sa2_code. Возвращает историю, модель/вирдженцию, статус ограничения жилья и соответствующие 1/3/5-летние ошибки канонической-origin. Установленные SA2 включают сценарии низкий/средний/высокий. Высокий рост и будущие значения на зелёных полях пока не будут доступны, пока артефакт не имеет ограничения DA на dwelling; "withheld" не означает нулевой рост.

noise_screening — Целевая Noise Intelligence-lookup. Параметры: address (рекомендуется) или lat + lng. Запрашивает ровно scores.noise и scores.aircraft_noise, возвращая моделированное контекст дороги/рельсы, оценки Lden/day/night, секторы фасадов, доказательства доверия и оценку aircraft-overlay. Это не замер на месте, LA90 или акустическая оценка соответствия. Используйте поля Noise в property_sample как текущий ключ-образец; у обобщённой выборки остальные поля не являются частью Entitlement.

flood_screening — Целевая Flood Intelligence-lookup. Параметры: address (рекомендуется) или lat + lng. Запрашивает ровно scores.flood,hazards.flood и сохраняет национальную модель скрининга, сопоставляемые официальные данные и любую специфическую глубину исследования отдельно. Пропущенная глубина или соответствие означает состояние охвата, а не нулевую глубину или отсутствие риска затопления. Скрининг — национальный; официальный смоделированный глубинный уровень приходит в настоящее время из 55 production rasters (48 — Brisbane, 7 — NSW).

bushfire_screening — Целевая коммерческая Bushfire SCREENING-lookup. Параметры: address (рекомендуется) или lat + lng вместе. Всегда запрашивает ровно scores.bushfire,hazards.bushfire, возвращая идентичность субъекта, официальный/модельный статус наложения, лицензированные по опасностям попадания, моделируемые топлива растительности, рельеф, доступную историю пожаров, охват и оговорки. При наличии ответ содержит предварительную ориентировочную BAL-диапазон с диапазоном и доверительностью плюс обязательное предупреждение. Это не сертифицированная оценка BAL и не может использоваться для утверждения здания. Координаты только в запросах помечаются как такие и не должны толковаться как конкретное место расположения здания.

walkability_screening — Целевой Pilot Screenинг Amenity & Walkability. Параметры: address (рекомендуется) или lat + lng. Запрашивает ровно scores.walkability: линейное расстояние до 24 сценариев удобств плюс учёт автомагистрали, крупной воды и региональных уклонов. Это не пешеходный маршрут, изо-хрон или время в пути. Сохраняйте каждое состояние coverage и сохраняйте attribution в meta.amenity_sources, когда названия или координаты появляются.

neighbourhood_context — Целевая Neighbourhood Context Beta lookup. Параметры: address (рекомендуется) или lat + lng вместе. Запрашивает ровно scores.heat_island,scores.view_quality. Neighbourhood Heat сохраняет примерно 1 км температуру отдельно от контекста 10 м покрытия и сообщает год выпуска источника и статус заимствованного пикселя. Унаследованный ключ view_quality возвращает публичный продукт Landscape Openness, включая шесть факторов, пропуски охвата и явные исключения по прямой видимости. Это не температура парцела, текущая погода, внутренний комфорт, энергопотребление здания или гарантированное видовое преимущество.

solar_resource — Целевая Solar Resource Developer Preview lookup. Параметры: address (рекомендуется) или lat + lng вместе. Запрашивает ровно scores.solar и возвращает региональные открытые горизонты GHI/DNI/GTI, PVOUT, оптимальный наклон, разрешение по полю, год выпуска, лицензию и авторство. Не идентифицирует крыши, usable area, теневые участки зданий или деревьев, препятствия, тарифы, самоспоживание или батареи и не должен использоваться как проект крыши.

property_sample — Осмотреть Generic Property Intelligence response shape до получения ключа. Без API-key. Без параметров. Возвращает реальный production-пayload для 163 Grattan St, Carlton VIC (памятный ряд с DA-активностью). Noise и Public Full сейчас используют этот Preview, потому что у них ещё нет отдельных sample-рутов. Это демонстрационная схема, а не манифест прав. Предварительные поля здесь не означают, что они будут включены в Noise или Public Full Self-Serve.

property_core_sample — Осмотреть закрытый score-free контракт Property Core v1. Без API-key. Возвращает реальную Carlton-ответ, содержащий только явные Core-факты, охват и запас источников.

suburb_signals_sample — Осмотреть реальный Carlton SAL development-signals Beta-ответ. Без API-key.

sa2_population_forecast_sample — Осмотреть Carlton SA2 forecast Beta, включая сопоставимые доказательства ошибок rolling-origin. Без API-key.

property_walkability_sample — Осмотреть контракт по Amenity & Walkability Screening для Carlton. Без API-key. Расстояния явно прямые (straight-line) и время маршрута не предоставляется.

property_flood_sample — Осмотреть один scored hazard component в деталях. Без API-key. Без параметров. Возвращает production-блок scores.flood для точки в Rocklea QLD: официальный глубинный уровень моделирования 1% AEP, статус наложения, контекст рельефа, примечания и provenance.

property_bushfire_sample — Осмотреть стандартный Bushfire Screening контракт. Без API-key. Без параметров. Возвращает реальный sample из Katoomba NSW с разрешимой идентичностью субъекта, официальные/моделируемые доказательства, охват, атрибуцию и явное ответ-специфичное indicative BAL-состояние. В canned snapshot может предшествовать полю; живые ответы могут включать предварительную палитру.

property_context_sample — Осмотреть coordinated Neighbourhood Context Beta и Solar Resource Developer Preview контракт. Без API-key. Без параметров. Возвращает реальный production-ответ Carlton, содержащий только Neighbourhood Heat, Landscape Openness и Solar Resource, с их устаревшими ключами v1, уровнями измерения, источниками, оговорками и не-моделируемыми границами.

property_sandbox_addresses — Перечислить адреса, по которым можно бесплатно выполнять оценки. Без API-key. Без параметров. Возвращает {sandbox_addresses: [{address, label}, ...], note} — 12 реальных адреса, охватывающих все восемь штатов, выбранные для разных профилей риска и планирования. Поиск по этим адресам через property_intelligence не учитывается в месячном квоте ключа.

Data boundary

Код адаптера и данные, возвращаемые DA Leads, имеют разные лицензионные границы. Установка этого пакета не даёт entitlement API и права на перераспределение данных API. Public Full Self-Serve поддерживает внутренний анализ и атрибутированные статические отчеты клиентов в рамках условий क्लिक-обязательств. Интерактивное внедрение, white-label, последующий доступ, перепродажа, перераспределение данных в сыром виде, особая геометрия и нестандартные SLA требуют прав Publisher или