Skip to main content

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...")       # 29 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
desmatamento_municipio(ibge) Cleared area since the EUDR cutoff (INPE satellite) $0.01
desmatamento_fornecedor(cnpj) Supplier CNPJ → deforestation of its municipality $0.02
desmatamento_ranking(**f) Where clearing is concentrated $0.01
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).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

brazilayer-0.8.0.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

brazilayer-0.8.0-py3-none-any.whl (12.5 kB view details)

Uploaded Python 3

File details

Details for the file brazilayer-0.8.0.tar.gz.

File metadata

  • Download URL: brazilayer-0.8.0.tar.gz
  • Upload date:
  • Size: 9.5 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

Hashes for brazilayer-0.8.0.tar.gz
Algorithm Hash digest
SHA256 efe27507ffe2a0dd9d20bb6224b9e7695c4a90d18719a2914bd992239dd95b77
MD5 e15f06aa7ada784a19b7ae31e6361696
BLAKE2b-256 2fce6cb8fdb088498a2460aa808017380302e048619c6b4b16219162c91d7f65

See more details on using hashes here.

File details

Details for the file brazilayer-0.8.0-py3-none-any.whl.

File metadata

  • Download URL: brazilayer-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 12.5 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

Hashes for brazilayer-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c763cfa51ce4a0b0e1c76c72ad6ea46554d0c6ff3ff6845f118d40c7a6ba9c8e
MD5 8dba4fba5c867475e253147609a22a30
BLAKE2b-256 920c6f5d85ddac93450cd085469d083247ffd3761287ed4dae932b1d0610387c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page