# cristianoaredes-mcp-dadosbr

Hooks your coding assistant up to Brazilian public registries: company records by CNPJ, addresses by CEP, court cases, federal contracts, central bank rates. Handy when a vendor check has to happen inside the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: cristianoaredes
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cristianoaredes/mcp-dadosbr
- Updated: 2026-04-06
- HTML: https://affpapa.org/en/nevibecode/mcp/cristianoaredes-mcp-dadosbr

## What it does

The server exposes 23 tools grouped into six areas: government transparency, legal and compliance, companies and people, finance, health, strategic research. Ask for a CNPJ and you get the registration record; ask for a CEP and you get the address. There is also CPF checksum validation, `.br` domain WHOIS and consumer complaints from Consumidor.gov.br. The `company_deep_profile` tool pulls one profile together from six sources.

Plenty of tools answer with no key at all, IBGE, PNCP, OAB, BNMP, FIPE, CNES and the central bank rates among them. For the rest you pass `TAVILY_API_KEY`, `TRANSPARENCIA_API_KEY` and `DATAJUD_API_KEY` in the client config; leave out `TRANSPARENCIA_API_KEY` and federal contract lookups plus the sanctioned-companies list stay empty. Running it locally through `npx @aredes.me/mcp-dadosbr` requires Node.js 18+.

It ships as a TypeScript MCP server with `stdio` as the default transport; `http` is available and takes its port from `MCP_HTTP_PORT`. Client config lives in different places per editor: `.cursor/mcp.json` inside the project for Cursor, `~/.windsurf/config.json` for Windsurf, the `context_servers` field in Zed settings. In Claude a single command points the assistant at the hosted Smithery endpoint, so no local Node runtime is involved.

## Requirements
- Remote server: `https://server.smithery.ai/@cristianoaredes/mcp-dadosbr/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http cristianoaredes-mcp-dadosbr https://server.smithery.ai/@cristianoaredes/mcp-dadosbr/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add cristianoaredes-mcp-dadosbr --url https://server.smithery.ai/@cristianoaredes/mcp-dadosbr/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cristianoaredes-mcp-dadosbr": {
            "url": "https://server.smithery.ai/@cristianoaredes/mcp-dadosbr/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cristianoaredes-mcp-dadosbr": {
            "type": "http",
            "url": "https://server.smithery.ai/@cristianoaredes/mcp-dadosbr/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http cristianoaredes-mcp-dadosbr https://server.smithery.ai/@cristianoaredes/mcp-dadosbr/mcp
```

## When to use it
- check a Brazilian supplier by CNPJ before signing
- look up a full address from a CEP
- see which court cases a company is involved in
- find out if a firm sits on the CEIS/CNEP sanctions list
- pull current SELIC, IPCA and dollar rates

## Example prompts
- Run a full background check on CNPJ 00.000.000/0001-91: registry data, government contracts and court cases
- Resolve CEP 01310-100 to a street address with `cep_lookup`
- What are the current SELIC and IPCA rates from the central bank?

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [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
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
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