SidneyBissoli/bcb-br-mcp

Ищет серии во внутреннем курируемом каталоге по имени или категории, игнорируя ударения и заглавные буквы (например, 'inflacao' находит 'Inflação'; 'dolar' находит 'Dólar'). Когда использовать: для поиска кода серии по ключевому слову (selic, ipca, cambio, pib, emprego, credito...). Когда НЕ использовать: для вывода всего по категории используйте bcb_series_populares. Ограничение: поиск только по курируемому каталогу (150+ серий), не по полному SGS (десятки тысяч); если ничего не найдено, возвращает подсказки и ссылку на портал SGS. Возвращает: `termo`, `totalEncontradas`, `series` (массив из {codigo, nome, categoria, periodicidade}) и, при пустом результате, `mensagem` и `sugestao`. Локальный каталог: не делает сетевых вызовов.

Сравнивает от 2 до 5 временных рядов в ОДИН И ТОТ ЖЕ период (dataInicial и dataFinal обязательны), вычисляет процентное изменение каждого и упорядочивает их в рейтинге (от большего к меньшему изменению). Когда использовать: для сравнения/сопоставления динамики нескольких показателей рядом. Когда НЕ использовать: для одного ряда используйте bcb_variacao. Возвращает: `periodo`, `totalSeries`, `seriesComDados`, `seriesComErro`, `ranking` (каждый элемент с posicao, codigo, nome, valorInicial, valorFinal, variacaoPercentual, maximo, minimo, media) и `erros`. Отказоустойчивый: ряды без данных за период помещаются в `erros`, не нарушая сравнение. Поведение: использует публичный API SGS Центрального банка Бразилии — без аутентификации, ключа API или регистрации, и без объявленного лимита запросов (использование — best-effort). При временной ошибке или тайм-ауте вызов автоматически повторяется (до 3 попыток, экспоненциальная задержка); если ошибка сохраняется, возвращает `isError: true` с сообщением на португальском (HTTP 404 = ряд не существует или без данных за запрошенный период). Результат возвращается в виде JSON как в тексте, так и в `structuredContent` (согласно outputSchema); даты в формате дд/ММ/гггг и числовые значения (десятичная точка).

Аталка, которая возвращает за один вызов последние значения ключевых индикаторов экономики Бразилии: годовая Selic, месячный IPCA, IPCA накопленный за 12 месяцев, курс доллара PTAX (продажа) и IBC-Br. Не принимает параметров. Когда использовать: для быстрого обзора экономики. Когда НЕ использовать: для любых других рядов, исторических данных или выбора периода — используйте bcb\_serie\_ultimos или bcb\_serie\_valores. Возвращает: `consultadoEm` (временная метка ISO 8601) и `indicadores` (массив с индикатором, кодом, датой, значением — или `erro` в элементе). Отказоустойчивый: каждый индикатор запрашивается независимо, поэтому сбой одного не роняет остальные. Поведение: использует публичный API SGS Центрального банка Бразилии — без аутентификации, ключа API или регистрации и без заявленного лимита запросов (использование best-effort). При временном сбое или тайм-ауте вызов повторяется автоматически (до 3 попыток, экспоненциальная задержка); при сохраняющейся ошибке возвращает `isError: true` с сообщением на португальском (HTTP 404 = ряд не существует или нет данных за запрошенный период). Результат приходит в JSON как в текстовом виде, так и в `structuredContent` (согласно outputSchema); даты в формате dd/MM/yyyy и числовые значения (десятичная точка).

Получает описательные метаданные ОДНОГО временного ряда БЦБ (название, единица измерения, периодичность, источник, категория) без подгрузки значений ряда. Когда использовать: чтобы уточнить, что представляет собой ряд и в каких единицах, перед запросом данных. Когда НЕ использовать: для самих значений используйте bcb_serie_valores или bcb_serie_ultimos. Возвращает: codigo, nome, unidade, periodicidade, fonte, categoria, especial и прямые URL API (urlConsulta, urlUltimos10). Если endpoint метаданных БЦБ не отвечает, делает откат на внутренний каталог или на последнее доступное значение, помечая источник в `observacao`. Поведение: использует публичный API SGS Центрального банка Бразилии — без аутентификации, ключа API или регистрации, без известного лимита запросов (работает по принципу best-effort). При временной ошибке или тайм-ауте вызов автоматически повторяется (до 3 попыток с экспоненциальной задержкой); если ошибка сохраняется, возвращает `isError: true` с сообщением на португальском (HTTP 404 = ряд не существует или нет данных за запрошенный период). Результат приходит в виде JSON как в тексте, так и в `structuredContent` (согласно outputSchema); даты в формате dd/MM/yyyy, числовые значения с десятичной точкой.

