alanpcf/brasil-data-mcp

Запрашивает данные бразильского банка по коду COMPE/Febraban через BrasilAPI (источник: BACEN). Возвращает в JSON: краткое название, полное название, код, ISPB (идентификатор в SPB). Используй, когда пользователь передал код банка и хочет узнать название, или когда нужен ISPB для формирования PIX/TED. НЕ используй для: поиска банка по названию (используй listar_bancos и отфильтруй), проверки расчётного счета или запроса отделения/счета. Распространённые коды: 001=BB, 104=CEF, 237=Bradesco, 341=Itaú, 260=Nubank, 077=Inter.

Запрашивает официальный курс иностранной валюты по отношению к реалу (BRL) на указанную дату через бюллетени PTAX Центрального банка (BrasilAPI). Возвращает в JSON бюллетени за день (ABERTURA, INTERMEDIÁRIO, FECHAMENTO) с курсом покупки и продажи в BRL, паритетом и data_hora_cotacao. Источник НЕ предоставляет текущий день: если дата не указана, инструмент запрашивает вчерашнюю (самый свежий доступный курс), а для даты без торгов API возвращает бюллетени за последний предыдущий рабочий день. Используйте, когда пользователь спрашивает 'сколько доллар?' (возвращает самый свежий курс за предыдущий рабочий день), 'курс евро на 26/06', 'сколько закрылся фунт в пятницу' — любой вопрос о стоимости иностранной валюты в реалах. НЕ используйте для: криптовалют (их нет в этом API), BRL (это базовая валюта), исторического ряда (одна дата за вызов) или валют за пределами 10 поддерживаемых — чтобы узнать доступные валюты, используйте listar_moedas.

Запрашивает полный адрес по бразильскому почтовому индексу (CEP) через BrasilAPI v2 (объединяет ViaCEP, Postmon и других провайдеров с автоматическим fallback). Возвращает JSON: штат (UF), город, район, улицу и, если доступно, географические координаты. Используйте, когда пользователь просит адрес по CEP, проверяет CEP или хочет узнать город/UF по CEP. НЕ используйте для: почтовых индексов других стран, поиска CEP по адресу (операция работает только CEP → адрес, не наоборот). Принимает CEP с дефисом или без.

Запрашивает регистрационные данные бразильской компании по CNPJ в налоговой службе (Receita Federal) через BrasilAPI. Возвращает JSON: razão social, nome fantasia, ситуацию в реестре (активна/ликвидирована/и т.д.), дату открытия, полный адрес, основной и дополнительные коды CNAE, учредителей (QSA), уставной капитал, организационно-правовую форму, размер (MEI/ME/EPP/Прочие), телефоны, e-mail, статус Simples Nacional/MEI. Используй, когда пользователь запрашивает сведения о компании по CNPJ. НЕ ИСПОЛЬЗУЙ для: CPF (физлица), иностранных компаний или локальной проверки формата (отклоняй неверный формат без вызова инструмента). Принимает CNPJ как с маской, так и без.

Запрашивает регистрационные данные брокерской компании по ценным бумагам, авторизованной CVM (Комиссией по ценным бумагам Бразилии), через BrasilAPI. Возвращает в JSON: CNPJ, юридическое наименование, коммерческое наименование, статус (действующая, аннулирована и т.д.), полный адрес, e-mail, телефон, дату начала деятельности и собственный капитал (если доступно). Используйте, когда пользователь предоставляет CNPJ и хочет узнать, является ли компания авторизованным брокером CVM, или получить её регистрационные данные. НЕ используйте для: компаний в целом (используйте consultar_cnpj), страховых брокеров (CVM регулирует только ценные бумаги) или поиска по наименованию (API принимает только CNPJ).

Выводит список городов, обслуживаемых бразильским кодом DDD через BrasilAPI. Возвращает в JSON: штат (UF) и список городов, которые используют этот DDD. Используйте, когда пользователь спрашивает, откуда DDD, какие города покрывает DDD, или нужно определить штат по номеру телефона. НЕ используйте для: проверки полного номера телефона, определения DDD по городу (операция работает только DDD → города) или запроса международных DDD.

Проверяет статус регистрации домена .br напрямую в базе registro.br (через BrasilAPI). Возвращает в JSON: status (AVAILABLE = доступен для регистрации, REGISTERED = уже зарегистрирован), fqdn, hosts (DNS-серверы), expires-at (если зарегистрирован) и suggestions расширений (если доступен). Результат никогда не кешируется, всегда актуальный статус. Используйте, когда пользователь спрашивает: «домен X.com.br свободен?», «когда истекает Y.org.br?», «кто отвечает за DNS Z.br?». НЕ используйте для: международных доменов .com/.net/gTLDs (база только .br), данных владельца/полного whois (API не показывает) или хостинга/содержимого сайта.

