Back to Discover

mcp

connector

brazilayer

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

View on GitHub
0 starsSynced Aug 13, 2026

Install to Claude Code

/plugin marketplace add brazilayer/mcp

README

Brazilayer MCP Server

Give your AI agent access to Brazilian public data — the full company registry and every official sanction list — as MCP tools, paid per call with USDC via the x402 protocol. No signup, no API keys.

Data comes straight from official government sources (Receita Federal company registry, CGU/MTE sanction lists), redistributed as published. Service: www.brazilayer.com · API docs: api.brazilayer.com/docs

Tools

ToolWhat it doesPrice
cnpj_consultar_empresaCompany registration card by CNPJ$0.005
cnpj_listar_sociosPartners/shareholders of a company$0.005
cnpj_consultar_empresa_completoFull profile: registration + partners + branches$0.01
cnpj_buscar_empresasSearch companies by name, state, city or activity$0.01
cnpj_buscar_por_socioReverse lookup: companies where a person is partner$0.02
integridade_consultarSanctions screening: 5 official lists in one call$0.01
licitacoes_contratos_fornecedorPublic contracts won by a company (PNCP)$0.01
licitacoes_oportunidades_abertasOpen government tenders, live$0.01
bcb_verificar_instituicaoCentral Bank authorization + verified domains$0.005
empresa_enriquecerFull KYB profile in ONE call: registration + partners + sanctions + BCB + contracts$0.05
mercado_noticiasBR financial & crypto news with AI sentiment, 15-min refresh$0.002
mercado_indicadoresSelic, IPCA, PTAX + Focus survey medians (Central Bank)$0.002
mercado_cambioOfficial PTAX + live BRL crypto premium (capital-flow signal)$0.002
commodities_climaCrop-weather stress per Brazilian belt: rain, drought, frost risk$0.005
commodities_fogoSatellite fire hotspots by biome + drought proxy (INPE)$0.002
commodities_exportacoesMonthly commodity exports with YoY (soy, coffee, sugar, beef…)$0.005
commodities_hidrologiaStored hydro energy by grid subsystem (ONS)$0.002
commodities_briefingDaily AI Brazil Commodity Briefing in English, with direction flags$0.10
fundos_fluxosDaily net flows of Brazilian institutional money by fund class (R$ 13.8tn)$0.005
fundos_verificarVerify a fund at the CVM: registered, operating, manager (anti-fraud)$0.005
fundos_rankingRank/screen ~25,000 fund classes by assets, inflows or shareholders$0.01
tributos_ncmWhich IBS/CBS regime applies to a product (NCM), with legal basis$0.005
tributos_buscaSearch the tax-reform annexes by product description$0.005
tributos_calendarioBrazilian tax transition calendar 2026-2033$0.002
cadeia_causalCausal chain with lead time: energy, coffee, soy, capital flows$0.05
desmatamento_municipioDeforestation of a municipality since the EUDR cutoff (INPE)$0.01
desmatamento_fornecedorSupplier CNPJ → deforestation record of its municipality$0.02
desmatamento_rankingWhere clearing is concentrated, by municipality or state$0.01
cnpj_obter_amostraSample company responsefree
integridade_obter_amostraSample screening responsefree
licitacoes_obter_amostraSample public-contracts responsefree
bcb_obter_amostraSample Central Bank checkfree
mercado_obter_amostraSample Brazil Markets response (news + indicators)free
commodities_obter_amostraSample Commodity Signals responsefree
fundos_obter_amostraSample Fund Industry responsefree
tributos_obter_amostraSample Tax Reform responsefree
cadeia_obter_amostraSample causal chainfree
desmatamento_obter_amostraSample deforestation responsefree

Prices are paid in USDC on Base, per request, by the wallet you configure. The three free sample tools work without any wallet.

Install

One-click (Claude Desktop): download brazilayer-mcp.mcpb from the latest release and open it — Claude Desktop installs the server and prompts for your wallet key (optional).

From source:

git clone https://github.com/brazilayer/mcp brazilayer-mcp
cd brazilayer-mcp && npm install

Claude Code:

claude mcp add brazilayer -e BRAZILAYER_PRIVATE_KEY=0xYOUR_KEY -- npx tsx /path/to/brazilayer-mcp/servidor.ts

Claude Desktop / Cursor (mcpServers config):

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

Configuration

VariablePurpose
BRAZILAYER_PRIVATE_KEYPrivate key (0x…) of the wallet that pays for calls. Needs USDC on Base. Without it, only the free sample tools work.
BRAZILAYER_API_URLAPI base URL. Default: https://api.brazilayer.com

⚠️ Wallet safety: the key you configure signs real payments. Use a dedicated wallet holding only a small budget (a few dollars covers hundreds of calls), never your main wallet.

How payment works

Each paid tool calls the Brazilayer API. The server replies HTTP 402 with the price and payment terms; this MCP server signs a USDC authorization (EIP-3009, gasless for you) and retries automatically. One tool call ≈ two seconds, end to end. The service is also listed on the x402 Bazaar for autonomous discovery.

Contact

contato@brazilayer.com · Terms & data policy

Also on the official MCP Registry as io.github.brazilayer/mcp.

Rendered live from brazilayer/mcp's GitHub README — not stored, always reflects the source repo.

1 Install Method

NameDescriptionCategorySource
mcpb packageInstall via mcpb (stdio transport)mcp-serverhttps://github.com/brazilayer/mcp/releases/download/v0.12.0/brazilayer-mcp.mcpb

0 Comments

Login required
Log in to post a comment or update on this repo.

No comments yet — be the first to share an update.