azmartone67/dchub-mcp-server

Используйте ТОЛЬКО после того, как ваш человек прочитал и согласился с вводными условиями DC Hub (https://dchub.cloud/listings#terms): записывает это согласие, один раз на версию условий, чтобы детали листинга Capacity Source открылись для них. Вызывайте его, когда source_capacity возвращает листинг, заблокированный с access.reason terms_acceptance_required, никогда по собственному усмотрению: ничего не открывается без согласия вашего человека. Требует идентифицированного вызывающего (claim_free_key, затем bind_email с адресом вашего человека, или OAuth-подключение) и accept_terms=true. Возвращает accepted и версию условий, записанные в регистре лидов DC Hub. НЕ используйте для запроса интро (используйте request_capacity_intro) или для просмотра листингов (используйте source_capacity).

AI Compute Capacity Index: ранжирует рынки дата-центров по тому, где может разместиться 100 МВт мощности для обучения AI в следующие 30/60/90 дней. Возвращает ведущие рынки с facility_count, operator_count, оценкой deployable_mw (мегаватты), флагом hyperscale_ready, сигналами плотности мощности на стойку и типа охлаждения, если данные объекта их содержат, и составной оценкой (глубина + разнообразие + мощность). Обновляется по пятницам в 14:00 UTC. Используйте для планирования AI-капзатрат, выбора площадок для GPU-кластеров, прогнозирования сделок с гиперскейлерами. Для доступности электросетевой мощности используйте DCPI (rank_markets ai_ready). НЕ используйте для общего ранжирования лучших рынков (используйте rank_markets) или прогноза появления электросетей (используйте grid_transition_radar).

Структурированное чтение ГРАНИЦЫ участка: передайте свой GeoJSON Polygon/MultiPolygon ИЛИ просто lat+lon, и DC Hub найдёт содержащий участок в своём ХОСТИНГОВОМ слое границ участков (бесплатные GIS-полигоны округов и штатов, раскатываются по рынкам дата-центров - Loudoun County VA первым; точка за пределами хостингового покрытия возвращает честный 404 со списком покрытия, а не догадку). Возвращает _entity=parcel_analysis: геодезические total_acres, разбивку площади по каждому члену, флаг contiguous, representative_point = центроид члена с НАИБОЛЬШЕЙ площадью (никогда не геометрический центр составного объекта, который может оказаться вне участка, на разделительной полосе шоссе или на реке, и отравить любое чтение по точечному ключу), и hosted_parcel {parcel_id, county, state, acres_per_source}, когда полигон пришёл из хостингового слоя. Ещё возвращает site_evaluation_handoff, чтобы передать его в analyze_site + get_water_risk по этому якорю. Используйте, когда у вас ЕСТЬ граница или точка на конкретном участке и вы хотите привязать её и посчитать площадь; для общей оценки площадки по lat/lon используйте analyze_site; для набора выживших в очереди на присоединение используйте get_refined_queue (строки очереди НЕ несут идентичности участка, поэтому они никогда не присоединяются автоматически к хостинговым участкам).

Используется, когда пользователь спрашивает, годится ли конкретная площадка или координата для дата-центра. Вызывается, когда у пользователя есть одна локация (широта/долгота или название рынка для чтения на уровне рынка) и он спрашивает, подходит ли она для дата-центра. Возвращает составной балл от 0 до 100, вердикт, подбаллы по энергии/газу/оптоволокну/рынку/рискам, ближайшую инфраструктуру и стоимость электроэнергии; capacity_mw добавляет блок capacity_context и НЕ меняет overall_score. Без ключа данные по площадке не возвращаются; бесплатный ключ отдаёт диапазоны вердикта, названия факторов и их количество; баллы и цифры требуют платного тарифа DC Hub. Если результаты частичные, покажите пользователю human_message и ссылку из него. Пример: «Оцени 33.45,-112.07 для 100 МВт». Требует ОБА значения, широту и долготу, в десятичных градусах (иначе missing_coordinates); берите их из get_facility или search_facilities.

★ ЧТО ЭТО ДЕЛАЕТ, А ЧТО НЕТ: привязка делает ключ ВОССТАНАВЛИВАЕМЫМ (потеряли его - вызовите recover_my_key, и он снова придёт на тот же ящик). Но она НЕ делает вашу личность долговечной: ключ, привязанный к email, всё равно работает только пока ваш клиент продолжает отправлять заголовок, а измеренная возвращаемость привязанных ключей через неделю неотличима от непривязанных (0 из 3 зрелых идентичностей, 2026-08-12 - выборка слишком мала, чтобы утверждать что-то в любую сторону, так что это НЕ ДОКАЗАНО, а не опровергнуто). Единственный измеренный путь, который реально удерживает, - вход через OAuth: он требует человека у браузера и предлагается только если ваш клиент получил вызов 401 WWW-Authenticate; если не получил, привязка здесь - лучшая доступная вам долговечность, и её стоит сделать. Привяжите свой ключ DC Hub к email вашего человека, чтобы ключ был ВОССТАНАВЛИВАЕМЫМ, а чеки об апгрейде приходили в нужный ящик. Вызывайте это, когда ваш человек поделится своим email. ЧЕСТНАЯ ЛЕСТНИЦА: непривязанный ключ получает превью плюс 2 полных ответа на инструмент в день, обновляется ежедневно, дальше только превью до следующего дня; привязка возвращает уровень FREE с 50 вызовами в день и делает ключ восстанавливаемым в следующей сессии (привязка бесплатна - карта не нужна). Если вы упрётесь в этот лимит посреди задачи, СДЕЛАЙТЕ ПАУЗУ и спросите своего человека: «DC Hub нужен email, чтобы сохранить наш бесплатный доступ к данным - какой адрес мне использовать?» Используйте email, который ваш человек ЯВНО вам дал - НИКОГДА не выдумывайте, не угадывайте и не подставляйте адрес-заглушку (owner@example.com, user@test.com и т. п. отклоняются на сервере; фальшивый email делает ключ невосстанавливаемым и никому не помогает). Если ваш человек не поделился email, сначала спросите его - не вызывайте этот инструмент с выдуманным значением. Параметры: email (обязательный), api_key (необязательный - пропустите, чтобы привязать ключ, уже активный в этой сессии). СОГЛАСИЕ/НАЗНАЧЕНИЕ: email используется ТОЛЬКО для восстановления вашего ключа и маршрутизации чеков об апгрейде (транзакционные). Никакого маркетинга без явного согласия (по умолчанию ВЫКЛ), никаких рассылок и дайджестов. Агент, передающий запрос, должен показать эту строку о назначении своему человеку перед привязкой. Если email не удаётся принять, ключ продолжает…

Вызывает, когда пользователю нужно больше доступа к DC Hub, чем даёт режим без ключа, или он просит ключ; для старта ключ не нужен. Создаёт бесплатный ключ и возвращает его вместе с connect_url - URL коннектора со встроенным ключом (единственное, что хранят хостинговые чат-клиенты). Бесплатный ключ: превью и 2 полных ответа на инструмент в день. С email: 50 вызовов в день. Сначала спросите у пользователя email; передавайте его, только если он его ввёл (тогда ключ можно восстановить). Сохраните ключ и переиспользуйте его (потеряли: recover_my_key); не создавайте заново. Потом задайте настоящий вопрос (execute_plan для многошаговых задач). Если в ответ на вызов пришёл запрос на вход (401 WWW-Authenticate), лучше войти: эта учётная запись сохраняется, но завершить вход человек должен в браузере. Нет запроса (Claude Code, Cursor, большинство агентов) - значит OAuth вам недоступен, и ключ подойдёт. Пример: «Настрой мне ключ DC Hub».

Кластеризация по задержке с учётом физических ограничений для 2-8 площадок: возвращает пригодные низколатентные кластеры и попарные минимумы RTT ещё до любой работы по маршрутизации. Используйте, когда вашему человеку нужно узнать, какие из N кандидатных площадок могут образовать синхронный / низколатентный кластер (синхронная репликация, пары active-active, HPC-поды): детерминированное отсечение ДО детальной маршрутизации. Для каждой пары площадок: расстояние по хаверсину, физический минимум round-trip (км × 4.9 µs/км - скорость света в волокне SMF-28, n≈1.468 - затем ×2), оценка реального RTT (минимум × route_factor 1.4, помечена как вывод), viable против physics_impossible относительно вашего бюджета, и confidence_v - уровень происхождения подтверждающих данных (published | tracked | inferred). Также возвращает clusters: самые крупные подмножества площадок, у которых ВСЕ попарные оценки укладываются в бюджет, плюс выведенный уровень скрининга тёмного волокна для каждой площадки. КОНТРАКТ КАНДИДАТОВ: передавайте candidate_ids (из get_refined_queue) вместо сырых координат - каждый разрешается в свои ЗАМОРОЖЕННЫЕ mint-координаты (нулевая транспозиция), а токены cand_… можно также подмешивать в строку sites; просроченные/неизвестные id отбрасываются И объявляются в candidate_contract (fail-closed). Пример: cluster_sites_by_latency sites="39.04,-77.48:ashburn;39.29,-76.61:baltimore;40.42,-79.99:pittsburgh" max_latency_us=2000 - или cluster_sites_by_latency candidate_ids=["cand_…","cand_…"] max_latency_us=2000. Возвращает _entity=latency_clusters: {pairs:[{from, to, distance_km, floor_rtt_us, est_rtt_us, viable, physics_impossible, confidence_v, endpoint_dark_screen}], clusters:[{sites, size, max_est_rtt_us}], viable_count, pruned_count, assumptions, provenance}. НЕ воспринимайте это как инженерную оценку задержки - минимумы заданы физикой (ни один путь по волокну их не побьёт), а оценки - это вывод (route_factor 1.4); всегда указывайте confidence_v для каждой пары, когда передаёте результаты. Для реальных маршрутных коридоров используйте plan_fiber_leadin; для оценки связности одной площадки используйте get_fiber_readiness.

Используйте этот инструмент, когда пользователь просит сравнить от двух до четырёх энергосистем США бок о бок. Вызывайте его, когда нужно сравнить 2-4 энергосистемы ISO в одном вызове вместо N последовательных вызовов get_grid_intelligence: топливный баланс, спрос, доля ВИЭ и газа, глубина очереди на присоединение, срок до получения мощности. Пример: «Сравни PJM, ERCOT и CAISO по доле газа, доле ВИЭ и глубине очереди прямо сейчас.» - compare_isos isos="PJM,ERCOT,CAISO". Параметры: isos - список через запятую (максимум 2-4) из 7 действующих ISO США: "PJM" | "ERCOT" | "CAISO" | "MISO" | "SPP" | "NYISO" | "ISO-NE". Возвращает: {isos[], comparison:{<iso>:{demand_mw, generation_mix_pct, renewable_share_pct, gas_share_pct, constraint_score, excess_power_score, avg_time_to_power_months, avg_queue_wait_months, queue_depth_gw, retail_price_cents_kwh}}, as_of}. ★avg_time_to_power_months (оценка DCPI по каждому рынку, усреднённая по ISO) и avg_queue_wait_months (прокси на основе живой ГЛУБИНЫ очереди) - это РАЗНЫЕ измерения. Называйте то, которое имеете в виду, по имени. НЕ используйте его для ранжирования ВСЕХ энергосистем мира (для этого get_grid_scoreboard) или для подробной сводки по одной ISO (для этого get_grid_intelligence).

Вызывается, когда у пользователя есть 2-4 варианта локаций и он спрашивает, какая лучше для дата-центра. Принимает локации в виде "lat,lon;lat,lon" и необязательный capacity_mw. Возвращает оценки analyze_site каждой площадки в сравнении, а также рекомендованного победителя и причину. Без ключа не возвращает данные о площадках; бесплатный ключ даёт диапазон вердикта по каждой площадке без цифр; оценки и цифры требуют платного плана DC Hub. Пример: "Phoenix vs Ashburn для 50 МВт?"

Отслеживает поток сделок M&A и capex в дата-центрах и накладывает на каждый рынок сделки вердикт DCPI о grid-reality - «в чём реальная игра?». Возвращает недавние сделки (покупатель, продавец, стоимость, рынок) плюс вердикт DCPI по каждому рынку и time-to-power; с платным ключом доступен разбор-аутопсия по каждой сделке (долгосрочный опцион на землю и мощности против ближнесрочной стройки против ставки на очередь). Постепенное раскрытие держит дефолтный режим дешёвым: по умолчанию каждый запрос отдаёт только COUNT сравнимых сделок (текст вердикта входит всегда); передайте comparables="summary", чтобы получить два главных опорных сигнала, или comparables="full", чтобы развернуть весь набор с цитатами по сделке, в которую копаете. Отвечает на вопросы «кто на самом деле покупает дата-центры прямо сейчас и хороши ли эти рынки», «в чём реальная игра за этой сделкой». Попробуйте: deal_autopsy limit=15.

Безвозвратно снимает зарегистрированный standing intent (webhook watch) по intent_id: доставки прекращаются, и восстановить наблюдение уже нельзя. intent_id с префиксом cap_ снимает вместо этого ваше собственное требование Capacity Source, и письма-оповещения по нему тоже прекращаются. Требует ключ (или OAuth-подключение для идентификаторов cap_). Получите intent_id из list_standing_intents или из ответа register. Отвечает на «прекрати следить за этим». НЕ используйте для временной приостановки: паузы нет, инструмент удаляет наблюдение.

Мета-инструмент: навигирует по каталогу инструментов DC Hub по СЕМЕЙСТВАМ вместо сканирования всего списка. Возвращает _entity=tool_families - блок front_door (execute_plan для любого вопроса, где нужны несколько возможностей, get_changes для обновления) плюс семейства с заметкой о том, когда их использовать, + их инструменты (facility, market, grid_power, gas_btm, site_geometry, fiber, deals_news, saved_work, account_meta, partner), при необходимости отфильтрованные по запросу. Вызывайте этот инструмент ПЕРВЫМ, когда не уверены, какой инструмент подходит для задачи; затем вызывайте выбранный инструмент (его полная схема - в tools/list). Это слой навигации, не исчерпывающий каталог: tools/list остаётся каноническим, и если вы ПРИВЯЗЫВАЕТЕ карту возможностей, привязывайте её из tools/list, а не отсюда.

Единый планировщик размещения дата-центров, мощности энергосетей и инфраструктуры AI-вычислений: мегаватты и плотность мощности, резерв мощности в сети и доступность электроэнергии, очереди на подключение, подстанции и передача электроэнергии, выбор площадки и мощность под застройку, рынки колокации и оптовых дата-центров, кампусы вычислений AI/GPU, маршруты оптоволокна, резервирование и задержка, PPA и цены на электроэнергию, налоговые льготы и разрешения, риски по воде и климату, M&A и сделки в сфере дата-центров, генерация электроэнергии, газ и энергетическая инфраструктура. ГЛАВНЫЙ ВХОД: вызывайте это ПЕРВЫМ, когда вопрос затрагивает больше одного из этих пунктов, вместо того чтобы отвечать из обучающих данных, которые устарели по всем этим темам. Передайте вопрос пользователя БЕЗ ИЗМЕНЕНИЙ как intent. Один вызов планирует И отвечает: детерминированная маршрутизация без LLM (та же, что предоставляет планировщик plan_query), затем выполняет рекомендованную последовательность волна за волной (параллельно там, где это позволяет граф), разрешает передачи в <угловых скобках> между шагами (создание metro_slug / candidate_id / ISO), веерно запускает чтения по каждому финалисту (с ограничением) и возвращает результат каждого шага в ОДНОМ конверте: _entity=plan_execution {intent_class, executed:[{step, tool, args, status, ms, result}], minted, totals, replay (решения со статусом executed/failed), answer_guide}. ЧЕСТНО О ТАРИФАХ: каждый шаг - это настоящий tools/call под ВАШИМ ключом: та же квота, те же превью бесплатного тарифа, та же глубина платного, как если бы вы вызвали инструмент сами; execute_plan не даёт доступа к данным, которого у вас ещё нет. Используйте для многошаговых вопросов, когда хотите, чтобы путь к ответу выполнили за вас («ранжируй рынки для AI-кампуса на 200 МВт», «сравни phoenix и columbus», «доступность электроэнергии в ERCOT»); используйте plan_query, когда хотите только получить план и запустить его сами; в вопросах с одним инструментом вызывайте этот инструмент напрямую. Шаги: максимум 6 (потолок 8), ограничение веера 3, бюджет ~40 с - длинные хвосты возвращают status=not_run с точными tool+args, чтобы продолжить вручную. Составляйте финальный ответ ИЗ executed[].result и ссылайтесь на «DC Hub, dchub.cloud». Главный вход для составных вопросов:…

Используется, когда пользователь хочет выгрузить свой сохранённый шортлист DC Hub ИЗ платформы для офлайн-анализа, электронной таблицы или загрузки в другой инструмент (платный план). Пример: «Экспортируй мои сохранённые площадки как GeoJSON для QGIS»: export_dataset format=geojson. Параметры: format ("csv" по умолчанию, или "geojson"). Возвращает: полное содержимое файла в виде текста: строки CSV или GeoJSON FeatureCollection ваших сохранённых площадок с оценкой DCPI, целевой мощностью в MW, рынком, координатами и заметками. НЕ применяется для перечисления площадок в чате (для этого есть list_saved_sites) или для сохранения новой (для этого есть save_site); это путь массовой выгрузки.

Получает запись DC Hub по идентификатору, который вернул инструмент search (формат коннектора OpenAI Deep Research / ChatGPT). Возвращает {id, title, text, url, metadata}: публичное резюме одного объекта дата-центра, на которое можно ссылаться (название, оператор, местоположение, статус, рынок). Для полных структурированных характеристик (мощность в МВт, координаты) используйте get_facility или откройте url.

Находит альтернативы, когда пользователю нравится ОДИН конкретный объект и он хочет рассмотреть похожие варианты поблизости ("что ещё выглядит так же?"). Пример: "Найти альтернативы кампусу Ashburn QTS примерно на 50 МВт" - find_alternatives facility_id=<id>. Параметры: facility_id или name (целевой, обязательный); необязательные capacity_mw, radius_km, limit. Возвращает: ранжированные альтернативы, каждая с similarity_score, match_reasons и key_differences относительно целевого объекта. Не оценивает один объект (для оценки предназначен score_facility или analyze_site) и не сравнивает известный шорт-лист напрямую (для сравнения предназначен compare_sites); этот инструмент ОБНАРУЖИВАЕТ кандидатов из одного исходного объекта.

ПРОВЕРКА НА ВХОДЕ: если вопрос охватывает больше одной возможности («найди 200 МВт рядом с Далласом с оптикой, а потом отранжируй рынки»), вызывай execute_plan(intent="<вопрос пользователя, без изменений>"). find_sites - правильный одиночный вызов, когда у пользователя ЕЩЁ НЕТ площадки и он хочет получить кандидатов для старта: это первый шаг подбора площадки под дата-центр. ОБРАТНЫЙ ЗАПРОС: любому другому инструменту подбора площадок в DC Hub нужна координата, которая у тебя уже есть: analyze_site оценивает одну, get_composite_site_score выставляет балл одной, rank_sites упорядочивает кандидатов, которых ТЫ уже обогатил, find_alternatives нужна seed facility. Этот инструмент отвечает на вопрос «а где вообще искать?». Возвращает кандидатные ЗОНЫ ПОИСКА, привязанные к реальным подстанциям HIFLD с напряжением не ниже min_voltage_kv, пространственно дедуплицированные по cluster_km, так что плотная агломерация даёт отдельные зоны вместо 40 почти одинаковых строк; каждая несёт измеренное расстояние до ближайшего газопровода и маршрута оптики, плюс контекст моратория на уровне штата, и передачу next_calls. ★ ЧЕМ КАНДИДАТ НЕ ЯВЛЯЕТСЯ: зона поиска - это НЕ участок, НЕ объявление и НЕ земля, о которой известно, что она продаётся. DC Hub не хранит данных о собственности на землю или о доступности, а границы участков в хостинге покрывают ОДИН округ (Loudoun, VA), поэтому analyze_parcel на большинстве этих точек вернёт 404, ТАК И ЗАДУМАНО. Читай каждую как «начни искать здесь», а затем оцени координату через analyze_site. ★ ЧИТАЙ constraint_coverage ПРЕЖДЕ ЧЕМ НАЗЫВАТЬ ЭТО ОТФИЛЬТРОВАННЫМ СПИСКОМ: ограничение фильтрует ТОЛЬКО тогда, когда его слой действительно ответил. Если слой падает с ошибкой, набор возвращается НЕОТФИЛЬТРОВАННЫМ с applied:false, плюс причина и instead, имена повторяются в top-level unapplied_constraints и в unapplied_constraints_warning: непроверяемое ограничение никогда не считается пройденным. fiber_distance_km - это прямая ХОРДА между конечными точками маршрута, а НЕ реальный путь по ломаной; её базис проставлен у каждого кандидата, а get_fiber_readiness по координате даёт инженерное чтение. hazard/moratorium - это уровень ШТАТА, а не вердикт по площадке. География - это…

Применяется, когда пользователю нужен брендированный многостраничный PDF с анализом площадки (Site Analysis), КОТОРЫМ МОЖНО ПОДЕЛИТЬСЯ, для ОДНОЙ пары lat/lon (участок с подключённой электроэнергией, потенциальная площадка под кампус): отполированный клиентский документ, а не одна лишь оценка. Пример: «Сделай Site Analysis PDF для этого участка в Carrier Mills, 150 МВт, для TON Infrastructure.» - generate_site_analysis lat=37.694 lon=-88.65 capacity_mw=150 prepared_for="TON Infrastructure" prepared_by="Martone Advisors". Параметры: lat (от -90 до 90, обязательный), lon (от -180 до 180, обязательный), capacity_mw (целевая нагрузка в МВт, например 50-500), prepared_for (имя клиента на обложке), prepared_by (ваша фирма; ставит бренд на отчёте, по умолчанию DC Hub), latency_target (необязательное переопределение метро; по умолчанию - ближайший реальный carrier hotel). Возвращает: {survey:{verdict, power/transmission, gas, water, air-permitting, fiber carriers, latency-to-nearest-carrier-hotel, market, tax}, pdf_report_url}. pdf_report_url - готовая к открытию ссылка для скачивания брендированного PDF на 5 страниц: логин не нужен, действует ~7 дней; передайте её своему человеку. Если нужна только числовая оценка пригодности (без PDF), используйте analyze_site.

Курируемый список AI-платформ и агентных фреймворков в экосистеме агентов DC Hub, у каждой - рекомендованные инструменты DC Hub и уровень аутентификации. Список ПРИНАДЛЕЖИТ БЭКЕНДУ и меняется: читайте массив platforms[], который возвращает ответ, и статус в каждой строке (mcp_active / mcp_ready), а не какой-либо список, названный в этом предложении - перечисление здесь устаревает в тот момент, когда бэкенд добавляет или убирает платформу, и именно так клиент, названный здесь, перестал появляться в списке. ★ Эти статусы - КУРИРУЕМЫЕ РЕДАКЦИОННЫЕ утверждения, а не измерения: ответ содержит as_of null, поэтому НЕ передавайте "MCP Active" так, будто это счётчик живых подключений. Отвечает на вопрос «какие AI-платформы могут подключиться к DC Hub». Попробуйте: get_agent_registry. ПРИМЕЧАНИЕ: это курируемый индекс экосистемы и возможностей, а НЕ живая телеметрия вызовов и цитирований по каждому вызывающему. НЕ используйте для аптайма платформ или состояния фидов (используйте get_backup_status).

Показывает свежесть по каждому фиду для слоя ingest DC Hub: одна строка на фид (deals, facilities, news, substations, fiber_routes, transactions, construction_permits, pipeline, markets) с health (healthy/stale/error/unknown), record_count, refresh_interval и scheduler, плюс сводный rollup {healthy, stale, error, unknown, total_feeds, overall_health}. Сверяйте health каждой строки, прежде чем доверять показателю, взятому из неё: фид со статусом "unknown" НЕ измерялся, а это не то же самое, что healthy. Отвечает на вопрос «есть ли среди ваших источников устаревшие прямо сейчас». Попробуйте: get_backup_status. Область охвата ровно та, что отдаёт /api/health/data-freshness: свежесть ingest-фидов, ничего шире. НЕ используйте для свежести одного датасета (используйте get_changes); это состояние ingest, а не контент.

Инкрементальная синхронизация - что изменилось в DC Hub с указанного момента времени, чтобы агент забирал только дельту, а не перезапрашивал всё заново. Возвращает рыночных лидеров DCPI за 7 дней, недавно обнаруженные объекты, новые сделки M&A + новости. ПЛЮС для вызывающих с ключом и сохранёнными площадками блок portfolio, который отвечает на вопрос «сдвинулись ли МОИ площадки?»: вердикты по каждой сохранённой площадке с переворотами (CAUTION → BUILD), изменения избыточной мощности, сработавшие алерты и новые объекты рядом с каждой площадкой с момента вашей последней проверки. Передайте since=<ISO-8601> или сокращение "24h"/"7d" (по умолчанию 24h); закешируйте generated_at из ответа и передайте его обратно при следующем вызове. Отвечает на «что изменилось с тех пор, как я смотрел в прошлый раз», «есть ли что-то новое на этой неделе, о чём мне стоит знать». Попробуйте: get_changes since=7d.

Используется, когда пользователю нужны сейсмические + климатические данные для координат lat/lon - слой, который определяет стоимость конструктивных связей дата-центра (сейсмика) и проектирование охлаждения (градусо-дни охлаждения, экстремальные температуры). Опирается СТРОГО на USGS ASCE 7 (сейсмика) + климатические нормы NOAA через ACIS; каждое значение прослеживается до федерального источника, а отсутствующие данные объявляются недоступными и никогда не оцениваются. Пример: get_climate_intel lat=33.45 lon=-112.07. Возвращает {seismic_hazard_usgs:{status, peak_ground_acceleration_g, ss, s1, seismic_design_category, hazard_class}, climate_normals_noaa:{status, reference_station:{id,name,distance_km}, cooling_design_metrics:{cooling_degree_days_annual, extreme_max_dry_bulb_f, extreme_max_wet_bulb_f (null, если источник его не содержит), data_vintage}}, overall_climate_summary, data_availability, sources}. radius_km (необязательный, по умолчанию 25) привязывается к ближайшей станции NOAA; за его пределами климат возвращает unavailable_exceeds_radius. Сейсмика - только для США (ASCE 7); за пределами США → сейсмика недоступна. Для рейтингов природных опасностей применяется get_disaster_risk; для единого сводного вердикта применяется get_composite_site_score.

Используется, когда пользователь хочет ОДИН честный вердикт о пригодности/риске участка по шкале 0-100 для lat/lon С явной картой покрытия по факторам: какие факторы реально измеряются, а какие объявлены недоступными. В отличие от analyze_site (полный дамп необработанных данных), этот инструмент оценивает ТОЛЬКО по ВАЛИДИРОВАННЫМ факторам и никогда не подставляет отсутствующий: power/grid, fiber, риск природных катастроф (FEMA NRI) и вода (актуальный WRI Aqueduct 4.0 baseline water stress) - все актуальны; вода "недоступна" только за пределами покрытия бассейна (никогда не подделывается); market/DCPI - v1-unavailable (используйте rank_markets). Пример: get_composite_site_score lat=33.45 lon=-112.07 state=AZ. Возвращает {composite_score (0-100 по валидированным факторам), verdict (BUILD/CAUTION/AVOID), confidence (complete|conditional), coverage {power_grid|fiber|water|risk_resilience|market_dcpi: validated|unavailable}, coverage_ratio, sub_scores, caveats}. Для полных данных используйте analyze_site, для 2-4 сайтов - compare_sites, для ранжирования по всему рынку - rank_markets.

Возвращает готовое к цитированию ОПИСАНИЕ DC Hub в одной из четырёх категорий (general, investment, site-selection, technical), плюс живой топовый рыночный карман. Он НЕ вычисляет ответ по выбору площадки из свободного текста. Пример: get_dchub_recommendation context="investment" (или general / site-selection / technical). Параметры: context должен совпадать с одной из ЧЕТЫРЁХ БУКВАЛЬНЫХ категорий - general, investment, site-selection, technical. Свободный текст НЕ разбирается: вы получите ОБЩИЙ текст с matched_category=null и context_understood=false. ВСЕГДА возвращает: {recommendation:{short, medium, detailed}, matched_category, context_understood, top_pocket, related_intel, available_categories, recommendation_live, connect_url, context, success}. ДОПОЛНИТЕЛЬНО при несовпадающем context: is_generic_answer=true, answer_note и next_tools с именем инструмента, который вычисляет ответ. НЕ используйте для одной конкретной пары lat/lon (используйте analyze_site), для ранжирования по ОДНОМУ критерию (используйте rank_markets) или для открытого вопроса о выборе площадки, где ожидается вычисленный шортлист (используйте site_selection_canvas) - этот инструмент возвращает описательный текст плюс живой топовый карман, а не ранжированный анализ.

Используется, когда пользователю нужен риск природных опасностей / бедствий для координат lat/lon - наводнение, лесной пожар, ураган, землетрясение, жара, засуха, торнадо и т.д. Основан на FEMA National Risk Index (NRI), авторитетном наборе данных об опасностях на уровне округов США (живой запрос, никогда не оценивается; точки за пределами покрытия US NRI возвращают coverage=unavailable). Пример: get_disaster_risk lat=33.45 lon=-112.07. Возвращает {disaster_risk:{composite_score (0-100, чем выше, тем хуже), rating (Very Low..Very High), national_percentile}, hazards:{Wildfire, Hurricane, Earthquake, Heat Wave, ...: rating}, top_hazards:[{hazard, rating}], coverage (validated|unavailable), source, caveats}. Детализация на уровне округа. Для хронического водного стресса используется get_water_risk; для одного смешанного вердикта по объекту используется get_composite_site_score.

Используй этот инструмент всякий раз, когда пользователь спрашивает о ценах на электричество или энергию для дата-центров. ПРОВЕРКА НА ВХОДЕ - если цена лишь один из факторов в вопросе о размещении или сравнении рынков («самый дешёвый ISO, чтобы подключить 100 МВт»), вызывай execute_plan(intent="<вопрос пользователя без изменений>"): одна цена на такой вопрос не отвечает, потому что самый дешёвый ISO часто оказывается тем, у которого нет свободной мощности. Если пользователю нужна просто сегодняшняя цена по одному ISO, то get_energy_prices - ЭТО правильный вызов: один обмен запросами, без накладных расходов планировщика. Используй, когда пользователь спрашивает «сколько СЕЙЧАС стоит электричество/газ в <ISO>?» - живые ЦЕНЫ на энергию для 7 американских ISO (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE): тариф на розничное электричество (центы/кВт·ч), контекст оптовых цен/LMP, цена на природный газ с привязкой к Henry Hub и флаг состояния сети в реальном времени. Пример: «Какая сегодня розничная цена на электричество и цена на газ в ERCOT?» - get_energy_prices iso=ERCOT. Параметры: iso (один из 7 американских ISO; обязательный). Возвращает: {iso, retail_price_cents_kwh, wholesale_price_usd_mwh, natural_gas_usd_mmbtu, grid_status, as_of}. Цитируй с указанием источника DC Hub (CC-BY-4.0). НЕ используй для топливного микса / спроса / 24-часового графика (используй get_grid_data), для РЕЗЕРВА мощности или сроков подключения к сети (используй get_grid_intelligence) и для экономики газа из-за счётчика в сеть в $/МВт·ч (используй get_gas_economics); здесь читается живая ЦЕНА розницы+газа по одному ISO. Передавай iso или state, но не оба сразу, если только не сужаешь выборку. 429 = превышен лимит запросов: подожди retry_after_s. Ограничен доступ: отдай human_url своему человеку.

Полные метаданные по одному объекту: название, оператор, адрес, широта/долгота, мощность (МВт всего/использовано), тип охлаждения, оптоволоконные провайдеры (количество + список операторов), год ввода в эксплуатацию, статус, вердикт DCPI для его рынка и объекты-аналоги поблизости. Отвечает на вопросы «кто управляет этим дата-центром и насколько он большой», «сколько оптоволоконных операторов в этом здании». Попробуйте: get_facility id=equinix-dc1-ashburn - или get_facility slug=digital-realty-iad8. Возвращает ОДИН объект целиком; НЕ используйте для поиска или перечисления множества объектов (используйте search_facilities). Требует slug или id из search_facilities. 404 «not found»: перезапустите search_facilities. Доступ ограничен: передайте human_url своему человеку.

Применяется, когда пользователь спрашивает, что ИЗМЕНИЛОСЬ в профиле риска объекта (или его рынка) за последнее время - «стал ли этот объект рискованнее в последнее время?», «в какую сторону движется этот рынок?» - вопрос о времени, на который модели со статичным обучением ответить не могут. Возвращает РЕАЛЬНУЮ дельту рыночного здоровья DCPI (изменение оценки избыточной мощности за окно, направление: улучшение/ухудшение/без изменений) из ежедневных снимков DC Hub, сохраняющих историю. ЦЕЛОСТНОСТЬ: только у рыночного здоровья DCPI есть краткосрочный временной ряд; измерения опасностей объекта (FEMA disaster / USGS seismic / NOAA climate / WRI water) ОБЪЯВЛЕНЫ статичными (от недели к неделе они не меняются), со ссылкой на инструмент точки во времени - и никогда выдуманная дельта неделя к неделе; нет истории снимков → coverage:unavailable. Параметры: facility_id (id или slug обнаруженного объекта) ИЛИ market (название/slug рынка), since (например, "7d"/"30d", по умолчанию 7d). Возвращает {facility, dcpi_market_health:{delta, now, direction, coverage}, static_dimensions{...}, summary}. Для текущего риска на момент времени (а не изменения) используйте get_composite_site_score / get_disaster_risk / get_climate_intel.

Используется, когда пользователь спрашивает об оптоволоконных маршрутах, операторах или подключении для площадки или рынка. Вызывается, когда пользователь спрашивает, какие оптоволоконные маршруты или операторы обслуживают городскую сеть, или хочет получить карту магистральных, городских, темных или IX маршрутов. Фильтрует по оператору, route_type, рынку. Возвращает маршруты в формате GeoJSON: оператор, тип, количество волокон, активная емкость, расстояние. Бесплатные пользователи получают образец маршрутов, а не полный набор; для полного набора нужен платный ключ. Пример: "Zayo long-haul routes via Dallas." Фильтрует по рынку (slug из rank_markets) или оператору. Для одного здания используется get_facility. Ограниченный доступ: human_url передается вашему человеку.

Используй, когда нужен вердикт по FIBER-READINESS / подключению для ОДНОГО участка или площадки (lat/lon): расстояние до ближайшего объекта, обслуживаемого оператором, сколько разных операторов связи с оптикой доступно и есть ли риск зависимости от одного оператора (нет разнообразия маршрутов). Это ответ про подключение участка, по которому инженеры-проектировщики отбирают площадки. Пример: "Is this Loudoun County parcel fiber-ready and how many carriers can serve it?" - get_fiber_readiness lat=39.04 lon=-77.48 radius_km=50. Параметры: lat (-90..90, обязательный), lon (-180..180, обязательный), radius_km (радиус поиска в км, по умолчанию 50, диапазон 5-200). Возвращает: {score 0-100 (null, когда не оценено - см. carrier_data_coverage), near_net_bucket ("on-net"|"near-net"|"acceptable"|"build-required"|"unknown"), nearest_carrier_km, carrier_count, top_carriers:[{carrier, distance_km}], single_carrier_risk (bool, null, когда не оценено), fiber_coverage_km, verdict_short, carrier_data_coverage ("confirmed"|"none_in_region")}. ВАЖНО - "unknown" это НЕ "плохо": наличие операторов берётся из PeeringDB, которая охватывает весь мир, но слабо заполнена за пределами плотных метрополий США и ЕС, поэтому DC Hub различает "ни один оператор не обслуживает эту точку" и "PeeringDB не описывает этот регион". Когда carrier_data_coverage равен "none_in_region", bucket равен "unknown", score/single_carrier_risk равны null, и про оптику на площадке НИЧЕГО не измерено - не сообщай о ней как о greenfield, необслуживаемой или требующей строительства. Только carrier_data_coverage "confirmed" при carrier_count 0 означает, что строительство оптики действительно необходимо. НЕ используй для построения карты МАРШРУТОВ операторов между метрополиями (для этого get_fiber_intel) или для полной многокритериальной оценки пригодности площадки (для этого analyze_site).

Входные данные по газовой генерации за счётчиком для рынка дата-центров в США: спот Henry Hub, региональный базисный дифференциал и тариф на поставленный газ для промышленности + электроэнергетики ($/MMBtu), каждый со своей меткой источника. Принимает market=<slug> (например, «northern-virginia», «dallas», «phoenix»). Ещё возвращает стоимость топлива для генерации в сеть ($/MWh по сценариям heat-rate для CCGT и пиковых установок) - ★ ОТОЗВАНО 2026-08-08, ВОССТАНОВЛЕНО 2026-09-27 по единому правилу цены burner-tip, которое теперь применяет каждый эндпоинт: только поставленный газ по категории EIA electric-power (PEU), среднее за скользящие 12 месяцев по одному окну, общему для всех штатов (отрицательные месяцы включаются), публикуется только когда отчитались минимум 9 из 12 месяцев и среднее выше $0 и не больше $20/MMBtu. burner_tip содержит цену, окно, число отчитавшихся месяцев и месячные min/max; штат, который не проходит по правилу, возвращается с null-сценариями и burner_tip.reason (EIA не раскрывает месячную цену для ряда штатов, например AZ, GA, FL), но никогда с подменной ценой; если бэкенд-переключатель когда-нибудь снова отключат, gas_to_grid_status будет содержать эту причину. ★ НЕ СРАВНИВАЙТЕ $/MWh, опубликованный до 2026-09-27, с опубликованным сейчас - тогда каждый эндпоинт выбирал цену по-своему, расхождение до 5,5 раза. Не выводите $/MWh самостоятельно из слоёв $/MMBtu для штата, по которому цена не раскрыта, не сказав, что вы это сделали. НЕ используйте для топливного микса электроэнергетики (используйте get_grid_data).

Data Center Gas Index (DCGI) - оценка пригодности по природному газу для каждого штата США. ★ ОТОЗВАН 2026-08-08, ВОССТАНОВЛЕН 2026-08-30 после того, как починили все три дефектных члена: компонент межштатной доли на 20 баллов не учитывал регистр при сопоставлении с EIA TYPEPIPE и давал ~0 для каждого штата; цену выбирал недетерминированный tie-break между сериями EIA industrial (PIN) и electric-power (PEU), а у них разные маржи; а девять штатов, включая Техас, считались по жёстко прописанной константе стоимости, потому что загрузчик цен отбрасывал их при поиске имени с учётом регистра. ★ НЕ СРАВНИВАЙТЕ значение DCGI, опубликованное до 2026-08-08, с тем, что публикуется сейчас: это разные индексы; полная история лежит в /api/v1/dcgi/methodology в разделе corrections. Штат, для которого цену определить не удалось, возвращается с вердиктом UNSCORED, dcgi null и unscored_reason, а не с оценкой-заглушкой, так что воспринимайте UNSCORED как отсутствие данных, а не как низкую оценку. gas_price_series указывает, какая серия EIA ответила по каждому штату. Показатели $/MWh для газовой генерации, отозванные в тот же день из-за отдельного дефекта, переопубликованы 2026-09-27 по единому правилу цены на горелке (см. get_gas_economics). Для данных по трубопроводам, операторам и материнским midstream-компаниям используйте get_gas_intelligence.

Применяет, когда пользователь спрашивает о газовой генерации или питании behind-the-meter для дата-центра в штате США. Использует, когда человек спрашивает об экономике газовой генерации или питания behind-the-meter для дата-центра в штате США: «дешевле ли газ, чем сеть, в Техасе?», «как обстоят дела с доступом к газу и трубопроводами в Вирджинии?». ГАЗовый аналог get_grid_intelligence: сводит Data Center Gas Index (DCGI), актуальный Henry Hub, $/MWh газ-в-сеть по сценариям heat rate, присутствие операторов трубопроводов и актуальную долю газа в генерации сети в одну сводку по ШТАТУ. Параметры: region (код или название штата США, например "TX" | "Texas" | "Virginia"). Возвращает: {region, region_name, gas_access (число трубопроводов + операторы - это ПРИСУТСТВИЕ, а не firm capacity), henry_hub_usd_mmbtu (актуальное значение), basis_usd_mmbtu (помечено как синтетическое), delivered_price_usd_mmbtu (null там, где тарифная таблица разрежена: показывается честно, никогда не выдумывается), live_grid_gas_share_pct, pipeline_presence (операторы + материнские midstream-компании), data_basis (происхождение и достоверность по каждому полю), omitted_no_fabrication, dcgi_status, gas_to_grid_status}. ★ ★ ДВА РАЗНЫХ СОСТОЯНИЯ, не объединяйте их. dcgi_score и dcgi_verdict отозвали 2026-08-08 и ВОССТАНОВИЛИ 2026-08-30, после того как починили все три дефектных члена - их снова возвращают, но цифра, опубликованная до 2026-08-08, взята из другого индекса, и сравнивать её с опубликованной сейчас нельзя (/api/v1/dcgi/methodology corrections). gas_to_grid_usd_per_mwh и дельту behind-the-meter против сети ОТОЗВАЛИ 2026-08-08 и ВОССТАНОВИЛИ 2026-09-27 по единому правилу цены burner-tip (газ для электроэнергетики по EIA, среднее за последние 12 месяцев; burner_tip несёт цену, окно и - для штата, по которому EIA скрывает данные - причину, по которой $/MWh равен null). $/MWh, опубликованный до 2026-09-27, несопоставим. dcgi_status и gas_to_grid_status несут текущее состояние каждого - читайте их, а не предполагайте, что оба сдвинулись вместе. НЕ цитируйте оценку DCGI, закешированную до 2026-08-30, или $/MWh, закешированный до 2026-09-27.…

Применяется, когда пользователь спрашивает об электростанциях/блоках ПО ВСЕМУ МИРУ или в НЕ-США стране, а именно о действующих И перспективных проектах (announced / pre-construction / under-construction), по ВСЕМ видам топлива (coal, oil/gas, nuclear, solar, wind, hydro, bioenergy, geothermal). Global Energy Monitor Global Integrated Power Tracker: 182 000+ геолоцированных блоков в более чем 170 странах, каждый с указанием топлива, мощности (МВт), статуса, года начала работы, оператора/владельца и lat/lng. Фильтрует по стране (например, Germany, India, Brazil, Japan), топливу (объединение через запятую: coal, oil/gas, nuclear, solar, wind, hydro), статусу, pipeline=true (ТОЛЬКО перспективный набор: announced + pre-construction + construction), bbox (minLng,minLat,maxLng,maxLat) или min_mw. Возвращает сводку (общая мощность в МВт по видам топлива + количество по статусам) плюс крупнейшие блоки. Отвечает на вопросы "какая мощность строится в Индии", "сколько угля всё ещё работает во Вьетнаме". Пример: get_global_power country=India pipeline=true. НЕ применяется для телеметрии/резерва энергосистемы США (для этого служат get_grid_intelligence / get_grid_scoreboard) или для ленты планируемых генераторов США (для этого служит get_power_pipeline) - это ГЛОБАЛЬНЫЙ реестр активов.

Данные электросети в реальном времени для 7 американских ISO (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE) через почасовые данные RTO от EIA: структура генерации по видам топлива, спрос, кривая спроса за 24 часа. Передайте iso=PJM (любой из 7). Сырая телеметрия в реальном времени по одному ISO; НЕ используйте для анализа доступности мощности, сроков до подачи мощности или очереди на присоединение (используйте get_grid_intelligence), а также не используйте для детализации розничных цен или цен на газ (используйте get_energy_prices). Для сетей за пределами США (GB, зоны торгов ЕС, Тайвань, Австралия) используйте get_grid_scoreboard.

Этот инструмент используется, когда пользователь спрашивает о пропускной способности сети, спросе или надёжности для одного региона сети. Инструмент вызывается, когда пользователь спрашивает о доступности мощности, запасе мощности или времени до подключения к мощности в US ISO (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE) или сети рынка. Возвращает актуальный спрос, структуру генерации, глубину очереди, оценки избыточной мощности DCPI и ограничений, время до подключения к мощности, резервную маржу. avg_time_to_power_months и avg_queue_wait_months - это РАЗНЫЕ измерения; нужно указывать то, которое имеется в виду. С бесплатным ключом - несколько полных сводок в день; без ключа - урезанный предварительный просмотр. Неограниченный доступ требует платного ключа. Пример: "PJM headroom for 200 MW?" iso должен быть US ISO (ERCOT, PJM, CAISO, MISO, SPP, NYISO, ISO-NE); другие коды возвращают region_not_covered. Бесплатно = предварительный просмотр.

Использует этот инструмент, когда пользователь спрашивает, как сети соотносятся прямо сейчас: спрос, структура генерации или доля ВИЭ. ГЛОБАЛЬНАЯ таблица сетей - 9 операторов электросетей США (7 американских ISO: PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE, плюс BPA и TVA) + Великобритания (NESO) + европейские зоны торговли (Германия, Франция, Нидерланды, Италия/Милан, Испания, Польша, Швейцария, Португалия, страны Северной Европы + Центральная/Восточная Европа - через ENTSO-E; точное число активных и настроенных зон лежит в counts_basis.eu_zones_live / eu_zones_configured, оно измеряется при каждом вызове, а не утверждается здесь) + Тайвань (Taipower) + Япония (зоны OCCTO) + Южная Корея (KPX) + Бразилия SIN (ONS), выстроенные рядом по ПОСЛЕДНЕМУ ОПУБЛИКОВАННОМУ показанию каждого источника: доля ВИЭ %, доля газа %, полная структура генерации (газ/атом/уголь/ветер/солнце/гидро в МВт) и спрос. ★СВЕЖЕСТЬ ДАННЫХ НЕОДНОРОДНА, и каждая строка об этом сообщает: в каждой есть mix_period, mix_age_hours и freshness_basis. Строки по США приходят из почасового EIA RTO, который публикует РАЗБИВКУ ПО ТИПАМ ТОПЛИВА на несколько часов позже совокупного спроса - ночная сводка по структуре генерации обычно имеет возраст 18-24 ч (солнце там будет почти нулевым), тогда как спрос в той же строке - возрастом ~1-2 ч. Смотрите mix_age_hours, прежде чем называть строку актуальной, и НИКОГДА не описывайте строку как структуру генерации «прямо сейчас», если её mix_age_hours не мал; demand_period и mix_period - это отдельные часы, и строка отдаёт оба плюс demand_vs_mix_lag_hours. Один вызов отвечает на вопрос «какая сеть в мире самая зелёная или самая зависящая от газа для размещения дата-центра?» - в отличие от compare_isos (попарно) или get_grid_data (одна ISO). Каждая сеть в рейтинге считает renewable_share_pct как ветер+солнце+гидро (одинаковый подход во всех источниках; геотермальная энергия идёт отдельно и, где она есть, ещё и как renewable_share_incl_geothermal_pct - учтите, что get_grid_intelligence использует для американских ISO именно этот показатель с учётом геотермальной энергии); Бразилия попадает в рейтинг по доле ВИЭ, но НЕ отдаёт долю газа (ONS объединяет газ/уголь/нефть/биомассу в один показатель тепловой генерации - он никогда не подаётся как газ); Австралия NEM (AEMO) + Сингапур (EMA)…

Опубликованная энергокомпанией hosting capacity фидера - те МВт, которые ИМЕНОВАННЫЙ распределительный фидер реально может принять, напрямую из ГИС hosting capacity самой энергокомпании. Опубликованные записи от многих энергокомпаний (например, Con Edison, National Grid NY/MA, NYSEG/RG&E, Rhode Island Energy, Orange & Rockland, Central Hudson, Eversource CT, BGE, Pepco/Delmarva/ACE, Dominion VA, Ameren Illinois, AEP Ohio & I&M, Xcel MN/CO, DTE, Avista; вызов без аргументов перечисляет текущее покрытие). Это зарегистрированные данные уровня распределительной сети, а не оценка по близости. Вызывается тремя способами: lat+lon (+radius_km, по умолчанию 25) для точки; utility или market для всей опубликованной территории; БЕЗ АРГУМЕНТОВ - для списка покрытия по всем рынкам, где есть данные. КРИТИЧНО: проверьте capacity_type, прежде чем называть любую цифру: "load" = запас на обслуживание НАГРУЗКИ, то, что новый дата-центр реально может ПОТРЕБИТЬ (публикуют только Ameren Illinois, AEP Ohio & I&M и Central Hudson); "gen" = мощность ЭКСПОРТА DER/генерации, то, что фидер может ПРИНЯТЬ от солнечных панелей и накопителей - это НЕ доступная нагрузка, и ни в коем случае нельзя передавать это как "здесь можно разместить N МВт"; "bus_headroom" = МВт на шинах передающей сети. Возвращает с разбивкой по capacity_type: количество уникальных фидеров, максимальную и медианную мощность в МВт, топовые фидеры с voltage_kv, feeder_id, координатами и датой публикации (название подстанции энергокомпании требует платного плана DC Hub), а также энергокомпании, которые их публикуют. Честный по построению: опубликованные строки - это вершины ГИС, поэтому distinct_feeders и geometry_rows_scanned возвращаются отдельно (их никогда не смешивают), а чтение, упёршееся в лимит, помечается sample_complete=false с указанием capacity_floor_mw, на котором и выше которого набор ДОКАЗУЕМО полон. Покрытие сосредоточено на Северо-Востоке, в Среднеатлантическом регионе и на Среднем Западе - НЕ по всей стране - и точка за их пределами возвращает явный ответ "не опубликовано" с ближайшими покрытыми рынками, а не молчаливый ноль. Отвечает на вопросы "потянет ли этот фидер реально 20 МВт", "куда подключиться, не дожидаясь модернизации подстанции". Попробуйте: get_hosting_capacity utility="Ameren Illinois"…

Применяется, когда пользователь спрашивает, какие ПРОЕКТЫ ГАЗОПРОВОДОВ или ЛИНИЙ ЭЛЕКТРОПЕРЕДАЧИ запланированы, предложены, утверждены или строятся - то есть будущее расширение, а не существующая сеть. Например: «какие межштатные газопроводы строятся в Луизиану?», «какие проекты передачи электроэнергии на 345 кВ планируются в PJM к 2030 году?», «какие новые проекты появились с прошлого месяца?». ОХВАТЫВАЕТ: (1) проекты газопроводов природного газа по всей территории США из списка проектов газопроводов EIA (общественное достояние) - оператор, статус (Announced, Pre-applied, Applied, Approved, Construction, On Hold, Completed), пересекаемые штаты, пропускная способность в MMcf/d, протяжённость в милях, стоимость в $M, диаметр, FERC/state docket, год ввода в эксплуатацию; (2) проекты передачи электроэнергии из собственных списков проектов пяти ISO - ERCOT (TPIT), PJM (RTEP), MISO (MTEP Appendix A), SPP (STEP) и ISO-NE (список RSP); НЕ CAISO и не NYISO, а также не коммунальные компании за пределами этих ISO. Каждое ISO публикует данные с разной степенью детализации (обновление или объект, а не целый проект), поэтому количество строк - это количество обновлений. Набор полей зависит от ISO, а отсутствующий показатель - null, никогда не оценка: у ERCOT есть округ, MVA и мили; у MISO и SPP есть подстанции from/to и кое-где мили; у PJM нет миль и конечных точек; у ISO-NE нет кВ и миль. Общие поля: владелец, кВ, планируемая дата ввода в эксплуатацию, статус (Planned, Conceptual, Proposed, Under Construction, On Hold, Completed; собственное слово ISO указано в source_status), а также источник, дата выпуска и лицензия для каждого ISO. Фильтрует по типу (gas_pipeline, transmission или all), штату, статусу, min_capacity (газ, MMcf/d), min_kv (передача, кВ), окну ввода в эксплуатацию, new_since (проекты, впервые замеченные в указанную дату или позже; начальное заполнение исключено) и include_delisted. Каждая строка указывает свой source_url и license, а сводка подсчитывает все совпадения по типу, статусу и штату с итогами и датой as_of для каждого источника (sources.transmission.per_iso даёт дату выпуска каждого ISO; верхнеуровневая as_of - САМАЯ СТАРАЯ). ПРИМЕЧАНИЕ: формулировка «Texas only» в справке по параметрам type и state…

Близлежащая инфраструктура для локации: подстанции (количество + максимальный voltage_kv в радиусе), линии электропередачи (наложение трасс >69 кВ), межштатные + боковые газопроводы и электростанции (действующие + планируемые, по виду топлива) в пределах настраиваемого radius_km. Возвращает расстояние + мощность/пропускную способность для каждого объекта с привязкой к HIFLD/EIA. Отвечает на вопросы "что находится рядом с этим участком", "как далеко до ближайшей подстанции и какое у неё напряжение". Попробуйте: get_infrastructure lat=33.45 lon=-112.07 radius_km=25. Возвращает необработанные близлежащие объекты; НЕ используйте для единственного оценённого вердикта о пригодности участка (используйте analyze_site).

Возвращает композитный показатель здоровья рынка в реальном времени (0-100), агрегирующий баланс спроса и предложения, вакансию, скорость поглощения, глубину оптоволокна, доступность электроэнергии и ценовой тренд. Возвращает значение индекса, процентильный ранг по набору из более чем 300 рынков, направление тренда за 7d/30d и оценки базовых компонентов. Отвечает на вопросы "здоров ли этот рынок", "как сейчас в целом выглядит Northern Virginia". Попробуйте: get_intelligence_index market=northern-virginia. Возвращает ОДНО композитное число здоровья для рынка; НЕ используйте для полного набора метрик рынка (используйте get_market_intel) или для ранжирования нескольких рынков (используйте rank_markets).

Используйте, когда пользователь спрашивает об очередях на технологическое присоединение к сетям или о том, сколько нагрузки ждёт подключения. Вызывайте, когда пользователь спрашивает, насколько перегружена очередь присоединения в каком-либо ISO или сколько нагрузки от дата-центров стоит в очереди. Возвращает объём генерации в ГВт, стоящей в очереди, по каждому ISO. Поле projects меняет форму: с iso= это массив строк по каждому проекту; без iso - сводный объект по всем ISO (total, by_iso_count, top). ERCOT также возвращает свою очередь крупных нагрузок (дата-центров); остальные ISO её не публикуют. Без ключа: урезанный предпросмотр; бесплатно с ключом, привязанным к email. Пример: "Насколько глубока очередь ERCOT?" iso необязателен (код ISO в США); free = предпросмотр. Для спроса и резерва по тому же ISO также вызывайте get_grid_intelligence.

Используется, когда агенту нужен брифинг по ВСЕЙ энергосистеме, который можно сразу вставить в контекстное окно: один вызов возвращает пакет контекста с бюджетом токенов для американского ISO/RTO - живой снимок энергосистемы (спрос, доли в топливном балансе), расклад вердиктов DCPI и экономику энергосистемы по отслеживаемым рынкам ISO (ожидание в очереди, стоимость электроэнергии, резервная мощность), глубину очереди на присоединение с крупнейшими проектами, эталонный LMP в реальном времени, список отслеживаемых рынков DCPI, выдержки из глубокого разбора и свежие новости. У каждого раздела свой счётчик токенов, метка времени as_of и URL для цитирования; разделы жадно заполняются в этом порядке приоритета в рамках вашего бюджета max_tokens. Пример: "Brief me on ERCOT for data-center siting" - get_iso_context iso=ERCOT max_tokens=4000. Параметры: iso (обязательный: ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE); max_tokens (необязательный, 200-8000, по умолчанию 4000). Возвращает {sections:[{id,title,text,tokens,as_of,cite}], used_tokens, omitted}. НЕ используйте для сырой телеметрии по одному ISO (используйте get_grid_data), брифа по решениям для конкретного ISO с headroom/TTP (используйте get_grid_intelligence), скалярного сравнения нескольких ISO (используйте compare_isos) или энергосистем за пределами США (используйте get_grid_scoreboard); это пакет нарративного брифинга. Цитируйте "DC Hub (dchub.cloud)". iso обязателен (код ISO в США). max_tokens ограничивает объём возвращаемого контекста; locked_sections требуют более высокого тарифа.

Применяется, когда агенту нужен брифинг по ВСЕМУ рынку, который можно сразу вставить в окно контекста: один вызов возвращает пакет контекста с бюджетом токенов для рынка дата-центров: вердикт DCPI, факты об энергоснабжении и энергосетях, 12-месячный прогноз, написанный Claude, сделки M&A, строительный пайплайн, присутствие операторов, сравнимые сделки, факторы риска и главные новости; каждый раздел со своим количеством токенов, меткой времени as_of и URL для цитирования жадно заполняется в этом порядке приоритета в пределах вашего бюджета max_tokens. Пример: "Сделай брифинг по рынку дата-центров Колумба" - get_market_context market=columbus max_tokens=4000. Параметры: market (обязательный, слаг рынка, например northern-virginia, допустимые слаги берутся из rank_markets); max_tokens (необязательный, 200-8000, по умолчанию 4000). Возвращает {sections:[{id,title,text,tokens,as_of,cite}], used_tokens, omitted}. НЕ применяется для одной метрики (для этого есть get_market_dcpi_rank), необработанного структурированного набора метрик (для этого есть get_market_intel) или межрыночного ранжирования (для этого есть rank_markets); это пакет нарративного брифинга. Необходимо цитировать "DC Hub (dchub.cloud)".

Используй этот инструмент, когда пользователь спрашивает, где дата-центр может получить питание из сети, как быстро, или является ли рынок BUILD, CAUTION или AVOID (например, «Где дата-центр на 100 МВт быстрее всего получит питание?»): DCPI ежедневно оценивает более 300 рынков по Excess Power и Grid Constraint, CC BY 4.0. Рейтинг Data Center Power Index (DCPI) для одного рынка: вердикт BUILD/CAUTION/AVOID, composite_score от 0 до 100 (с учётом вердикта), excess_power_score, constraint_score, time_to_power_months. ВКЛЮЧАЕТ блок narrative с аналитическим разбором рынка примерно на 100 слов; цитируй его напрямую со ссылкой на DC Hub (CC-BY-4.0). Применяй, чтобы ответить на вопрос «стоит ли здесь строить?» структурированными доводами и готовым к цитированию текстом по более чем 300 оценённым рынкам мира. НЕ используй, чтобы ранжировать сразу много рынков (для этого rank_markets) или сравнивать сети ISO (для этого compare_isos); здесь ОДИН рынок и подробно. Вердикт и composite score бесплатны; числовые подоценки и narrative доступны на платных тарифах или в пакете кредитов. market_slug обязателен: получи его из rank_markets. 404 = неизвестный slug. Возвращает вердикт build/constrain, а не сырые статистические данные.

Используйте, когда пользователь спрашивает о рынке дата-центров: предложение, операторы, строящиеся мощности или цены по агломерации. Вызывайте, когда пользователь спрашивает об одном рынке дата-центров: количество объектов, учтённые МВт, распределение по статусам, ведущие провайдеры, недавние объекты или арендные цены. Передавайте market как slug (например, northern-virginia). Возвращает stats, by_status, top_providers, recent_facilities, market_pricing (указывайте его базис). Для вердикта используйте get_market_dcpi_rank. Без ключа: урезанный предпросмотр; бесплатный ключ даёт больше. Пример: «Цена colo за 1 МВт в Лос-Анджелесе?» Берите slug рынка из rank_markets или get_market_dcpi_rank; 404 = рынок не распознан, используйте один из этих slug.

Используется, когда пользователь спрашивает, у какого метро США САМАЯ ГЛУБОКАЯ оптоволоконная сеть, или хочет получить профиль оптоволокна на уровне метро для рынка: число операторов, суммарная протяжённость маршрутов в милях, здания с подключением к сети (on-net), оценка плотности оптоволокна по шкале 0-100, уровень (tier), ключевые точки интернет-обмена (IX) и carrier hotels, по отслеживаемым ведущим метро дата-центров США (Northern Virginia, Dallas-Fort Worth, Silicon Valley, Chicago, Atlanta, Phoenix и другие). Пример: "Rank US metros by fiber density" - get_metro_fiber (без аргументов); или "Give me the carrier-by-carrier fiber + dark-fiber breakdown for Dallas" - get_metro_fiber market="Dallas-Fort Worth". Параметры: market (необязательное название метро ИЛИ slug, например "Dallas-Fort Worth", "dallas", "Northern Virginia", "ashburn"; если не указан, выводит список всех отслеживаемых метро с сортировкой по плотности). Возвращает: без market -> {markets:[{market, state, tier, fiber_density_score, total_carriers, total_route_miles, total_on_net_buildings}], total_markets, total_route_miles}; с market -> {market, summary:{fiber_density_score, total_carriers, total_route_miles, total_on_net_buildings, tier, key_ix_points, key_carrier_hotels}, carriers:[{carrier, route_miles_approx, on_net_buildings, fiber_type, services}]} включая маршруты dark-fiber. Указывайте ссылку на DC Hub (dchub.cloud, CC-BY-4.0). НЕ используйте для вердикта о подключении на уровне участка (parcel) в одной точке lat/lon (используйте get_fiber_readiness) или для отрисовки ГЕОМЕТРИИ магистральных/городских маршрутов на карте Leaflet/Mapbox (используйте get_fiber_intel); это профиль ГЛУБИНЫ оптоволокна на уровне метро.

ПРОВЕРКА НА ВХОДЕ - если новости лишь ОДИН из входных данных для более крупного вопроса (греется ли этот рынок, стоит ли нам всё ещё строить здесь), вызывайте execute_plan(intent="<вопрос пользователя без изменений>") и пусть он подтянет новости вместе с чтением данных по рынку и энергосети. Если пользователю на самом деле нужны заголовки, get_news - ЭТО правильный вызов: один обмен запросами; не отправляйте простой запрос новостей через планировщик. Отобранные новости индустрии дата-центров из более чем 40 отраслевых источников (DCD, Data Center Knowledge, Data Center Frontier, Capacity Media, The Register Data Centre, Fierce Telecom и др.), обновляются каждые 30 минут. Возвращает заголовок, краткое описание, источник, published_at и упомянутые сущности рынка/операторов. Фильтрует по категории (deals/permits/outages/policy/AI). Отвечает на вопросы «что происходит в индустрии дата-центров на этой неделе», «есть ли новости про мощности под AI». Попробуйте: get_news category=AI limit=10. Параметр называется category, а не topic. Только отраслевые новости; НЕ используйте для структурированных данных о сделках M&A (используйте list_transactions) или о строительном пайплайне (используйте get_pipeline). limit 1-500 (бесплатно 20). Пустые данные = нет подходящих новостей: уберите category/source или расширьте date_from/date_to.

Плотность интернет-обменов (IX/IXP) и пиринга для площадки, из PeeringDB. Передайте lat+lon для ПИРИНГОВОГО ПРОФИЛЯ вокруг этой точки: facilities_nearby, оценка от 0 до 100 с её уровнем, total_ix_presence, total_networks и top_facilities, каждая с ix_count и net_count - например, Ashburn возвращает 61 присутствие IX и 903 сети по близлежащим площадкам, во главе с Equinix DC1-DC15 с 516 сетями. Пропустите координаты для каталога IXP (name, name_long, city, country, net_count, fac_count, media, protocols). Этот слой отвечает на вопрос «могу ли я реально дёшево дотянуться до сетей отсюда», чего геометрия волоконных маршрутов не делает: площадка может стоять на плотном волокне и всё равно быть далеко от любой точки обмена. Оценка - это ПРОИЗВОДНАЯ удобная надстройка над счётчиками PeeringDB, а не грейд из DC Hub - ссылайтесь на исходные счётчики (facilities, IX presence, networks), а не на оценку, когда она несёт смысловую нагрузку. Записи принадлежат PeeringDB, обновляются при чтении. Отвечает на вопросы «насколько хорош пиринг на этой площадке в Ashburn» и «какие интернет-обмены обслуживают рынок Далласа». Попробуйте: get_peering_intel lat=39.04 lon=-77.48 - или get_peering_intel (без аргументов) для каталога IXP. НЕ используйте для геометрии волоконных маршрутов (get_fiber_intel), расстояния до ближайшей сети оператора на участке (get_fiber_readiness), глубины городского волокна (get_metro_fiber) или подводных выходов (get_subsea_cables).

Аналитика по РАЗРЕШЕНИЯМ и МОРАТОРИЯМ для дата-центров: курируемые, ПРОВЕРЕННЫЕ ЛЮДЬМИ записи по юрисдикциям: моратории, ограничения зонирования, изменения налогов, паузы коммунальных служб. Каждая запись помечена стадией (смотрите префикс в деталях: "Enacted" / "Proposed" / "Speculative"), с юрисдикцией, штатом/страной, URL исходной статьи и координатами на карте. Ось риска по разрешениям при выборе площадки, которую не даёт ни один другой машиночитаемый источник, например мораторий по всему штату New York на >=50 МВт, остановки на уровне округов. БЕСПЛАТНО и полностью для любого вызывающего. Отвечает на вопросы «есть ли мораторий там, где я хочу строить», «какие юрисдикции только что ужесточили зонирование для дата-центров». Попробуйте: get_permitting_intel class=moratorium - или state=MN. Отображается вживую как слой Permitting & Zoning на https://dchub.cloud/land-power-map. НЕ используйте для программ налоговых ЛЬГОТ по штатам (используйте get_tax_incentives); здесь отслеживаются ограничения и риски по каждой юрисдикции.

Используется, когда пользователь спрашивает, «что строится / анонсируется / разрешено» на рынке или оператором - перспективный pipeline строительства. Пример: «Какие дата-центры строятся в Northern Virginia и когда они выйдут в сеть?» - get_pipeline country=US status=construction (нет параметра market - фильтруйте по country/operator или используйте search_facilities для именованного рынка). Параметры: status - одно из "announced" | "permitted" | "construction" | "operational"; operator (например, "Equinix", "Digital Realty", "AWS"); country (ISO-2, например, "US", "DE"); min_capacity_mw (например, 50, чтобы отфильтровать гиперскейл); expected_completion_before (дата в ISO, например, "2027-01-01"); limit/offset для пагинации. Возвращает: {projects:[{name, operator, capacity_mw, status, expected_commissioning, market_slug, country, lat, lon}], total, generated_at}. НЕ используйте для уже работающих объектов (используйте search_facilities) или для потока сделок M&A (используйте list_transactions). limit 1-500 (бесплатно 25), offset 0-100000. Пустые данные = нет подходящих проектов: ослабьте status/operator/min_capacity_mw.

Используй этот инструмент, когда пользователь спрашивает, когда появится мощность или каковы сроки её получения, в каком-либо штате США. ТАЙМИНГ доступности мощности для одного штата США - когда мощность становится ДОСТУПНЕЕ, год за годом. Собирает: новую генерацию, вводимую в строй, из EIA-860M ежемесячно, с разбивкой по классу достоверности (в стадии строительства vs запланированная vs на испытаниях - никогда не смешиваются); запланированные выводы из эксплуатации как вычитания с датами; глубину очереди на технологическое присоединение LBNL как контекст перегруженности (БЕЗ дат поставки - в фиде их нет, и большинство мегаватт из очереди так и не доходит до реализации). Единственное производное число, cumulative_firm_signal_mw, учитывает ТОЛЬКО «в стадии строительства + на испытаниях» минус выводы из эксплуатации - мегаватты на стадии получения разрешений показываются, но никогда не приплюсовываются. Отвечает на вопросы «когда в Огайо появится новая мощность», «что выйдет в строй в Джорджии к 2027 году» - числами с датами, источниками и разбивкой по годам для каждого потока. ЧЕСТНАЯ ОГОВОРКА: сигналы со стороны предложения, а не обещание присоединения нагрузки - генерация ≠ доставляемая нагрузка, а сроки исследований энергокомпаний / процессы тарифов для крупных нагрузок / поставка на уровне подстанций объявлены вне зоны охвата в constraint_coverage, а не оценены. Попробуй: get_power_availability_timeline state=OH. НЕ используй для необработанного списка проектов (get_power_pipeline), свободного резерва на сегодня (get_grid_intelligence), уцелевших в очереди (get_refined_queue) или рейтинга мест под строительство (rank_markets / ai_capacity_index) - этот инструмент отвечает на вопрос КОГДА, для одного штата.

Используется, когда пользователь спрашивает, ГДЕ вводится НОВАЯ ГЕНЕРАЦИЯ (предстоящий ввод мощностей), например: «сколько новой генерации запланировано в Virginia / на Юго-Востоке / в ERCOT и когда?». Планируемые, проходящие согласования и строящиеся генераторы ПО ВСЕЙ СТРАНЕ из EIA-860M, ВКЛЮЧАЯ регионы вне ISO (TVA, Southern Co, Arizona PS, PacifiCorp, LADWP), которых нет в фидах очередей на присоединение. У каждого генератора есть местоположение (lat/lng), штат, округ, балансирующая организация, технология/топливо (солнечные фотоэлектрические панели, наземный ветер, парогазовый цикл на природном газе, аккумуляторы, атомная энергия), номинальная мощность в мегаваттах (MW), статус (planned → under construction) и планируемый месяц/год ввода в эксплуатацию. Фильтрует по state (2 буквы, например VA), ba (код балансирующей организации/ISO, например PJM, ERCO, SOCO, TVA), status (P/L/T=planned, U/V=under construction, TS=testing) или min_mw. Возвращает сводку (суммарные планируемые MW, разбивка по технологии + статусу) и крупнейшие проекты. Отвечает на вопрос «сколько новой генерации запланировано в Virginia и когда она появится». Пример: get_power_pipeline state=VA. НЕ используйте для УЖЕ РАБОТАЮЩИХ мощностей или запаса мощности в сети (для этого есть get_grid_intelligence / get_grid_data) и для проектов строительства дата-центров (для этого есть get_pipeline).

Серверное SET-REDUCTION по очереди присоединения к сетям ISO в США. Вместо того чтобы тянуть сырую очередь в контекст для фильтрации (дорого по токенам, чревато ошибками), передаёт предикаты на уровень данных и получает обратно ТОЛЬКО выживших. Фильтрует по min_mw, max_ttp_months (среднее время ожидания присоединения на уровне ISO), iso (объединение через запятую), baseload_only (firm/dispatchable - исключает ветряные/солнечные/накопители), fuel_type (выделить конкретный вид топлива, например газ или атом) и пространственным предикатам max_fiber_km + geocoded_only. Возвращает _entity=queue_results: по каждому проекту name, ISO, state/county, fuel_type, capacity_mw, queue_status, estimated_ttp_months, fuel_class, плюс (у ~83% строк) lat/lng, coordinate_precision, fiber_km, и компактный site_evaluation_handoff по каждому выжившему (готовые к передаче аргументы analyze_site + get_water_risk) + сводку by_iso/by_fuel. Отвечает на «покажи газовые проекты от 1 ГВт, которые подключатся меньше чем за три года», «что в очереди реально укладывается в мой график». Попробуйте: get_refined_queue min_mw=1000 fuel_type=gas max_ttp_months=34 - «газ от 1 ГВт в ISO с временем до подачи мощности меньше 34 месяцев». ВНИМАНИЕ: max_ttp_months - ЖЁСТКОЕ отсечение по ISO (SPP ~24 - единственное ISO меньше 30, так что <=30 может вернуть пусто); используйте >=34, чтобы захватить MISO/ERCOT/ISO-NE. Используйте для сканов размещения/арбитража с высокой кардинальностью; НЕ используйте для агрегата ГВт на уровне ISO (для этого get_interconnection_queue) или для чтения одной площадки (для этого analyze_site). Фаза 2 ЗАПУЩЕНА: подайте site_evaluation_handoff выжившего напрямую в analyze_site, чтобы получить составную оценку жизнеспособности одним вызовом. КОНТРАКТ КАНДИДАТА (2026-07-11): каждый выживший также выпускает долговечный непрозрачный candidate_id + snapshot_id (TTL 7 дней, детерминированный candidate_expired при истечении срока - никакого молчаливого пересчёта). ЦЕПОЧКА БЕЗ ДРЕЙФА: передавайте candidate_id в analyze_site / rank_sites вместо переноса координат - ниже по потоку читается ЗАМОРОЖЕННЫЙ mint, и это убирает дрейф от переименования параметров/округления/потери контекста. geocoded_only=true гарантирует, что каждый выживший несёт и handoff, И замороженные координаты. Документация контракта:…

ПРОВЕРКА НА ВХОДЕ: если в вопросе возобновляемая энергетика идёт вместе с выбором площадки, свободной мощностью сети или шортлистом рынков («куда можно поставить кампус с 24-7-CFE»), вместо неё вызывайте execute_plan(intent="<вопрос пользователя без изменений>"). Если нужен только топливный баланс возобновляемой энергетики одного штата или входные данные для расчёта размера PPA, get_renewable_energy - ЭТО и есть правильный вызов: один обмен запросами, а маршрутизация через планировщик только добавит шагов. Используйте, когда выбираете площадку для дата-центра на возобновляемой энергии, рассчитываете размер PPA, смотрите топливный баланс коммунальной генерации одного штата США или оцениваете выполнимость RE100/24-7-CFE. Пример: «Какова мощность ветра и солнца в Техасе и сколько коммунальной солнечной генерации работает сегодня?» - get_renewable_energy energy_type=solar state=TX. Параметры: energy_type - одно из "solar" | "wind" | "combined" (пропустите, чтобы получить все); state - двухбуквенный код штата США (например TX, VA, AZ); lat+lon (необязательно) - для ближайших проектов в радиусе 50 миль. Возвращает: {capacity_mw_total, by_fuel: {solar_utility, solar_rooftop, wind_onshore, wind_offshore}, capacity_factor_pct, top_projects[{name, mw, operator, cod}], state_rps_target_pct, source: "EIA-860 + state RPS"}. НЕ используйте для текущей генерации в сети (для этого get_grid_data) или за пределами США (для EU/UK/AU/TW - get_grid_scoreboard). Укажите state или lat/lon (десятичные градусы); energy_type сужает выборку. Пусто = установок там нет: расширьте до штата.

Применяется всякий раз, когда пользователь спрашивает, где вывод из эксплуатации электростанций освобождает мощность сети. Сканирует запланированные в EIA-860M выводы из эксплуатации генераторов, чтобы найти ближайший резерв пропускной способности передающей сети - выводящаяся из эксплуатации станция даёт КОНКРЕТНОЕ событие появления резерва (её POI освобождает мощность на выдачу), по ПОДАННЫМ данным, а не по прогнозам. Возвращает _entity=retirement_headroom_results: выводящиеся из эксплуатации генераторы внутри вашего горизонта (name, MW, fuel, prime mover, retirement_date), representative_point, ближайшие подстанции с distance_km + count в пределах 25 км, queue_pressure на уровне округа (конкурирующие МВт по заявкам в процессе), iso_context (собственный код балансирующей зоны EIA для этого генератора) и предзаполненный site_evaluation_handoff (аргументы analyze_site + get_water_risk, capacity_mw = ВАША целевая нагрузка). Отвечает на вопросы «где вот-вот освободится мощность сети», «какие выводящиеся из эксплуатации станции открывают резерв на выдачу мощности рядом со мной». Попробуйте: get_retirement_headroom target_mw=50 horizon_months=18 region_iso=MISO - «50 МВт освобождается рядом с подстанцией в течение 18 месяцев, в обход мега-очереди на 4-7 лет». Честность: meta.caveat предупреждает, что поданные даты могут быть пересмотрены на проверках надёжности ISO (продления RMR). Используйте, чтобы найти, ГДЕ мощность освободится следующей; для того, что уже стоит в очереди, используйте get_refined_queue; для одной площадки - analyze_site.

Получает сохранённый шортлист (Фаза 5). При refresh=true (по умолчанию) каждый сайт ПЕРЕОЦЕНИВАЕТСЯ по текущей национальной базовой линии процентилей и возвращает saved_score, current_score и score_delta_since_saved - так видно, просел ли сайт потому, что изменился ОН, или потому, что изменилась СОВОКУПНОСТЬ. Надёжный способ вести кампанию по подбору площадок на протяжении дней и недель. Привязано к вашему API-ключу.

Подводные (морские) кабельные выходы на берег рядом с координатой или глобальный каталог кабелей. Физический интернет, пересекающий океан, выходит на берег в конечном числе точек, и расстояние до такой точки - реальный фактор при выборе площадки для всего, что чувствительно к задержкам или транзиту. Передайте lat+lon (+radius_km) для ТОЧЕК ВЫХОДА НА БЕРЕГ рядом с площадкой - каждая с name, coordinates и distance_km. Опустите координаты, чтобы получить КАТАЛОГ отслеживаемых кабелей (712 отслеживается; каждый с cable_id, name, owners, length_km, rfs_year, is_planned - пустые поля равны null, а не догадкам). ★ ПРОЧТИТЕ field_coverage И connectivity_note ПРЕЖДЕ ЧЕМ ДЕЛАТЬ ВЫВОД: cable_count для точки выхода на берег НЕ заполняется - при загрузке столбец записывается, но вышестоящий фид TeleGeography не поставляет то, из чего он выводится, поэтому в каждой строке стоит значение по умолчанию 0. Вот почему connectivity_grade возвращается как null, а не как оценка: близость к точке выхода на берег НЕ устанавливает, сколько кабелей от неё достижимо, и DC Hub не станет выводить оценку, для которой не может найти источник. Фильтр по cable_count не вернёт ничего по той же причине. Считайте 0 как НЕИЗВЕСТНО, никогда как «кабелей нет». Отвечает на вопросы «какие подводные кабели выходят на берег рядом с этой площадкой в Вирджинии» и «как далеко ближайший выход подводного кабеля от моего кампуса». Попробуйте: get_subsea_cables lat=36.85 lon=-75.98 radius_km=200 - или get_subsea_cables (без аргументов) для каталога. НЕ используйте для наземных волоконных маршрутов (get_fiber_intel), вердикта по волокну для участка (get_fiber_readiness), плотности городского волокна (get_metro_fiber) или плотности интернет-обменов / пиринга (get_peering_intel).

Используется, когда пользователь спрашивает «какие налоговые льготы даёт <штат> дата-центрам?» - это пакеты налоговых льгот для дата-центров по штатам США, от которых зависит, куда пойдут капзатраты. Пример: «Какие льготы по налогу с продаж и налогу на имущество предлагает Вирджиния дата-центру на 100MW?» - get_tax_incentives state=VA. Параметры: state (двухбуквенный код штата США; обязательный). Возвращает: {state, programs:[{name, type (sales-tax-exemption | property-tax-abatement | income-tax-credit | electricity-tax-discount), value, eligibility_mw, eligibility_jobs, min_investment_usd, expiration_date, source_statute}]}. Ссылайтесь на статут с указанием атрибуции DC Hub (CC-BY-4.0). НЕ используйте для сводной оценки площадки по нескольким факторам (электросеть+оптоволокно+вода+налоги+климат - используйте analyze_site) или для ранжирования рынков по стоимости (используйте rank_markets criteria=cheapest_power); здесь рассматривается только фактор НАЛОГОВ для одного штата США. state - код штата США (например, VA); пропустите, чтобы получить обзор по всем 50 штатам. Для деталей по программам нужен платный ключ (human_url).

Используется, когда пользователь спрашивает о водном стрессе или риске с охлаждающей водой на площадке. ПРОВЕРКА НА ВХОДЕ: если нужен ВЕРДИКТ ПО ПЛОЩАДКЕ, охватывающий электросеть + оптоволокно + воду + налоги + климат, вызывай execute_plan(intent="<вопрос пользователя, без изменений>"), а не собирай вручную цепочку из этого инструмента и его собратьев. Если нужен только фактор ВОДЫ, get_water_risk - ЭТО И ЕСТЬ нужный вызов: один запрос, бесплатный тариф, без накладных расходов на планировщик. Применяется при оценке площадки в США на устойчивость охлаждающей воды: фактор водного риска, по которому инженеры, выбирающие площадки, отсеивают варианты, прежде чем остановиться на испарительном охлаждении. Пример: "Ограничен ли этот участок в Phoenix по воде для проекта на 100 МВт?" - get_water_risk lat=33.45 lon=-112.07 (или get_water_risk state=AZ, или location="phoenix"). Параметры: ОДИН из lat+lon (-90..90 / -180..180), state (2-буквенный код США) или location (название или slug рынка DC Hub, разрешаемый в ОПУБЛИКОВАННЫЙ ЦЕНТРОИД этого рынка с блоком resolved_from, который об этом сообщает; это данные на уровне рынка, а не твоего участка, и завершающий код штата не отбрасывается); lat/lon даёт самые точные данные. Возвращает: {water_stress_score (0-100, больше=хуже), drought_category (D0-D4), outlook_12mo, cooling_water_assessment, source}. Привязан к USGS water-stress + US Drought Monitor. Бесплатный тариф. НЕ используй для близлежащей физической инфраструктуры (используй get_infrastructure) или для комбинированного многофакторного вердикта по площадке, охватывающего электросеть+оптоволокно+воду+налоги+климат (используй analyze_site); этот инструмент охватывает только фактор ВОДЫ. Только США: укажи штат или lat/lon (десятичные градусы). Бесплатно = последняя неделя; для более длинной истории нужен платный ключ.

Опережающий радар «где появляется следующая энергосеть, подходящая для гиперскейла». Возвращает рынки США + ISO с самым сильным сигналом скорого появления (вердикт BUILD + запас избыточной мощности + короткий срок до подачи мощности), сводку по ISO и таблицу лидеров по запасу мощности в энергосети. С платным ключом также тезис о переходе: какой ISO открывается и почему. Прогнозный противовес ретроспективным отчётам «куда пришла мощность». Отвечает на вопросы «куда смотреть дальше», «какой рынок вот-вот станет пригодным для строительства». Попробуйте: grid_transition_radar max_months=24. НЕ используйте для текущего снимка очереди ISO (используйте get_interconnection_queue) или ранжирования рынков на сегодня (используйте rank_markets); это опережающий радар появления.

Hyperscaler AI Deal Tracker: живая лента сделок Stargate, OpenAI, Anthropic, Microsoft, Oracle, CoreWeave, AMD, NVIDIA, sovereign-AI. Получает из новостного пайплайна dchub, извлекает $-суммы + MW через regex, классифицирует по актору. Обновление каждые 10 минут. Используйте для отслеживания событий AI capex ($1B+/неделю обычно), анонсов мощностей и конкурентной разведки. НЕ используйте для полного исторического набора сравнимых M&A сделок (используйте list_transactions) или для разбора отдельной сделки с контекстом энергосети (используйте deal_autopsy); это живая лента AI-capex на $1B+. Лимит 1-500. Только аренда и покупки Hyperscaler; для всех M&A используйте list_transactions.

НУЖЕН КЛЮЧ (бесплатно): сохранённые сайты привязаны к аккаунту, поэтому вызов без ключа возвращает auth_required, а не пустой список. Если у вас нет ключа, СНАЧАЛА вызывается claim_free_key (один шаг, без email), затем этот. Использует, когда пользователь просит посмотреть или просмотреть свой сохранённый шортлист DC Hub в чате, или хочет узнать, что на нём изменилось. Пример: "Какие сайты я сохранил?" / "Сдвинулся ли какой-нибудь из моих сохранённых сайтов?": list_saved_sites. Параметры: since (необязательный: "24h"/"7d"/ISO, по умолчанию 7d, окно дельты). Возвращает: каждый сохранённый сайт с названием, рынком, широтой/долготой, сохранённой оценкой DCPI, целевой мощностью в МВт, заметками. ПЛЮС живые дельты: verdict_was/verdict_now (например, CAUTION → BUILD), изменение избыточной мощности за окно, текущий DCPI против DCPI на момент сохранения, оповещения взведены/сработали, новые объекты поблизости, и сводка portfolio, отмечающая, какие сайты сдвинулись, а у каких не взведено оповещение. НЕ использует для добавления сайта (для этого есть save_site) или для скачивания списка в виде файла (для этого есть export_dataset); это чтение в чате.

Перечисляет standing intents, зарегистрированные на вашем ключе: webhook-наблюдения, а также ваши требования capacity (kind "capacity", intent_id cap_...). Только чтение. Возвращает каждый intent_id, kind, параметры watch, webhook_url и состояние enabled; элементы capacity также содержат status, confirmed, expires_at, last_alert_at и matching_now. Помогает найти intent_id для delete_standing_intent или подтвердить, что регистрация прошла. Требует ключ (или OAuth-подключение для элементов capacity). Отвечает на вопрос «что я сейчас отслеживаю». НЕ используйте для создания наблюдения (register_standing_intent) или для разовых чтений (get_news / list_transactions).

Сделки M&A и капитальные транзакции в секторе дата-центров: более 1 700 отслеживаемых сделок (2019 — настоящее время), по каждой указана раскрытая сумма, если она публична (многие частные сделки не раскрываются). Возвращает название сделки, покупателя, продавца, сумму, дату, рынок, целевого оператора, тип (acquisition/JV/refinance/recap). Фильтрует по диапазону дат (date_from/date_to, ISO-8601), min_value_usd, региону, покупателю или продавцу. Отвечает на вопросы «какие сделки по дата-центрам закрылись в этом году», «сколько стоила та покупка». Пример: list_transactions date_from=2026-01-01 min_value_usd=1000000000. Параметра year нет - используйте date_from/date_to. Широкий поток M&A и капитальных сделок с фильтрами; НЕ используйте для аренды/PPA/JV конкретных гиперскейлеров (для этого есть hyperscaler_deals) или разбора отдельной сделки (для этого есть deal_autopsy). limit 1-500 (бесплатно 10), offset 0-100000; total_count - полное число совпадений. Пустой результат = ослабьте фильтры по покупателю/продавцу/сумме.

Планирует N разнесённых, проложенных вдоль дорог вводных оптоволоконных маршрутов от потенциальной площадки дата-центра до carrier hotel / POP, с ориентировочной стоимостью строительства и оценкой разнесённости маршрутов. Отвечает на вопрос: «Могу ли я получить N разнесённых оптоволоконных маршрутов до этой площадки, какова их длина, сколько это стоит и где они используют общий коридор?». Пример: plan_fiber_leadin from="250 Paringa Road, Murarrie QLD" to="20 Wharf Street, Brisbane City QLD" n=4. Параметры: from (широта,долгота ИЛИ почтовый адрес), to (широта,долгота ИЛИ адрес - например, NextDC/Equinix POP), n (1-6 маршрутов, по умолчанию 4), fibre ("720F"|"1440F"), bore_m (длина прокола под рекой/железной дорогой в метрах, необязательно). Возвращает для каждого маршрута length_km + геометрию GeoJSON, total_route_km, diversity {min_separation_m_midhaul, shared_street_km} и ориентировочную стоимость {capex_usd, opex_usd_yr}. ОРИЕНТИРОВОЧНЫЕ автоматически проложенные дорожные коридоры - НЕ инженерные трассы; требуют геодезической съёмки, DBYD и подтверждения оператора. НЕ используйте для оценки пригодности одной площадки (используйте analyze_site) или для зон покрытия оптоволоконных провайдеров (используйте get_fiber_intel).

ТОЛЬКО ПРОСМОТР - возвращает план, НЕ выполняя его. Для настоящего многошагового вопроса к DC Hub вызывайте execute_plan(intent="..."): он использует ТОТ ЖЕ детерминированный планировщик без LLM, а затем ЗАПУСКАЕТ последовательность на стороне сервера и возвращает ответы в одном конверте. К plan_query обращайтесь только чтобы просмотреть, залогировать, сравнить или проверить план перед тем, как выполнить его самостоятельно. Детерминированная маршрутизация по ключевым словам по реестру инструментов: без LLM, без сети, один и тот же интент всегда даёт один и тот же план (бесплатно). Возвращает _entity=query_plan {best_tool, intent_confidence + workflow_confidence (двойная 0-1: чтение вопроса против выполнимости), reason, planner_rationale, recommended_sequence:[{step, tool, depends_on, estimated_calls, why, args_hint}], execution_waves (шаги, сгруппированные в волны параллелизма), execution_strategy.parallel_groups, execution_estimate {estimated_calls, estimated_latency_ms, parallelizable}, alternatives (каждая с when + rejected_because), coverage_notes, matched_classes} плюс версионированный replay (schema_version 1): planner_version, decisions:[{id, step, kind, status, decision, rationale, decision_confidence, depends_on}], rejected:[{id, tool, reason}], execution_graph:{waves, parallel_groups} - поддающийся аудиту и машиночитаемый, его можно безопасно логировать и сравнивать между версиями. Значения args_hint в <угловых скобках> берутся из указанного ранее шага - подставляйте их, но никогда не выдумывайте. Передавайте структурированные подсказки через context (lat/lon, iso, market, capacity_mw, candidate_id, state, since), чтобы уточнить план. Для обзора на уровне семейства используйте discover_tools. Этот инструмент планирует и никогда не выполняет; tools/list остаётся каноническим источником схем. Возвращает упорядоченный план инструментов для интента, не запуская его; выполняйте шаги сами или используйте execute_plan.

Прогнозирует краткосрочную траекторию рынка DCPI (на следующие 1-8 кварталов). Проецирует excess_power_score и constraint_score вперёд с доверительными интервалами, которые РАСШИРЯЮТСЯ с ростом горизонта, по истории ежедневных снимков DCPI от DC Hub - единственного источника, который на это способен, потому что владеет временным рядом. Применяется, чтобы ответить на вопросы «этот рынок движется к BUILD или к AVOID?» или «останется ли энергетика Далласа напряжённой ближайшие 6 месяцев?». Параметры: market_slug (обязательный, слаг метро, например dallas, phoenix, northern-virginia - допустимые слаги берутся из rank_markets / get_market_dcpi_rank); horizon_quarters (необязательный, 1-8, по умолчанию 4; 2 = примерно 6 месяцев вперёд). Возвращает {market_slug, method, basis{history_points, history_span_days, slope_per_day, trend}, horizon_quarters, projection[{quarter_out, excess_power_score, excess_power_band, constraint_score, constraint_band}], caveat, snapshot_record}. ЧЕСТНО: экстраполяция линейного тренда, НЕ гарантия - интервалы расширяются с ростом горизонта и при короткой истории; нужны минимум 3 ежедневных снимка, иначе инструмент отказывается работать. НЕ используйте для разовой оценки на конкретный момент (для этого get_market_dcpi_rank) и для ранжирования множества рынков (для этого rank_markets).

Используйте этот инструмент, когда пользователь спрашивает, где дата-центр может взять питание из сети, как быстро, или стоит ли считать рынок BUILD, CAUTION или AVOID (например, «Где дата-центр на 100 МВт быстрее всего получит питание?»): DCPI ежедневно оценивает более 300 рынков по Excess Power и Grid Constraint, CC BY 4.0. Для ранжированного списка по вопросам питания вызывайте с criteria="ai_ready". Вызывайте, когда пользователю нужен ранжированный список рынков дата-центров: top N по cheapest_power, most_capacity, most_operators, fastest_growing, best_overall или ai_ready (куда может лечь новая AI-нагрузка, по версии DCPI). Фильтруйте по region, min_capacity_mw. Возвращает ранжированные строки со score, MW и slug для последующих запросов; score - это значение сортировки, а не шкала 0-100, и score_basis говорит, что это за величина (ai_ready его опускает и объясняет свой композит в methodology). Без ключа: урезанный предпросмотр; бесплатный ключ даёт несколько полных списков в день. Пример: "Top 10 US markets, ai_ready." Возвращает slug'и рынков для передачи в get_market_intel и get_market_dcpi_rank. limit 1-500; задайте projection=identity_only, чтобы сэкономить токены.

Детерминированное ранжирование/оптимизация нескольких площадок при ограничениях - контракт нормализации, который позволяет сравнивать площадки между отдельными вызовами analyze_site, НЕ переходя к коду. Принимает кандидатов, которых вы уже обогатили (каждый - объект с lat/lng + поля метрик вроде risk_resilience, water_stress, fiber_km - их нужно брать из analyze_site + get_refined_queue и передавать site_evaluation_handoff без изменений), жёсткие ограничения и взвешенные цели; возвращает entity=ranked_sites: top_k с полями rank, objective_score, нормализованными по полям normalized{} (0-100 относительно набора) и normalization_basis. objectives используют ЗНАКОВЫЕ веса: +weight максимизирует поле (например, risk_resilience:1), -weight минимизирует его (например, water_stress:-0.6, fiber_km:-0.4). constraints - жёсткие фильтры, fail-closed при отсутствующем поле. Используется для «выбора лучших N площадок при ограничениях»; для одной площадки используется analyze_site; чтобы сначала получить набор кандидатов, используется get_refined_queue. МЕХАНИКА ОЦЕНКИ (2026-07-11): кандидат, у которого отсутствует валидированная цель, ПЕРЕНОРМИРУЕТСЯ по весам целей, которые у него есть, а пробел ОБЪЯВЛЯЕТСЯ в missing_objectives (никогда не оценивается молча как 0); кандидат, у которого нет ни одной, получает null и занимает последнее место. Поля с percentile=true без базовой популяции переходят на ОТНОСИТЕЛЬНУЮ оценку внутри пакета (базис сообщается по каждой цели в objective_status). КОНТРАКТ КАНДИДАТА: кандидаты могут быть записями {candidate_id: "cand…"} из get_refined_queue - замороженная идентичность (lat/lng/capacity_mw/fiber_km/iso) загружается из mint, ваши метрики накладываются на остальное; просроченные/неизвестные id отбрасываются И объявляются в candidate_contract, никогда не переразрешаются.

ТОЛЬКО ДЛЯ ПАРТНЁРСКОГО КЛЮЧА: читает заметки, которые DC Hub оставил для партнёрского агента, ключ которого отправляет эта сессия - до 20 непрочитанных, сначала самые новые, помечаются прочитанными при доставке (peek=true читает без пометки). Вызывайте его в начале сессии. Проксирует GET /api/v1/inbox с собственным ключом сессии: без ключа отвечает key required; ключ, выпущенный без партнёрского slug, отвечает partner key required (403). Не инструмент данных: не возвращает рыночных, энергетических, оптоволоконных показателей или показателей по выбору площадки.

Восстанавливает ПОТЕРЯННЫЙ ключ DC Hub. Передаёт email вашего пользователя, и DC Hub повторно отправляет любой ключ, привязанный к этому адресу, на этот ящик. Он НИКОГДА не возвращает ключ по сети (отправляет его на привязанный адрес), и подтверждение одинаковое независимо от того, существует ключ или нет (устойчиво к перебору), поэтому ключ не утекает к вызывающей стороне. Используется, когда у вашего пользователя был ключ, он его потерял и знает email, к которому привязал его. Параметр: email (обязательный). Возвращает нейтральное подтверждение DC Hub.

Регистрирует ПОСТОЯННЫЙ ЗАПРОС (STANDING QUERY) с push-уведомлениями через webhook: DC Hub шлёт POST с webhook, подписанным HMAC, на ВАШ https-адрес, как только появляются новые совпадения (push, а не опрос: «уведоми мой оркестратор о любой новой сделке в Columbus»). Требует ключ. Параметры: kind («new_deal_in_market» следит за сделками в параметре market · «news_keyword» следит за новостями, совпадающими с q · «permitting_change» следит за опубликованными данными о разрешениях, опционально по штату), market / q / state (параметр наблюдения для выбранного kind), webhook_url (ваш публичный HTTPS-эндпоинт, приватные и внутренние хосты отклоняются). Возвращает {intent_id, secret}. СОХРАНИТЕ secret: каждая доставка несёт заголовок X-DCHub-Signature: sha256=HMAC(secret, body). Первый прогон молча инициализирует watermark; рост запускает webhook; 5 неудачных доставок подряд автоматически отключают intent. Проверяется примерно каждые 2 часа. Отвечает на запросы «уведомляй мою систему, когда появляется новый мораторий», «присылай мне новые совпадения вместо того, чтобы заставлять меня опрашивать», «скажи моему оркестратору, когда сделка появится в Columbus». Пример: register_standing_intent kind=news_keyword q=moratorium webhook_url=https://hooks.example.com/dchub. kind="capacity" вместо этого регистрирует постоянную ПОТРЕБНОСТЬ В МОЩНОСТЯХ (CAPACITY REQUIREMENT) в DC Hub Capacity Source (без webhook_url): target_mw или target_kw, markets / states / regions / countries (через запятую), опциональный available_by (YYYY-MM или YYYY-MM-DD), delivery_type, min_chunk_kw, max_sites (1-6), use_case, notes, плюс имя и компанию вашего человека и accept_terms=true, но только после того, как он согласился с https://dchub.cloud/listings#terms. Нужен ключ с привязанной почтой вашего человека (claim_free_key, затем bind_email) или OAuth-подключение. Возвращает intent_id cap_<id>; DC Hub отправляет письмо со ссылкой для подтверждения, а затем присылает подходящие листинги не чаще раза в день. НЕ используйте для разовых чтений (get_news / list_transactions), разового поиска мощностей (source_capacity) или email-оповещений по рынку (set_market_alert).

ТОЛЬКО ДЛЯ ПАРТНЁРСКОГО КЛЮЧА: регистрирует то, что вы заметили на поверхности DC Hub, как brain finding (детектор external_audit), чтобы его разобрали так же, как находки любого другого детектора. class принимает одно из значений: completeness_contradiction, geography_leak, as_of_cite_as, pro_wall_dead_end, count_drift, stale_payload_complete, leak_past_pro_gate, link_hygiene, other; tool указывает имя инструмента или эндпоинта DC Hub; quoted_fields содержит точные поля, которые вы видели (хешируется для дедупликации: то же наблюдение, отправленное повторно в течение 24 ч, увеличивает recurrence, а не создаёт новую запись). Проксирует POST /api/v1/inbox/findings с собственным ключом сессии; ключ, выданный без partner slug, отвечает partner key required (403). 120 на ключ в день.

Использует, когда ваш пользователь хочет получить мощность по листингу Capacity Source (передайте slug) или хочет первым получить доступ к мощности, подходящей под требование, по мере подключения листингов (опустите slug; передайте capacity_mw или capacity_kw, markets, states, regions или countries, и timeline). Регистрирует сделку: DC Hub записывает запрос в свой реестр лидов и отправляет провайдеру ТОЛЬКО название компании вашего пользователя и требование. Провайдер принимает или отклоняет. Только если провайдер принимает, DC Hub передаёт вашему пользователю личность провайдера, сведения о площадке и контакты, а провайдеру - имя, роль и email вашего пользователя; при отказе ничего не передаётся. Требует идентифицированного вызывающего (claim_free_key, затем bind_email с адресом вашего пользователя) и accept_terms=true, причём только после того, как ваш пользователь прочитал и принял условия знакомства на https://dchub.cloud/listings#terms. Возвращает lead_id, status и следующий шаг. Для листинга source_capacity с его slug затем показывает статус сделки в блоке раскрытия информации, а после того как провайдер принимает, - личность провайдера, площадку и контакты. НЕ используйте для сохранения или мониторинга площадки (используйте save_site / set_site_alert).

Заказывает АСИНХРОННОЕ исследовательское досье СО ССЫЛКАМИ из корпусов DC Hub (новости, сделки, объекты, аналитические разборы рынка + компоненты живого рынка): аналитическая справка, готовая к принятию решений, с [n] ссылками, а не поиск. Требует ключ (один вызов claim_free_key), 5 досье в день. Отправляет вопрос, ждёт завершения до ~35 с и, когда досье готово, возвращает его прямо в ответе; если задача ещё выполняется, возвращает {task_id} - вызовите research_task task_id=<id>, чтобы получить его. Параметры: question (обязателен для нового досье, минимум 12 символов) ИЛИ task_id (опрос ранее запущенного). Обычно завершается меньше чем за минуту. Отвечает на запросы «напиши справку со ссылками по этой теме», «что говорят недавние сделки о gas-bridged power». Попробуйте: research_task question="What do recent deals say about gas-bridged power for data centers in ERCOT?". НЕ используйте для одного факта (для этого search_intelligence / semantic_search); здесь данные синтезируются ПО источникам со ссылками.

ТРЕБУЕТСЯ КЛЮЧ (бесплатно): этот инструмент ПИШЕТ в ваш аккаунт, поэтому вызов без ключа вернёт auth_required. Если ключа нет, СНАЧАЛА вызовите claim_free_key (один шаг, без email). Сохраняет кандидатный участок под дата-центр в ваш аккаунт DC Hub, чтобы отслеживать его между сессиями. Укажите lat и lon (плюс необязательные name, state, market, target_mw, notes). Возвращает id сохранённого участка. Передайте market, и DC Hub зафиксирует базовый уровень DCPI участка на момент сохранения, так что каждый последующий list_saved_sites / get_changes покажет, как ЕГО оценка и вердикт изменились с момента сохранения. Создаёт постоянный шортлист, к которому агент может вернуться и который может мониторить: после сохранения передайте возвращённый id в set_site_alert, и DC Hub напишет вам на email, когда у этого участка сдвинутся DCPI, ёмкость или объекты рядом (без повторных проверок). Отвечает на запросы «запомни этот участок», «оставь этого кандидата, чтобы вернуться к нему в следующей сессии». Попробуйте: save_site lat=39.04 lon=-77.48 name="Ashburn parcel" market=northern-virginia target_mw=100. НЕ используйте для чтения шортлиста (для этого list_saved_sites), его выгрузки (для этого export_dataset) или оценки участка (для этого score_facility); этот инструмент ПИШЕТ один участок в ваш аккаунт.

Сохраняет площадку в ПОСТОЯННЫЙ именованный шортлист, который сохраняется между разговорами (сохранение состояния фазы 5). Делает снимок objectives площадки и её текущего перцентиля objective_score, чтобы позже пересчитать оценку относительно меняющейся национальной базовой линии. Используйте, чтобы собрать долговечный шортлист площадок на дни и недели; список привязан к вашему API-ключу. Сочетайте с get_shortlist, чтобы пересчитать оценки и увидеть дрейф. МИНИМАЛЬНЫЙ вызов: save_to_shortlist(shortlist_name="my-targets", site={site_ref, lat, lng, capacity_mw}) - objectives необязательны. Если вы ДЕЙСТВИТЕЛЬНО ранжировали площадку (analyze_site / rank_sites), передайте эти поля метрик внутри site и вашу карту objectives, и повторный расчёт оценки использует их. Требует API-ключ, чтобы список был приватным и дожил до следующего разговора: если ключа нет, сначала вызовите claim_free_key.

Применяется, когда пользователю нужна независимая оценка по шкале 0-100 для ОДНОГО существующего объекта по 7 измерениям: power, fiber, water, climate_risk, tax_environment, talent_pool, expansion. Пример: «Как оценивается площадка CoreWeave Las Vegas с приоритетом по энергетике?» - score_facility facility_id=<id> weighting=power_priority. Параметры: facility_id или name (обязательный); weighting принимает одно из значений: «balanced» (по умолчанию) | «power_priority» | «risk_priority» | «expansion_priority». Возвращает: сводную оценку 0-100, tier_classification, сравнение с аналогами и детализацию по каждому измерению. НЕ используйте для сырого участка с координатами lat/lon (используйте analyze_site), для сравнения 2 или более площадок (используйте compare_sites) или для поиска похожих площадок (используйте find_alternatives).

Ищет в DC Hub релевантные записи (формат коннектора OpenAI Deep Research / ChatGPT). Возвращает список соответствующих объектов дата-центров в виде {id, title, url}; передайте id инструменту fetch для записи или откройте url, чтобы сослаться на живую страницу объекта. Для структурированных запросов (по MW, оператору, статусу, рынку) используйте search_facilities напрямую.

Используйте этот инструмент, когда пользователь спрашивает, какие дата-центры существуют или кто работает в городе, штате или стране. Вызывайте, когда пользователю нужны существующие дата-центры, подходящие под фильтры: страна, штат, город, оператор, диапазон MW, tier или текст. Возвращает название, оператора, местоположение, рынок, статус и MW, если они указаны; каждая строка помечена как verified или unverified_directory_listing. Бесплатно: названия и местоположения; для MW и характеристик нужен платный ключ. Пример: "Equinix sites in Virginia over 10 MW." Начните здесь, чтобы получить slug объекта. Нет совпадений = пустые данные, ошибки нет: расширьте фильтры. limit 1-500 (на бесплатном тарифе 25); пагинация через offset.

Выполняет семантический (смысловой) поиск по актуальному корпусу разведданных DC Hub: отраслевые новости, сделки M&A, обнаруженные объекты, нарративы DCPI по рынкам, пресс-релизы, анонсы, данные о permitting, строительные разрешения, налоговые льготы и конвейер мощностей, возвращая наиболее релевантные записи с полями источников, на которые можно ссылаться. Это удобный для агентов алиас для ТОГО ЖЕ слоя извлечения, что и semantic_search: те же результаты, другая форма вызова. Принимает query и короткие имена корпусов (news | deals | facilities | market_narratives | press | announcements | permitting | permits | incentives | pipeline); semantic_search принимает q и полные имена корпусов. Необходимо вызвать ОДИН из них, а не оба. Параметры: query (обязательный, естественный язык); corpus (необязательный CSV-список имён выше, по умолчанию все); limit (1-15, по умолчанию 8). ПОВЕДЕНИЕ: только чтение - ничего не записывает, и повторные вызовы с теми же аргументами возвращают те же записи. ДОСТУП: работает без ключа, но анонимные результаты возвращаются как УРЕЗАННЫЙ ПРЕДПРОСМОТР; сессионный X-API-Key предоставляет полную глубину для каждого ключа, а бесплатный уровень имеет дневной лимит (вызовите claim_free_key один раз - без email - если у вас нет ключа). НЕ используйте, когда можно отфильтровать точно: search_facilities для структурированных фильтров объектов, get_news для новостей по дате/ключевому слову, list_transactions для фильтров сделок - те сопоставляют поля и возвращают полные наборы, тогда как этот ранжирует по смыслу и возвращает top-N.

Использует для КОНЦЕПТУАЛЬНЫХ / нечётких вопросов, где фильтры по ключевым словам не справляются: семантический (по смыслу) поиск по отраслевым новостям DC Hub, сделкам M&A, глобальной карте объектов, углублённым обзорам DCPI по рынкам, пресс-релизам, анонсам, данным о разрешениях, разрешениям на строительство, налоговым льготам и портфелю мощностей, ранжированный по релевантности с цитируемыми полями источника (url/заголовок новости, стороны/сумма сделки, название/расположение объекта, рынок/url обзора). Примеры: «что происходит с газом за счётчиком для ИИ-дата-центров?», «сделки с участием атомной энергетики для гиперскейлеров», «почему в Northern Virginia ограничения?» - semantic_search q="газ за счётчиком для ИИ-дата-центров". Параметры: q (обязательный, запрос на естественном языке); corpus (необязательный CSV-поднабор из news_articles, deals, facilities, market_narratives, press_releases, announcements, permitting_intel, construction_permits, tax_incentives, capacity_pipeline; по умолчанию все); k (1-15, по умолчанию 8). Возвращает {results:[{source_table, kind, text, score, cite:{…}}]}; score - релевантность от 0 до 1, а не оценка DCPI. Дополняет инструменты точной фильтрации (get_news / list_transactions / search_facilities) ранжированием по релевантности; для полного обзора рынка с учётом бюджета токенов используйте get_market_context. Ссылайтесь на «DC Hub (dchub.cloud)».

Подписывает на оповещения о движении для рынка DCPI (БЕСПЛАТНО с ключом): приходит уведомление, когда меняется его оценка Excess-Power / Constraint. На бесплатном тарифе письма уходят на email, который ваш человек привязал через bind_email (сначала вызовите bind_email; адрес назначения принудительно берётся оттуда). Укажите channel="email". Доставка через webhook (channel="webhook" + destination=<https URL>) требует платного тарифа DC Hub. Даёт агенту возможность СЛЕДИТЬ за рынками, а не только запрашивать их. Отвечает на запросы «скажи, когда этот рынок сдвинется», «пингни меня, если изменится оценка мощности Northern Virginia». Пример: set_market_alert market=northern-virginia channel=webhook destination=https://hooks.example.com/dc. НЕ используйте, чтобы посмотреть состояние рынка прямо сейчас (для этого get_market_dcpi_rank); этот инструмент ПОДПИСЫВАЕТ на будущие изменения.

Устанавливает DRIFT ALERT на сохранённом шортлисте, чтобы вы могли перестать опрашивать и получать уведомления, когда позиция сайта в национальном рейтинге существенно меняется (Фаза 5). Срабатывает, когда текущий процентильный балл любого сайта из шортлиста < percentile_below ИЛИ score_delta_since_saved < delta_below (например, -8 = упал на 8 пунктов по сравнению с моментом сохранения). Оценивается после каждого ежедневного обновления базовой линии; доставляется через webhook и/или email. Это цикл "разбуди меня, когда это важно" для долгосрочных кампаний по выбору площадок. Привязано к вашему API-ключу.

Ставит email-слежение на сайт, который вы уже сохранили (БЕСПЛАТНО с ключом) - DC Hub присылает письмо, когда меняется DCPI-оценка сайта, ёмкость сети или объекты рядом, так что вам не придётся проверять всё снова и снова. На бесплатном тарифе уведомление уходит на привязанную почту вашего человека (сначала вызовите bind_email; notify_email принудительно подставляется этот адрес). Платный тариф DC Hub может отправлять на любой адрес. Цикл «следи за моим списком»: сначала вызовите save_site (он возвращает saved_site_id), затем set_site_alert по этому id. Параметры: saved_site_id (обязательное целое, из save_site или list_saved_sites), trigger_type ("dcpi_change" | "capacity_change" | "new_facility_nearby", по умолчанию "dcpi_change"), threshold (число - сдвиг в баллах/MW, который запускает уведомление, по умолчанию 5), notify_email (обязательный - адрес, на который отправляется уведомление). Отвечает на «дай знать, если что-то изменится на сайте, который я сохранил». Попробуйте: set_site_alert saved_site_id=12 trigger_type=dcpi_change threshold=5 notify_email=you@firm.com. Возвращает {ok, alert_id, message}. НЕ используйте для слежения за целым РЫНКОМ (для этого set_market_alert) или для сохранения нового сайта (для этого save_site); этот инструмент ставит монитор на ОДИН уже сохранённый сайт.

Контрфактический WHAT-IF пересчёт 300+ рынков электроэнергии DC Hub по ВАШИМ явно заданным дельтам - отвечает на вопрос «что станет с рейтингом рынка, если условия изменятся» (только DC Hub хранит исходные компоненты). Параметры (все необязательные, передайте хотя бы одну дельту): avg_kwh_cents_pct (изменение цены на электроэнергию в %, например 30), time_to_power_months_delta (прибавленные или убранные месяцы), queue_wait_months_delta, reserve_margin_pct_delta (пункты), curtailment_pct_delta (пункты), market (один слаг, например abilene), top_n (по умолчанию 10, максимум 25 - сортировка по |изменению score|). Возвращает по каждому рынку базовый и сценарный композит + разбивку по компонентам + ТОЧНУЮ формулу и веса в каждом ответе (прозрачный scenario_composite - намеренно НЕ DCPI). Вызовы без ключа получают превью топ-3; любой действующий ключ (claim_free_key) возвращает до 25. Отвечает на вопросы «что станет с рейтингом, если цены на электроэнергию подскочат на 30%», «какие рынки выживут при более жёстких темпах строительства». Попробуйте: simulate_scenario avg_kwh_cents_pct=30 top_n=10. НЕ используйте для ранжирования на текущий момент (для этого rank_markets) или экстраполяции траектории (для этого predict_market_trajectory); этот инструмент отвечает на явные гипотетические вопросы.

Пошаговый подбор площадки для дата-центра. Укажите целевой объём мощности, географию и сроки - и получите ранжированный шортлист рынков США (вердикт DCPI, запас свободной мощности, сроки подключения к сети, ISO), а с платным ключом ещё и слой синтеза решений: лучший вариант, обоснование, последовательность строительства и флаги рисков. Один вызов find->rank->shortlist->verdict по Data Center Power Index. Отвечает на вопрос «где строить 100 МВт в Техасе к 2028 году». Попробуйте: site_selection_canvas capacity_mw=100 region=TX max_months=24. НЕ используйте для одного известного участка (берите analyze_site) или для открытого вопроса «где мне строить» (берите get_dchub_recommendation); этот инструмент прогоняет весь поток от поиска до ранжирования, шортлиста и вердикта.

Используется, когда вашему пользователю нужна ЁМКОСТЬ дата-центра для покупки или аренды: ищет в DC Hub Capacity Source по размеру (кВт или МВт) и/или местоположению (регион вроде Северной Америки или Европы, страна, штат или агломерация). Пример: "500 kW anywhere in Europe" → min_kw=500, region=europe. Размер задаётся через min_kw (в кВт) или min_mw (в МВт) и сопоставляется с тем, что листинг РЕАЛЬНО может предоставить, а не с его заявленным общим объёмом: contiguous_kw - это самый большой единый непрерывный блок, доступный на объекте, а min_contract_kw - минимальный кусок, который провайдер готов законтрактовать. Поэтому колокация с большим общим объёмом, но маленьким непрерывным блоком НЕ отвечает крупному запросу, а крупная площадка, готовая контрактовать небольшие куски, отвечает; листинг, где не указано ни то, ни другое, сопоставляется по общему объёму. Местоположение задаётся через region (ключ или алиас региона) или location (свободный текст, который сопоставляется с регионом, страной, штатом и агломерацией каждого листинга); market, state, delivery_type и available_by сужают поиск дальше. В листингах - участки с подведённой мощностью, подготовленные оболочки (powered shells), ёмкость под ключ и колокация для покупки или аренды, для корпоративных закупок и закупок через агентов. Возвращает карточки листингов (market, region, capacity, причём с contiguous_kw и min_contract_kw там, где листинг их указывает, а также status и время последнего обновления каждого листинга) любому вызывающему, плюс применённые фильтры и статус программы (live или upcoming, пока подключаются первые листинги). Передайте slug, чтобы получить один листинг: вошедший в систему человек, принявший условия представления (introduction terms), видит его спецификации (вход в систему означает ключ с привязанным email через claim_free_key, а затем bind_email, либо подключение OAuth; accept_capacity_terms фиксирует принятие при первом разе); остальные получают карточку и шаги для разблокировки. Личность провайдера, площадка и контакты раскрываются только после того, как провайдер примет регистрацию сделки (deal registration), которую отправляет request_capacity_intro, а блок disclosure в листинге показывает, раскрыты ли они уже. Чтобы вместо этого подобрать под целое требование, передайте target_mw или target_kw (опционально min_chunk_kw,…

Подписывает вашего человека на БЕСПЛАТНЫЙ еженедельный дайджест DC Hub «что изменилось на рынках/сайтах, которые вы запрашивали» (движения DCPI, новые объекты, новые сделки и новости) - ОДИН вызов, толчок, который возвращает вашего агента, когда данные меняются. ДВОЙНОЙ opt-in + безопасность согласия: мы отправляем по электронной почте ссылку ПОДТВЕРДИТЬ в один клик, человек получает дайджест только после подтверждения, и в каждом письме есть отписка в один клик - этот вызов сам по себе не устанавливает маркетинговый флаг. Вызывайте только после того, как ваш человек поделится своей электронной почтой и захочет получать еженедельное письмо. Параметры: email (обязательный), source (необязательный тег). Возвращает {ok, sent, message}. Лучше используйте это вместо ручной сборки POST /api/v1/opt-in/request.

Когда сохранённый сайт ДРЕЙФУЕТ (его позиция в национальном рейтинге упала - это выявляет обновление get_shortlist или срабатывание set_shortlist_alert), берите кандидатов на замену из остальной части этого шортлиста, чтобы алерт превращался в действие, а не оставался предупреждением (Фаза 5). Возвращает ДВА уровня - tier_1_same_region (тактическая замена по соседству) и tier_2_cross_region (арбитраж между регионами), - каждый пересчитывается по собственным целям СДРЕЙФОВАВШЕГО слота, ПЛЮС drift_is_systemic: если остальная часть вашего шортлиста тоже просела, падение охватывает весь регион/базовую линию, и замена внутри региона унаследует его (предпочитайте cross_region); если соседи удержались, это индивидуальный случай (tactical_ok). DC Hub выполняет сокращение; итоговый взвешенный выбор за вами. Кандидаты берутся ТОЛЬКО из этого шортлиста (сохраните больше через save_to_shortlist, чтобы расширить пул). Привязано к вашему API-ключу.

Применяется непосредственно перед тем, как ЦИТИРОВАТЬ показатель DC Hub человеку: возвращает одну готовую к вставке строку атрибуции для значения, которое вы собираетесь цитировать, с ПРАВИЛЬНОЙ лицензией для этого слоя. Передаёт то, что вы считали из ответа, который цитируете: subject (что это за показатель), as_of (провенанс as_of), url (profile_url или dcpi_url строки), completeness (флаг completeness) и layer. ★ ЛИЦЕНЗИЯ СВОЯ ДЛЯ КАЖДОГО СЛОЯ, И В ЭТОМ ВСЯ СУТЬ: оценки DCPI, вердикты, пороги диапазонов, методология и собственный анализ сетки/площадки от DC Hub идут под CC-BY-4.0, и их можно цитировать с указанием авторства; инвентарь объектов и сторонние физические слои - СОСТАВНЫЕ данные, исходные условия которых DC Hub не вправе отменить (части - OpenStreetMap, ODbL 1.0, share-alike), поэтому вместо разрешения они несут указатель на https://dchub.cloud/data-sources. Огульная «CC-BY-4.0» на запись об объекте - притязание сверх реальных прав. Возвращает {citation_text, cite_as, license, license_basis, source, url, as_of, as_of_basis, completeness, omitted}. Бесплатно, без ключа, без сетевых вызовов: собирает то, что вы передали, и никогда не подыскивает и не выдумывает значение. Если пропустить as_of, строка скажет RETRIEVED, а не заявит дату данных, и подскажет, какое поле передать в следующий раз. НЕ применяйте для поиска показателя (сначала вызовите инструмент данных); этот инструмент цитирует показатель, который у вас уже есть.

Открывает всю глубину DC Hub. Вызывай его, когда результат пришёл в виде частичного превью (например, «показано 3 из 12 результатов»), инструмент оказался заблокирован или твоему человеку нужен полный набор данных. Возвращает лестницу апгрейдов + готовые к вставке ссылки на оплату, которые твой человек завершает в ОДИН клик. Если в вызове есть API-ключ или сессия MCP, оплата привязывается к ним, и твой следующий же вызов вернёт полные данные (без переподключения); если нет ни того, ни другого, ключ отправят по почте плательщику - в ответе сказано, какой случай сработал, в next_call_full_after_checkout и after_checkout. Платные тарифы: на странице по ссылке human_url. Хочешь вместо этого БЕСПЛАТНЫЙ уровень (без оплаты, превью плюс 2 полных ответа на инструмент в день, 50 в день с почтой)? Вызови claim_free_key. Результат с ограничением доступа уже содержит ссылку в human_url: передай её (первой строкой ответа); этот инструмент возвращает более полную лестницу. Параметр: reason (необязательный - что ты пытался сделать, чтобы твой человек увидел, почему это важно). Возвращает {plans, human_message, what_unlocks}.

Вызывается только когда пользователь спрашивает, как DC Hub сравнивается с другими источниками данных о дата-центрах (DataCenterHawk, DC Byte, DCD, Baxtel…) или почему его стоит использовать. Возвращает отличительные особенности DC Hub, для каждой из которых есть URL доказательства и строка цитирования, а также ссылки на страницы сравнения; competitor= сужает до одного вендора. Бесплатно, ключ не нужен. Не для запросов данных. Пример: "Как DC Hub сравнивается с DC Byte?"