Brazilian public data for AI agents — company registry (CNPJ), sanctions screening and public contracts, paid per call via the x402 protocol. LangChain and CrewAI tools included.
Project description
brazilayer
Brazilian public data for AI agents — paid per call, no signup, no API keys.
Query the full Brazilian company registry (69M companies), screen against every official sanction list, and pull government contracts — from official sources (Receita Federal, CGU, MTE, PNCP), as clean JSON. Your agent pays per request ($0.005–$0.02) in USDC on Base via the x402 protocol.
Ideal for KYB, AML and counterparty due diligence on Brazilian entities — including crypto exchanges, OTC desks and fintechs onboarding Brazilian companies.
pip install brazilayer
Quick start
from brazilayer import Brazilayer
bl = Brazilayer() # no wallet: free samples only
bl.amostra_cnpj() # learn the response format, free
bl = Brazilayer(private_key="0x...") # wallet with a few USD of USDC on Base
bl.empresa("00.000.000/0001-91") # registration card $0.005
bl.integridade("00000000000191") # sanctions screening $0.01
bl.contratos_fornecedor("00000000000191") # public contracts won $0.01
bl.buscar_empresas(nome="padaria", uf="RJ") # company search $0.01
Payment is automatic: on HTTP 402 the client signs a USDC authorization
(EIP-3009, gasless for you) and retries. One call ≈ 2 seconds end to end.
⚠️ Use a dedicated wallet with a small budget — a few dollars covers hundreds of calls. Never your main wallet.
LangChain
from brazilayer.langchain import get_tools # pip install 'brazilayer[langchain]'
tools = get_tools(private_key="0x...") # 26 StructuredTools, agent-ready
CrewAI
from brazilayer.crewai import get_tools # pip install 'brazilayer[crewai]'
tools = get_tools(private_key="0x...")
MCP (Claude Desktop / Claude Code / Cursor)
Prefer MCP? Use our MCP server: github.com/brazilayer/mcp
(one-click .mcpb install available).
What's inside
| Method | Data | Price |
|---|---|---|
empresa(cnpj) |
Registration card from Receita Federal | $0.005 |
socios(cnpj) |
Partners/shareholders | $0.005 |
empresa_completa(cnpj) |
Full profile + branches | $0.01 |
buscar_empresas(**f) |
Full-text company search | $0.01 |
buscar_por_socio(nome) |
Reverse partner lookup | $0.02 |
integridade(cnpj) |
5 official sanction lists, one call | $0.01 |
contratos_fornecedor(cnpj) |
Public contracts won + totals | $0.01 |
instituicao_bcb(cnpj) |
Central Bank authorization + verified domains | $0.005 |
licitacoes_abertas(**f) |
Open tenders, live | $0.01 |
enriquecer(cnpj) |
Full KYB profile in one call — registration + partners + sanctions + BCB + contracts | $0.05 |
noticias(**f) |
BR financial & crypto news + AI sentiment, 15-min refresh | $0.002 |
indicadores() |
Selic, IPCA, PTAX + Focus survey medians | $0.002 |
cambio() |
Official PTAX + live BRL crypto premium (capital-flow signal) | $0.002 |
commodities_clima() |
Crop-weather stress per belt: rain, drought, frost risk | $0.005 |
commodities_fogo() |
Satellite fire hotspots + drought proxy (INPE) | $0.002 |
commodities_exportacoes() |
Monthly commodity exports with YoY | $0.005 |
commodities_hidrologia() |
Stored hydro energy by subsystem (ONS) | $0.002 |
commodities_briefing() |
Daily AI Brazil Commodity Briefing (English) | $0.10 |
fundos_fluxos() |
Daily net flows of institutional money by fund class (R$13.8tn) | $0.005 |
fundos_verificar(cnpj) |
Verify a fund at the CVM (anti-fraud) | $0.005 |
fundos_ranking(**f) |
Rank/screen ~25,000 fund classes | $0.01 |
tributos_ncm(codigo) |
IBS/CBS regime for a product, with legal basis | $0.005 |
tributos_busca(termo) |
Search the tax-reform annexes by description | $0.005 |
tributos_calendario() |
Tax transition calendar 2026-2033 | $0.002 |
cadeia(nome) |
Causal chain with lead time — energy, coffee, soy, capital flows | $0.05 |
amostra_*() / health() |
Samples & status | free |
Docs: api.brazilayer.com/docs · OpenAPI: /openapi.yaml · Terms: /termos · Contact: contato@brazilayer.com
Also listed on the x402 Bazaar and the
MCP Registry (io.github.brazilayer/mcp).
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file brazilayer-0.7.0.tar.gz.
File metadata
- Download URL: brazilayer-0.7.0.tar.gz
- Upload date:
- Size: 9.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
49aa4d30739d8217fc0fdc8bb2d58737332d8f727656928685554995c3cab0b2
|
|
| MD5 |
7600f5ae6ff3e09a32134467b8cbf45c
|
|
| BLAKE2b-256 |
4b2333367029508c95148f6459f7048517b28d79bd4ba89488e4120644036648
|
File details
Details for the file brazilayer-0.7.0-py3-none-any.whl.
File metadata
- Download URL: brazilayer-0.7.0-py3-none-any.whl
- Upload date:
- Size: 11.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cb9adeaf69fe2beb179fd9c1bbcd394f25f4618bcaafe6847fbaab7ab23938ac
|
|
| MD5 |
3e68091254d2f0ef2e756e3a646c6a22
|
|
| BLAKE2b-256 |
6710b934389f93339828130f4f85eb9d7aec2c05c793712ad548e4b00cf412ac
|
