# Brazilayer: Brazilian Public Data

> Brazilayer: Brazilian Public Data is a paid MCP server for legal and government. Brazilian company, sanctions, fund and market data for AI agents, paid per call in USDC. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI, macOS, Windows
- **Website:** https://www.brazilayer.com
- **Repository:** https://github.com/brazilayer/mcp
- **MCP Registry name:** io.github.brazilayer/mcp
- **Categories:** legal and government, analytics and data, finance and payments
- **Listing updated:** 2026-11-14

## About

Data comes from official Brazilian sources and is billed per request over the x402 protocol with USDC on Base, from $0.001 a call. There is no account or API key: the server pays from a wallet you configure through `BRAZILAYER_PRIVATE_KEY`, and without it only the free sample tools work. The README advises using a dedicated wallet because the key signs real payments.

Tool names are in Portuguese and group into families. The CNPJ tools read the Receita Federal registry, including partners and reverse lookup by partner. `integridade_consultar` checks five government sanction lists in one call, other tools cover PNCP public contracts, Central Bank authorization and CVM fund data, and `empresa_enriquecer` combines registry, sanctions, bank and contract data. Market and commodity tools add news with sentiment, Selic and IPCA, the BRL crypto premium, crop-weather stress and deforestation alerts tied to the EUDR.

Two free tools, `trust_check` and `skill_check`, look up public ratings for an x402 service or agent skill before you pay or install. It installs as a Claude Desktop bundle or from source.

## Features

- **CNPJ registry:** Look up status, activities, address, partners and branches of Brazilian companies.
- **Sanctions screening:** Check five official sanction lists in one call.
- **Public contracts:** Find contracts won by a supplier and tenders open now.
- **Central Bank check:** Verify whether a company is an authorized financial institution.
- **Market and commodity data:** Read news, rates, the BRL crypto premium, crop weather and fire hotspots.
- **Fund and tax data:** Query CVM fund flows and IBS/CBS tax reform treatment by NCM code.
- **Free samples:** Preview each family's response format without paying.

## Good for

- Run KYB checks on a Brazilian company by CNPJ
- Screen a supplier against Brazilian sanction lists
- Check deforestation exposure for a supplier's municipality
- Verify whether a fund is registered with the CVM
- Feed a trading agent Brazilian rates and news

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env BRAZILAYER_PRIVATE_KEY='<BRAZILAYER_PRIVATE_KEY>' -- npx -y https://github.com/brazilayer/mcp/releases/download/v0.16.0/brazilayer-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/brazilayer/mcp/releases/download/v0.16.0/brazilayer-mcp.mcpb"
      ],
      "env": {
        "BRAZILAYER_PRIVATE_KEY": "<BRAZILAYER_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/brazilayer/mcp/releases/download/v0.16.0/brazilayer-mcp.mcpb"
      ],
      "env": {
        "BRAZILAYER_PRIVATE_KEY": "<BRAZILAYER_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/brazilayer/mcp/releases/download/v0.16.0/brazilayer-mcp.mcpb"
      ],
      "env": {
        "BRAZILAYER_PRIVATE_KEY": "<BRAZILAYER_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/brazilayer/mcp/releases/download/v0.16.0/brazilayer-mcp.mcpb"
      ],
      "env": {
        "BRAZILAYER_PRIVATE_KEY": "<BRAZILAYER_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/brazilayer/mcp/releases/download/v0.16.0/brazilayer-mcp.mcpb"
      ],
      "env": {
        "BRAZILAYER_PRIVATE_KEY": "<BRAZILAYER_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `cnpj_situacao`: Check whether a CNPJ exists and is active
- `cnpj_consultar_empresa`: Look up a company's registration card
- `cnpj_listar_socios`: List partners and shareholders
- `cnpj_consultar_empresa_completo`: Full company lookup
- `cnpj_buscar_empresas`: Search companies
- `cnpj_buscar_por_socio`: Find companies by partner
- `integridade_consultar`: Screen several government sanction lists
- `licitacoes_contratos_fornecedor`: Contracts won by a supplier
- `licitacoes_oportunidades_abertas`: Open tenders
- `bcb_verificar_instituicao`: Check Central Bank authorization
- `empresa_enriquecer`: Combined company enrichment
- `mercado_noticias`: Market news with sentiment
- `mercado_indicadores`: Selic, IPCA, PTAX and Focus
- `mercado_cambio`: BRL crypto premium
- `mercado_pacote`: Market bundle
- `commodities_clima`: Crop weather risk
- `commodities_fogo`: Fire hotspots
- `commodities_exportacoes`: Exports
- `commodities_hidrologia`: Reservoirs
- `commodities_briefing`: Daily commodity briefing
- `commodities_pacote`: Commodity bundle
- `fundos_fluxos`: Daily fund flows
- `fundos_verificar`: Verify a fund
- `fundos_ranking`: Fund rankings
- `fundos_carteira`: Fund holdings
- `fundos_movimentacoes`: Institutional flow per stock
- `tributos_ncm`: Tax treatment by NCM code
- `tributos_busca`: Tax search
- `tributos_calendario`: Tax transition calendar
- `desmatamento_municipio`: Deforestation alerts by municipality
- `desmatamento_fornecedor`: Supplier deforestation exposure
- `desmatamento_ranking`: Deforestation rankings
- `cadeia_causal`: Causal chain reading
- `brasil_pacote`: Bundle of parameterless endpoints
- `trust_check`: Public rating of an x402 service
- `skill_check`: Public rating of an agent skill

## FAQ

### Do I need an API key?

No. Paid calls are made from a wallet holding USDC on Base; free sample tools work without one.

### What does a call cost?

From $0.001 for a CNPJ status check up to $0.10 for some commodity calls; causal chains are $0.05.

### How often is data refreshed?

The site says registry data monthly, contracts and sanctions daily and market data every 15 minutes.

### How do I install it?

Open the `.mcpb` bundle in Claude Desktop, or run it from source with npx tsx.

### Is Brazilayer: Brazilian Public Data free?

No. Brazilayer: Brazilian Public Data is a paid product.

### How do I add Brazilayer: Brazilian Public Data to Claude Code?

Run this command in your terminal: claude mcp add mcp --env BRAZILAYER_PRIVATE_KEY='<BRAZILAYER_PRIVATE_KEY>' -- npx -y https://github.com/brazilayer/mcp/releases/download/v0.16.0/brazilayer-mcp.mcpb

### What are the best alternatives to Brazilayer: Brazilian Public Data?

The closest alternatives to Brazilayer: Brazilian Public Data are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/brazilayer-brazilian-public-data