Выводит внутренний курируемый каталог из 150+ экономических серий BCB с их кодами, сгруппированных по категориям (Juros, Inflação, Câmbio, Atividade Econômica, Emprego, Fiscal, Setor Externo, Crédito, Agregados Monetários, Poupança, Índices de Mercado, Expectativas); принимает фильтр по категории. Когда использовать: для навигации/обнаружения доступных серий по теме. Когда НЕ использовать: для поиска по ключевому слову используйте `bcb_buscar_serie`; этот инструмент не ищет значения. Возвращает: `totalSeries`, `categorias` (количество категорий) и `series` — объект, сгруппированный по категориям при отсутствии фильтра, или плоский массив при фильтрации по категории; каждый элемент содержит codigo, nome, categoria и periodicidade. Локальный каталог: не выполняет сетевой запрос.

Получает последние N наблюдений ОДНОГО временного ряда BCB (самые свежие первыми, начиная с конца ряда). Когда использовать: чтобы увидеть последние данные без необходимости вычислять даты (например, последние 12 месяцев IPCA). Количество от 1 до 1000 (по умолчанию 10). Когда НЕ использовать: для диапазона дат или полной истории используйте bcb_serie_valores. Возвращает: объект `serie`, `totalRegistros` и `dados` (массив {data, valor}); при отсутствии данных `totalRegistros` = 0 и `observacao`. Поведение: использует публичное API SGS Банка Бразилии — без аутентификации, ключа API или регистрации, и без объявленного лимита запросов (использование best-effort). При временной ошибке или тайм-ауте вызов автоматически повторяется (до 3 попыток, экспоненциальный backoff); при сохранении ошибки возвращает `isError: true` с сообщением на португальском (HTTP 404 = ряд не существует или нет данных за запрошенный период). Результат выдается в формате JSON как в тексте, так и в `structuredContent` (согласно outputSchema); даты в формате dd/MM/yyyy и числовые значения (десятичная точка).

Запрашивает историю значений ОДНОГО временного ряда BCB по коду SGS, опционально ограниченную диапазоном дат (dataInicial/dataFinal). Когда использовать: чтобы получить полную историю ряда или окно конкретных дат. Когда НЕ использовать: для получения только последних точек используйте bcb_serie_ultimos; для процентного изменения — bcb_variacao; для сравнения нескольких рядов — bcb_comparar; если вы не знаете код, сначала найдите его с помощью bcb_buscar_serie или bcb_series_populares. Возвращает: объект `serie` (codigo, nome, categoria, periodicidade), `totalRegistros`, `periodoInicial`, `periodoFinal` и `dados` (массив {data, valor}); когда данных нет, `totalRegistros` = 0 и поясняющее `observacao`. Поведение: использует публичное API SGS Banco Central do Brasil — без аутентификации, API-ключа или регистрации, и без объявленного лимита запросов (использование best-effort). При временном сбое или тайм-ауте вызов автоматически повторяется (до 3 попыток, экспоненциальная задержка); если ошибка сохраняется, возвращает `isError: true` с сообщением на португальском (HTTP 404 = ряд не существует или нет данных за запрошенный период). Результат приходит в виде JSON как в тексте, так и в `structuredContent` (согласно outputSchema); даты в формате dd/MM/yyyy и числовые значения (десятичная точка).

Вычисляет процентное изменение ОДНОГО ряда между первой и последней точкой периода, а также описательные статистики. Период может быть задан датами (dataInicial/dataFinal) ИЛИ последними N периодами (параметр `periodos`, который имеет приоритет и игнорирует даты). Когда использовать: для измерения тренда/изменения одного ряда. Когда НЕ использовать: для сравнения нескольких рядов используйте bcb_comparar; для сырых значений используйте bcb_serie_valores. Требуется минимум 2 наблюдения в периоде (иначе возвращает `isError`). Возвращает: `serie`, `periodo` (dataInicial, dataFinal, totalPeriodos), `analise` (valorInicial, valorFinal, diferencaAbsoluta, variacaoPercentual, variacaoFormatada) и `estatisticas` (maximo, minimo, media, amplitude). Поведение: использует публичный API SGS Центрального банка Бразилии - без аутентификации, ключа API или регистрации, и без объявленного лимита запросов (использование по принципу best-effort). При временном сбое или таймауте вызов автоматически повторяется (до 3 попыток, экспоненциальная задержка); если ошибка сохраняется, возвращает `isError: true` с сообщением на португальском языке (HTTP 404 - ряд не существует или нет данных за запрошенный период). Результат приходит в JSON как в текстовом виде, так и в `structuredContent` (в соответствии с outputSchema); даты в формате dd/MM/yyyy и числовые значения (десятичная точка).