MCP Fiscal Brasil
MCP-сервер для налоговой работы в Бразилии: проверка контрагентов по CNPJ, разбор накладных NF-e и отчетности SPED
- 399 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запросы по CNPJ уходят к внешним государственным источникам Бразилии
- Работа с сертификатом A1 открывает доступ к налоговым сервисам компании, поэтому пароль нужно хранить в менеджере секретов
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-fiscal-brasilОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запросы по CNPJ уходят к внешним государственным источникам Бразилии
- Работа с сертификатом A1 открывает доступ к налоговым сервисам компании, поэтому пароль нужно хранить в менеджере секретов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту 44 инструмента для работы с бразильскими налоговыми данными. Они проверяют CNPJ и CPF, определяют режим Simples Nacional или MEI и работают со справочниками CNAE, NCM и CFOP. Отдельная группа разбирает электронные документы: NF-e, NFS-e, CT-e, файлы SPED и eSocial. Справочники лежат внутри пакета и работают без сети, XML разбирается локально с проверкой по XSD. Поверх базовых вызовов есть шесть агентных инструментов, которые собирают готовый отчет за один вызов. risk_score_supplier оценивает контрагента по шкале от 0 до 100, а consultar_empresas_lote проверяет сразу несколько CNPJ. analyze_cnpj_compliance сводит CNPJ, налоговый режим и CNAE в один отчет. validate_nfe_full проверяет XML накладной, ключ и эмитента. summarize_sped выдает краткую сводку по периоду и найденным несоответствиям. compare_tax_regimes сравнивает четыре налоговых режима. Сервер учитывает налоговую реформу 2026 года (IBS и CBS). Тот же код доступен как консольная утилита mcp-fiscal, как REST API mcp-fiscal-api с демо-интерфейсом и как оболочка на Node.js в предварительной версии.
Для кого. Для бухгалтеров, разработчиков ERP и CRM и команд, которые работают с бразильскими контрагентами и налоговыми документами.
Подходит, если
- Нужно проверить поставщика по CNPJ и получить оценку надежности от 0 до 100
- Надо разом проверить список компаний: инструмент принимает пакет CNPJ
- Требуется разобрать XML накладной NF-e и найти проблемы в ключе и данных эмитента
- Нужно прикинуть, какой режим выгоднее для заданных оборота и фонда оплаты труда: MEI, Simples или прибыль
- Бухгалтеру нужна краткая сводка по файлу SPED: период, компания, блоки и несоответствия
Не подходит, если
- Вы работаете с налогами другой страны: инструменты рассчитаны только на Бразилию
- Нужна юридически значимая позиция по налогам: сервер помогает с проверкой и анализом, бухгалтера он не заменяет
- Нужна отправка документов в налоговые органы: сервер только разбирает, проверяет и считает
- Нужны только общие бразильские данные вроде CEP, банков и праздников: для них есть более общие серверы открытых данных
Пример запроса к агенту
Проверь CNPJ 12.345.678/0001-90 как поставщика: статус в Simples, CNAE и оценку надежности контрагента.MCP
- Транспорт
- stdio, http, sse
- Авторизация
- не нужна
Переменные окружения
FASTMCP_TRANSPORT- Транспорт сервера: stdio (по умолчанию), sse, http или streamable-http.
NFE_CERTIFICADO_SENHAсекрет- Пароль цифрового сертификата A1, нужен только для проверки SEFAZ через REST API.
Ограничения
Нужны Python 3.10 или новее и uv. Часть запросов идет к публичным бразильским источникам, их доступность из России мы не проверяли. Проверка статуса SEFAZ, распространение и манифестация NF-e через REST API требуют цифрового сертификата A1, без него сервер возвращает ошибку 503. Пароль сертификата нельзя хранить в открытом .env. Данные из публичных источников могут запаздывать, поэтому важные решения сверяйте с первоисточником. В режиме HTTP или SSE порт задается переменной PORT.
Как отключить. Уберите запись fiscal-brasil из конфигурации клиента, например из claude_desktop_config.json, и перезапустите клиент. Ключей и фоновых процессов сервер не создает.
Частые вопросы
Нужны ли ключи или регистрация для MCP Fiscal Brasil?
Нет. В стандартном режиме stdio сервер работает без переменных окружения, ключей и аккаунтов. Переменные нужны только при запуске по HTTP или SSE и при работе с сертификатом A1.
Как установить сервер в Claude Desktop?
Добавьте в claude_desktop_config.json блок mcpServers с записью fiscal-brasil, где command равен uvx, а args содержит mcp-fiscal-brasil, затем перезапустите Claude Desktop. Для принудительного обновления используйте mcp-fiscal-brasil@latest или флаг --refresh.
Что умеет risk_score_supplier?
Инструмент оценивает поставщика по CNPJ и возвращает балл от 0 до 100, список факторов и рекомендацию по контракту.
Чем MCP Fiscal Brasil отличается от mcp-brasil?
mcp-brasil отдает общие открытые данные Бразилии. MCP Fiscal Brasil сфокусирован на налоговой вертикали: разбор XML NF-e, анализ SPED и eSocial, офлайн-справочники NCM, CFOP, CNAE и реформа 2026 года.
Как сравнить налоговые режимы для моей компании?
Вызовите compare_tax_regimes: инструмент сопоставляет MEI, Simples, Lucro Presumido и Lucro Real по обороту, отрасли и фонду оплаты труда. В консоли то же делает команда `mcp-fiscal regimes --faturamento 500000 --setor serviços --folha 180000`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыБольше 120 MCP-серверов для торговли в Латинской Америке: Pix, счета NF-e, банки, доставка и WhatsApp через один интерфейс
MCP-сервер налоговых расчетов РФ: НДС, УСН, взносы ИП, НДФЛ, патент и пени офлайн, с формулой и ссылкой на статью НК
Financial Datasets MCP
Financial Datasets MCP Server
MCP-сервер к API Financial Datasets: отчетность компаний, цены акций и криптовалют и новости для агента
MCP-сервер финансового анализа: более 500 методов из отчетностей компаний, коэффициенты, индикаторы, метрики риска и макро
MCP-сервер к базе SEC EDGAR: отчетность компаний США, финансовые формы 10-K, 10-Q, 8-K, данные из XBRL и сделки инсайдеров
Официальный MCP-сервер японского сервиса freee и скилл с рецептами: бухгалтерия, кадры и зарплата, счета, трудозатраты, договоры с подписью через AI-агента
Коротко о README
Документация начинается со сравнения с другими бразильскими MCP-серверами и рабочих сценариев. Для проверки без установки есть демо на Render, отдельно описаны новые источники данных версии 0.2.