This MCP server provides tools for KYB, due diligence, and B2G sales intelligence on Brazilian companies and public procurement, with paid tools settling automatically in USDC on Base (via x402 protocol).
Company Registry & Due Diligence
Basic company lookup: Retrieve legal name, status, CNAE activities, address, and incorporation date by CNPJ ($0.01)
Full due diligence: Everything above plus partners/shareholders (QSA) and sanction checks (CEIS/CNEP) ($0.10)
Regulatory risk screening: Screen against federal debarment (CEIS), anti-corruption (CNEP), leniency agreements, and forced-labor registers — returns a verdict and 0–100 risk score ($0.03)
Company search & segmentation: Search ~28M active companies by CNAE, state/city, size, MEI status, name, registration date, and contact info availability ($0.05/page)
Document Validation & Decoding
CNPJ validation: Check-digit and format validation — free
Batch document validation: Validate up to 100 Brazilian identifiers (CPF, CNPJ, PIS, license plates, Pix keys) ($0.002)
NF-e key decoding: Decode a 44-digit electronic invoice access key to extract issuer CNPJ, state, date, and invoice number ($0.005)
Boleto decoding: Decode a boleto digitable line (47–48 digits) to get bank, amount, due date, and validity ($0.005)
Postal Code Lookup
CEP lookup: Enriched lookup returning full address, IBGE city code, and coordinates when available ($0.005)
Public Tenders (PNCP / Compras.gov.br)
Decode tender ID: Offline decode of a Compras.gov.br 17-digit tender ID into UASG, modality, number, and year ($0.005)
Resolve tender reference: Resolve any tender reference (17-digit ID, URL, or PNCP control number) to canonical PNCP coordinates and a summary ($0.02)
Get tender header: Full header including object, modality, status, estimated value, dates, and buyer info ($0.01)
Get tender items: All line items with quantities, maximum prices, units, and SME-exclusive (ME/EPP) flags ($0.03)
Get tender documents: List document download URIs (edital PDFs, ZIPs) ($0.01)
Search tenders: Keyword search across Brazilian public procurement tenders via PNCP ($0.05)
Paid tools are charged only on success; a wallet private key must be configured.
Allows validation of Pix keys (Brazilian instant payment identifiers) as part of batch document validation.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@brdata-mcp run full due diligence on CNPJ 00.000.000/0001-91"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP (Model Context Protocol) server for Brazilian company & public-procurement data, for agent harnesses (Claude Code, Claude Desktop, …). It covers: CNPJ company registry lookup (basic + full due-diligence), company search/discovery across ~28M active companies by filters (CNAE activity, state/city, size, MEI, name), public tenders / licitações via PNCP (decode Compras.gov.br IDs, resolve, header, line items, edital documents, keyword search), NF-e & boleto decoding, CEP lookup, and batch document validation — for KYB, due diligence, and B2G (public-sector) sales intelligence.
Paid tools automatically settle the underlying x402-protected HTTP endpoints in USDC
on Base or Solana using a wallet you configure; a call is charged only on success. Configure a
Base wallet (EVM_PRIVATE_KEY), a Solana wallet (SOLANA_PRIVATE_KEY), or both — the x402 layer
settles on whichever rail the server's 402 challenge advertises.
Tool | Endpoint | Price | Description |
|
| $0.01 | Consolidated registry profile |
|
| $0.10 | + partners (QSA) + sanctions |
|
| $0.03 | Regulatory risk & compliance screen across 5 federal registries: debarment (CEIS), anti-corruption (CNEP), impeded non-profits (CEPIM), leniency & forced-labor register ("Lista Suja", MTE) → verdict + 0–100 score + per-source |
|
| $0.005 | NF-e/NFC-e 44-digit access-key decoder |
|
| $0.005 | Boleto digitable-line decoder |
|
| $0.002 | Batch validate CPF/CNPJ/PIS/plate/Pix (≤100) |
|
| $0.005 | Enriched postal-code lookup |
|
| $0.05/page | Search & segment active companies by CNAE/location/size/age/name |
|
| $0.005 | Offline decode of a Compras.gov.br 17-digit tender id |
|
| $0.02 | Resolve any tender reference (id/URL/control number) to PNCP + summary |
|
| $0.01 | Full tender header (PNCP) |
|
| $0.03 | All tender items + ME/EPP-exclusive flags |
|
| $0.01 | Tender document URIs (no PDF download) |
|
| $0.05 | Search public tenders (PNCP) by keyword |
|
| free | Single CNPJ check-digit validation |
search_companies requires the Worker to have the Phase 2 database configured (Hyperdrive);
otherwise it returns a 503 (and no payment is charged). MEI contact data is redacted (LGPD).
Related MCP server: mcp-camara
Environment variables:
Var | Required | Default | Meaning |
| no |
| Base URL of a brdata Worker (defaults to the hosted production API) |
| for paid tools (Base) | — |
|
| for paid tools (Solana) | — | base58 or JSON-array secret key of the paying Solana wallet (holds USDC). Configure this and/or |
| no | public RPC | Optional Solana RPC override used to build the payment (e.g. a Helius URL) |
| no |
|
|
EVM_PRIVATE_KEY controls real funds. Anything that can read this process'
environment (or the MCP config file) can spend from that wallet.
Use a dedicated wallet with a small balance, funded only with what you're willing to auto-spend. Never a personal or treasury key.
On testnet (base-sepolia) use test USDC only.
The key is read from the environment; it is never sent anywhere except to sign
x402 payment authorizations for BRDATA_BASE_URL.
Add to your mcpServers configuration:
{
"mcpServers": {
"brdata": {
"command": "npx",
"args": ["-y", "brdata-mcp"],
"env": {
"EVM_PRIVATE_KEY": "0x<dedicated-wallet-key-with-USDC>"
}
}
}
}For local development against wrangler dev, point BRDATA_BASE_URL at
http://localhost:8787 and use X402_NETWORK=base-sepolia with a testnet wallet.
If you run from source instead of npm, use:
{
"mcpServers": {
"brdata": {
"command": "node",
"args": ["/absolute/path/to/packages/brdata-mcp/dist/index.js"],
"env": { "BRDATA_BASE_URL": "http://localhost:8787", "EVM_PRIVATE_KEY": "0x...", "X402_NETWORK": "base-sepolia" }
}
}
}"Use brdata to run full due diligence on CNPJ 00.000.000/0001-91."
The agent calls lookup_company_full, which pays $0.10 in USDC and returns the
consolidated English profile with partners and sanction checks.
pnpm install
pnpm run build # emits dist/
pnpm run typecheck
# publish (see checklist in the main repo README before doing this):
npm publish --access publicMIT
MCP server for live, sourced Brazilian public data from the official IBGE APIs.
CNPJ Brazil MCP — Brazilian company-registry (Receita Federal) lookup via
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/thomenz/brdata-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server