Список бразильских НАЦИОНАЛЬНЫХ праздников за определённый год через BrasilAPI. Возвращает JSON-массив с датой (YYYY-MM-DD), названием праздника и типом (national/optional). Включает вычисляемые переходящие праздники (Карнавал, Пасха, Корпус-Кристи). Используйте, когда пользователь спрашивает, на какой день выпадает праздник, просит перечислить праздники года, спланировать «мостики» или длинные выходные, или рассчитать рабочие дни. НЕ используйте для: государственных или муниципальных праздников (API покрывает только национальные), памятных дат без выходного (День матери и т.п.) или годов вне диапазона 1900-2199.

Запрашивает метаданные книги по ISBN через BrasilAPI (объединяет CBL, Mercado Editorial, Open Library и Google Books). Возвращает в JSON: название, подзаголовок, авторов, издательство, год, язык, количество страниц, тему/категорию, описание (если есть) и источник данных. Используйте, когда пользователь указал ISBN и хочет узнать о книге (название, автор, издательство, год). НЕ используйте для: поиска книги по названию или автору (операция только ISBN → метаданные), проверки формата без запроса (отклоняйте локально, если не 10 или 13 цифр) или запроса цены/наличия. Принимает ISBN-10 и ISBN-13, с дефисами или без.

Выводит список всех муниципалитетов одного бразильского штата с названием и 7-значным кодом IBGE через BrasilAPI. Возвращает в JSON массив объектов {nome, codigo_ibge}. Внимание: для крупных штатов список длинный (в SP 645 муниципалитетов, ~30 КБ) — используйте только когда действительно нужен список или код конкретного муниципалитета. Применяйте, если пользователю нужен код IBGE города или список городов штата. НЕ используйте для: поиска города по названию во всей стране (API фильтрует только по штату — если штат известен, обратитесь к нему), адресов/CEP (используйте consultar_cep) или демографических данных.

Запрашивает текущее значение бразильской экономической ставки (SELIC, CDI, IPCA) через BrasilAPI. Возвращает в JSON: название ставки и текущее значение (% годовых). Используйте, когда пользователь спрашивает 'какая SELIC сегодня?', 'текущий CDI?', 'инфляция IPCA?', любой вопрос о текущем значении конкретной ставки. НЕ используйте для: исторического ряда (API возвращает только последнее значение), других ставок кроме SELIC/CDI/IPCA, или запроса курса доллара/биржи (этого нет в API). Для общего обзора всех трёх ставок используйте listar_taxas.

Выводит ВСЕ бразильские банки, зарегистрированные в BACEN, через BrasilAPI. Возвращает в JSON массив с полями: название, код COMPE/Febraban и ISPB каждого учреждения. Используйте, когда пользователь хочет получить полный список, найти банк по названию (вы фильтруете результат) или узнать код конкретного банка, название которого он указал. НЕ используйте, если пользователь уже указал числовой код — в этом случае вызывайте consultar_banco, это дешевле. Список содержит ~250 записей; приводите в ответе только релевантные.

Перечисляет 27 федеративных единиц Бразилии (26 штатов + Федеральный округ) с данными IBGE через BrasilAPI. Возвращает в JSON массив с id (код IBGE), sigla, nome, região (Norte/Nordeste/Centro-Oeste/Sudeste/Sul) и capital каждой UF. Используй, когда пользователю нужен код IBGE штата, сгруппировать штаты по региону, проверить аббревиатуру UF или узнать столицу. НЕ используй для: муниципалитетов (используй consultar_municipios), демографических или популяционных данных (их нет в этом API).

Перечисляет иностранные валюты с доступной котировкой в BrasilAPI (бюллетени PTAX/BACEN). Возвращает в JSON массив с символом (ISO 4217), названием и типом каждой валюты — 10 валют: USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK. Используйте, когда пользователь хочет узнать, какие валюты имеют котировку, или не знает код валюты. НЕ используйте для получения самой котировки — используйте consultar_cambio.

Выводит ВСЕ доступные экономические ставки Бразилии из BrasilAPI (SELIC, CDI, IPCA) с их текущими значениями. Возвращает JSON-массив с названием и значением (% годовых) для каждой ставки. Используй, когда пользователь хочет получить экономический обзор, сравнить SELIC vs CDI vs IPCA, или не знает конкретную аббревиатуру. НЕ используй, если пользователь уже знает, какую ставку хочет — используй consultar_taxa, это семантически более прямой инструмент. Сейчас ставок всего 3, payload небольшой.