Brazilayer: Brazilian Public Data

io.github.brazilayerPublished by GitHub account brazilayerv0.16.0Updated Nov 5, 2026

Brazilian company registry (CNPJ), sanctions, funds & market data for AI agents, paid via x402.

VerifiedSTDIODesktop onlyFinance Data & Analytics Business & Commerce

Server details

Identifier: io.github.brazilayer/mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account brazilayer for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.brazilayer%2Fmcp.svg)](https://sourceweft.com/mcp/io.github.brazilayer%2Fmcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Brazilayer gives an assistant Brazilian public data — company registry, sanctions, contracts, market, commodities, funds and more — paid per call in USDC.

What you can do: Look up companies in the CNPJ registry: status, activities, address, partners, branches, and search by name, place, activity or partner
Check sanctions and integrity lists, government contracts and open tenders, and whether a company is an authorized financial institution
Pull market data: news with sentiment, Selic, IPCA, PTAX and Focus indicators, FX, and the BRL crypto premium
Query commodities data: rain and frost risk, fire hotspots, exports, reservoirs and a daily briefing
Explore CVM investment funds: flows, registration, rankings, holdings and institutional movements
Get tax-reform treatment by NCM code, deforestation (EUDR) alerts and rankings, causal-chain readings, and one-call…
When to use it: Useful when an assistant needs Brazilian company due diligence, supplier or counterparty checks, procurement and sanctions screening, or Brazilian macro, commodities and fund data, and you are willing to pay per call in crypto.
Requirements: Runs as a local process (stdio); the Claude Desktop build is a downloadable bundle, other clients run it from source with Node.js and npm. Optional BRAZILAYER_PRIVATE_KEY holds the wallet key that pays for calls; the wallet needs USDC on Base. Optional BRAZILAYER_API_URL overrides the default API endpoint. Network access to the Brazilayer API is required.

Before you install

BRAZILAYER_PRIVATE_KEY is a real wallet private key that signs payments, so every paid call spends USDC on Base; use a dedicated wallet with a small balance. Without the key only free sample and trust-check tools work. Queries and lookups are sent to the Brazilayer API, a third party.

Installation

In SourceWeft

Open Brazilayer: Brazilian Public Data in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Brazilayer MCP server

Official Brazilian public data for AI agents, paid per call in USDC on Base through the x402 protocol. No account and no API key: the server pays each call from a wallet you configure, and the free tools work without one.

API reference and prices: https://api.brazilayer.com/docs
Website: https://www.brazilayer.com
Listed in the MCP Registry as io.github.brazilayer/mcp, and on PayAPI Market

Tools

Family	Tools	What they return
Company registry (CNPJ)	`cnpj_situacao`, `cnpj_consultar_empresa`, `cnpj_listar_socios`, `cnpj_consultar_empresa_completo`, `cnpj_buscar_empresas`, `cnpj_buscar_por_socio`	Receita Federal registry: status, activities, address, partners, branches; search by name, place, activity or partner
Sanctions	`integridade_consultar`	CEIS, CNEP, CEPIM, the slave-labour list and leniency agreements, in one call
Government contracts	`licitacoes_contratos_fornecedor`, `licitacoes_oportunidades_abertas`	Contracts won by a company and tenders open now, from the national procurement portal (PNCP)
Central Bank	`bcb_verificar_instituicao`	Whether a company is an authorized financial institution, with its verified domains
Enrichment	`empresa_enriquecer`	Registry, partners, branches, sanctions, Central Bank and contracts in one call
Market	`mercado_noticias`, `mercado_indicadores`, `mercado_cambio`, `mercado_pacote`	News with sentiment every 15 minutes; Selic, IPCA, PTAX and Focus; the BRL crypto premium
Commodities	`commodities_clima`, `commodities_fogo`, `commodities_exportacoes`, `commodities_hidrologia`, `commodities_briefing`, `commodities_pacote`	Rain and frost risk in the crop belts, fire hotspots, exports, reservoirs and a daily briefing
Investment funds (CVM)	`fundos_fluxos`, `fundos_verificar`, `fundos_ranking`, `fundos_carteira`, `fundos_movimentacoes`	Daily flows by class, fund registration, rankings, holdings and institutional flow per stock
Tax reform	`tributos_ncm`, `tributos_busca`, `tributos_calendario`	IBS/CBS treatment by NCM code, reduced and zero rates, the transition calendar
Deforestation (EUDR)	`desmatamento_municipio`, `desmatamento_fornecedor`, `desmatamento_ranking`	INPE DETER alerts by municipality, exposure of a supplier, rankings
Causal chains	`cadeia_causal`	An upstream indicator with its lead time, the current state and a reading
Bundle	`brasil_pacote`	The 13 endpoints that need no parameter, in one call
Free samples	`*_obter_amostra` (one per family)	The response format of each family, without payment
Trust checks (free)	`trust_check`, `skill_check`	The public ratings of the Agent Economy Report for an x402 service or an agent skill, before you pay or install

Install

Claude Desktop. Download brazilayer-mcp.mcpb from the latest release and open it. The installer asks for the wallet key, which is optional.

Claude Code, from source:

bash

git clone https://github.com/brazilayer/mcp && cd mcp && npm installclaude mcp add brazilayer -e BRAZILAYER_PRIVATE_KEY=0xYOUR_KEY -- npx tsx "$PWD/servidor.ts"

git clone https://github.com/brazilayer/mcp && cd mcp && npm installclaude mcp add brazilayer -e BRAZILAYER_PRIVATE_KEY=0xYOUR_KEY -- npx tsx "$PWD/servidor.ts"

Other MCP clients (Cursor and others), after the same git clone and npm install:

json

{  "mcpServers": {    "brazilayer": {      "command": "npx",      "args": ["tsx", "/path/to/mcp/servidor.ts"],      "env": { "BRAZILAYER_PRIVATE_KEY": "0xYOUR_KEY" }    }  }}

{  "mcpServers": {    "brazilayer": {      "command": "npx",      "args": ["tsx", "/path/to/mcp/servidor.ts"],      "env": { "BRAZILAYER_PRIVATE_KEY": "0xYOUR_KEY" }    }  }}

Configuration

BRAZILAYER_PRIVATE_KEY (optional): private key (0x…) of the wallet that pays for calls. It needs USDC on Base. Without it the free tools work, and the paid ones explain the 402 they received.
BRAZILAYER_API_URL (optional): defaults to https://api.brazilayer.com.

The key signs real payments. Use a dedicated wallet with a small balance.

License

MIT

Source: README.md at commit 4956d48

Tools

SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package type cannot run in the sandbox.

Version history

v0.16.0LatestNov 5, 2026
v0.15.2Oct 1, 2026
v0.15.1Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts