# mcp-brasil-api

Hands your agent Brazilian public data: addresses by CEP, companies by CNPJ, banks, holidays, weather and FIPE vehicle prices.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/identity/brasil-api
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-brasil-api

## What it does

This MCP server wraps BrasilAPI, a free public source of Brazilian records. It ships 24 tools. `get_cep` and `get_cep_v1` resolve a postal code to an address, `get_cnpj` pulls company details, `get_banks` and `get_corretoras` list banks and brokerages, while `get_fipe_price` and `get_fipe_vehicles` cover vehicle pricing. Weather comes from CPTEC/INPE, including METAR by ICAO code, alongside holidays for a given year, DDD area codes, ISBN, NCM and the Selic, CDI and IPCA rates.

It runs through `npx`, so nothing gets installed globally. There is no API key and no environment variable to set, because BrasilAPI answers anyone. In Claude one line is enough: `claude mcp add brasil-api -- npx -y @codespar/mcp-brasil-api`. Cursor and VS Code take the same server through `.cursor/mcp.json` or `.vscode/mcp.json`.

Every tool calls an outside public API, so when that API is down the calls fail. And if your project has nothing to do with Brazil, skip this one: the toolset is built entirely around its registries and reference tables. MIT licensed, source in `codespar/mcp-dev-latam`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-brasil-api -- npx -y @codespar/mcp-brasil-api
```

### Codex

**Platform CLI**
```bash
codex mcp add brasil-api -- npx -y @codespar/mcp-brasil-api
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "brasil-api": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-brasil-api"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "brasil-api": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-brasil-api"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add brasil-api npx -y @codespar/mcp-brasil-api
```

## When to use it
- resolve a Brazilian postal code to a street address
- pull company registration details from a CNPJ
- compare vehicle prices from the FIPE table
- check national holidays for a chosen year
- read a weather forecast or an airport METAR

## Example prompts
- Look up the address for CEP 01310-100
- Show me the company data for CNPJ 00.000.000/0001-00
- What is the current weather at airport SBGR?

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

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md