# mcp-brasil-api

Даёт агенту доступ к открытым данным Бразилии: адреса по CEP, компании по CNPJ, банки, праздники, погода и таблица FIPE.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Автор: codespar
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/identity/brasil-api
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-brasil-api

## Что делает

MCP-сервер оборачивает BrasilAPI — бесплатный публичный набор бразильских данных. Внутри 24 инструмента: `get_cep` и `get_cep_v1` ищут адрес по почтовому индексу, `get_cnpj` тянет сведения о компании, `get_banks` и `get_corretoras` перечисляют банки и брокеров, `get_fipe_price` и `get_fipe_vehicles` работают с ценами на автомобили. Отдельно идут погода CPTEC/INPE, включая METAR по коду ICAO, праздники по году, коды DDD, ISBN, NCM и курсы Selic, CDI, IPCA.

Запускается через `npx`, ставить глобально ничего не нужно. Ключ API не требуется, переменные окружения тоже: BrasilAPI открыт для всех запросов. Для Claude хватит одной команды `claude mcp add brasil-api -- npx -y @codespar/mcp-brasil-api`; в Cursor и VS Code тот же сервер прописывается в `.cursor/mcp.json` или `.vscode/mcp.json`.

Данные приходят из внешнего публичного API, поэтому при его недоступности инструменты молча вернут ошибку. Если проект не связан с Бразилией, пользы от сервера не будет — все инструменты заточены под её реестры и справочники. Лицензия MIT, код лежит в репозитории `codespar/mcp-dev-latam`.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mcp-brasil-api -- npx -y @codespar/mcp-brasil-api
```

### Codex

**Командой платформы**
```bash
codex mcp add brasil-api -- npx -y @codespar/mcp-brasil-api
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "brasil-api": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-brasil-api"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "brasil-api": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-brasil-api"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add brasil-api npx -y @codespar/mcp-brasil-api
```

## Когда брать
- найти адрес и район по бразильскому почтовому индексу CEP
- подтянуть реквизиты компании по CNPJ
- сравнить цены на автомобиль по таблице FIPE
- узнать национальные праздники на нужный год
- посмотреть прогноз погоды или METAR по коду аэропорта

## Примеры запросов агенту
- Найди адрес по CEP 01310-100
- Покажи данные компании по CNPJ 00.000.000/0001-00
- Какая сейчас погода в аэропорту с кодом SBGR?

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24242
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7506

Из того же набора: [codespar/mcp-dev-latam](https://affpapa.org/nevibecode/by/codespar/mcp-dev-latam.md) — 124 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md