alexpota/cloudscope-mcp

Budget Status

Проверяет статус бюджета: текущие расходы относительно лимита, процент использования, прогноз и риск превышения. Для GCP требуется указать GCP_BILLING_ACCOUNT_ID.

Compare Cost Periods

Сравнивает затраты между двумя диапазонами дат, показывая абсолютные и процентные изменения по каждой услуге.

Detect Cost Anomalies

Сравнивает ежедневные расходы за последние N дней с предыдущими N днями, чтобы найти всплески затрат. Возвращает список сервисов, в которых расходы выросли выше порогового процента, отсортированный по величине увеличения. Каждая запись включает название сервиса, предыдущую стоимость, текущую стоимость, процентное изменение и абсолютное изменение в USD. Возвращает пустой список, если аномалий не найдено. Используйте этот инструмент, когда пользователь спрашивает о неожиданных увеличениях затрат, сюрпризах в счетах или хочет узнать, не изменилось ли что-то в последнее время.

Find Idle Resources

Находит облачные ресурсы, которые были развёрнуты, но не используются активно: отключённые диски, потерянные сетевые интерфейсы, неиспользуемые IP-адреса, неактивные виртуальные машины и пустые вычислительные планы. Возвращает каждый ресурс с его именем, типом, группой ресурсов/проектом, причиной бездействия и предполагаемой ежемесячной стоимостью в долларах США. Возвращает пустой список, если неактивные ресурсы не найдены. Используйте этот инструмент, когда пользователь спрашивает о напрасно расходуемых, неактивных или неиспользуемых ресурсах, возможностях очистки или хочет найти ресурсы для удаления, чтобы сократить расходы.

Find Untagged Resources

Находит ресурсы, к которым не применены теги или метки. Возвращает каждый ресурс с его именем, типом, группой ресурсов/проектом и расположением. Нетегированные ресурсы невозможно отнести к командам или проектам, что делает распределение затрат и возврат средств невозможным. Возвращает пустой список, если все ресурсы имеют теги. Используйте это, когда пользователь спрашивает о соответствии тегирования, управлении, пробелах в распределении затрат или хочет определить ресурсы, которым нужны теги или метки.

Cost by Tag

Разбивает затраты по конкретному ключу тега или метки, например team, environment или project. Возвращает отсортированную таблицу с каждым значением тега, затратами в долларах США и процентом от общего. Включает строку итога и среднедневное значение. Возвращает ошибку, если диапазон дат некорректен или отсутствуют затраты с тегами. Используйте этот инструмент, когда пользователь спрашивает о затратах по командам, по окружениям, распределении затрат, chargeback или хочет понять расходы по любой пользовательской метке или тегу.

Cost Forecast

Прогнозирует будущие расходы на облако на ближайшие N дней, используя линейный тренд на основе фактических затрат за последние 30 дней. Возвращает даты прогнозируемого периода, прогнозируемую общую стоимость в долларах США, среднюю дневную прогнозируемую стоимость и базу уверенности (количество использованных исторических дней). Используйте это, когда пользователь спрашивает «сколько я потрачу в этом месяце», хочет предсказать предстоящие счета или нуждается в планировании бюджета. Возвращает ошибку, если недостаточно исторических данных.

Cloud Cost Summary

Возвращает разбивку затрат за диапазон дат, сгруппированную по сервису, группе ресурсов, тегу или региону. По умолчанию использует текущий месяц, если даты не указаны. Вывод включает отсортированную таблицу с названием каждой группы, стоимостью в долларах США и процентной долей от общей суммы. Включает итоговую строку, среднедневное значение и сворачивает группы, выходящие за пределы первых 10, в строку "Other". Возвращает ошибку, если диапазон дат некорректен. Используйте этот инструмент, когда пользователь спрашивает «сколько я трачу», «что стоит дороже всего», «покажи мой счёт в облаке» или хочет получить обзор расходов.

Cross-Project Cost Summary

Возвращает сводную разбивку расходов по нескольким проектам GCP, отсортированную по общим затратам. Каждый проект показывает своё название, общую стоимость в USD и процент от общей суммы. Используйте его, когда пользователь спрашивает о расходах по всем проектам GCP, хочет сравнить затраты проектов или нуждается в обзоре расходов по всей организации.

Cross-Subscription Cost Summary

Возвращает сводную разбивку затрат по нескольким подпискам Azure, отсортированную по общим расходам. Каждая подписка показывает своё название, общую стоимость в USD и процент от общей суммы. Корректно обрабатывает частичные сбои — если некоторые подписки недоступны, возвращает результаты по остальным с предупреждением. Используйте этот инструмент, когда пользователь спрашивает о затратах по всем подпискам, хочет сравнить расходы подписок или нуждается в общем обзоре затрат организации.

Current Date

Возвращает сегодняшнюю дату и начало/конец текущего и предыдущего месяцев в формате YYYY-MM-DD

List GCP Projects

Возвращает все проекты GCP, к которым имеют доступ текущие учётные данные, с именем, ID и состоянием. Показывает, какой проект сейчас активен. Используйте это, когда у пользователя есть несколько проектов GCP и он хочет увидеть, какие доступны, или перед вызовом get_cross_project_costs.

Cost Optimization Recommendations

Получает рекомендации по экономии затрат, отфильтрованные по категории. Возвращает список рекомендаций, каждая из которых содержит: название, категорию, уровень влияния (высокий/средний/низкий), оценённую годовую экономию в USD, идентификатор затронутого ресурса и краткое описание предлагаемого действия. Возвращает пустой список, если для выбранной категории нет рекомендаций. Используйте, когда пользователь хочет сократить расходы, найти неэффективные траты или оптимизировать использование ресурсов.

List Azure Subscriptions

Возвращает все подписки Azure, к которым имеют доступ текущие учётные данные, с указанием имени, идентификатора и состояния. Показывает, какая подписка активна в данный момент. Используйте этот инструмент, когда у пользователя есть несколько подписок и он хочет увидеть, какие из них доступны, или подтвердить, какая подписка запрашивается.

Top Spending Resources

Находит N самых дорогих отдельных ресурсов за период времени. В GCP требует экспорта детализированных счетов для данных на уровне ресурсов.