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 "Deploy 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.005 | Consolidated registry profile |
|
| $0.03 | + partners (QSA) + sanctions |
|
| $0.015 | 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.001 | Batch validate CPF/CNPJ/PIS/plate/Pix (≤100) |
|
| $0.002 | Enriched postal-code lookup |
|
| $0.015/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: cnpjaberto
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.03 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
Decode a Brazilian boleto linha digitável (47 or 48 digits): bank, amount, due date, validity. Paid ($0.005).
Inputs: digitable_line (required).
Decode a 44-digit Brazilian electronic invoice (NF-e/NFC-e) access key: issuer CNPJ, state, emission date, invoice number, model. Paid ($0.005).
Inputs: access_key (required).
Offline decode of a Compras.gov.br 17-digit tender id (UASG + modality + number + year), with the modality name in English. Paid ($0.005).
Inputs: id (required).
Full header of a Brazilian public tender by PNCP coordinates: object, modality, status, estimated value, opening/closing dates, buyer, price-registration flag. Paid ($0.01).
Inputs: seq (required), cnpj (required), year (required).
Document list (download URIs) of a Brazilian public tender. ZIPs usually contain the full edital PDF and item list. Metadata only — files are not fetched. Paid ($0.01).
Inputs: seq (required), cnpj (required), year (required).
All items of a Brazilian public tender: quantities, maximum accepted prices, units, and SME-exclusive (ME/EPP) flags. Essential for bid/no-bid analysis. Paid ($0.03).
Inputs: seq (required), cnpj (required), year (required).
Enriched CEP lookup: full address, IBGE city code, coordinates when available. Paid ($0.005).
Inputs: cep (required).
Consolidated official registry profile of a Brazilian company by CNPJ: legal name, status, activities (CNAE), address, incorporation date. Paid ($0.01).
Inputs: cnpj (required).
Full profile: everything in lookup_company plus partners/shareholders (QSA) and government sanction checks (CEIS/CNEP). Paid ($0.10).
Inputs: cnpj (required).
Resolve any Brazilian public tender reference (Compras.gov.br 17-digit id or URL, PNCP URL, or control number) into canonical PNCP coordinates + a summary (object, modality, estimated value, dates). Paid ($0.02).
Inputs: reference (required).
Screen a Brazilian company by CNPJ against the federal debarment (CEIS), anti-corruption (CNEP) and leniency-agreement registries. Returns a single verdict (clear/flagged) + 0–100 risk score, each hit flagged active vs historical. The Brazilian complement that global OFAC/EU/UK/UN + PEP screens miss — a company barred by the Brazilian government comes back clean on those. Company-level public data; no CPF (LGPD). Paid ($0.03).
Inputs: cnpj (required).
Search active Brazilian companies by industry (CNAE prefix, main activity), location (state/city), size, age (registration date) and legal-name substring. Returns official registry data with business contact info (MEI contacts are redacted under LGPD). Cursor paginated. Paid per page ($0.05). At least one filter is required.
Inputs: city, cnae, state, cursor, +8 more.
Search Brazilian public procurement tenders (PNCP) by keyword. Returns normalized references (CNPJ/year/sequential, control number, PNCP URL) ready for detail lookups. Paid ($0.05).
Inputs: query (required), page.
Free local check-digit/format validation of a single CNPJ (numeric or alphanumeric). No payment required.
Inputs: cnpj (required).
Validate up to 100 Brazilian identifiers: CPF, CNPJ (incl. alphanumeric), PIS, license plates, Pix keys. Paid ($0.002).
Inputs: documents (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 15 tools
Each tool serves a distinct function (decoding, tender info, company lookup, validation, CEP) with no overlaps. Tools are clearly separated by domain and action.
All tools follow the consistent snake_case verb_noun pattern (e.g., decode_boleto, get_tender, search_companies), using verbs like decode, lookup, get, search, validate.
15 tools are well-scoped for a specialized Brazilian public data server, covering tenders, companies, documents, CEP, and validation without being excessive.
The tool surface covers the core workflows: decoding common identifiers, full tender lifecycle (search, get, documents, items), company profiles with risk screening, and document validation, with no obvious gaps.
Official remote MCP server for Brazilian company data (CNPJ): lookup, filtered search, contacts and partners with masked CPF. 70M CNPJs, base of Aug 2026; updated monthly, with the base date in every response. https://cnpj.ia.br/?utm_source=glama&utm_medium=listing
Brazil CNPJ, CEP, Selic/IPCA/PTAX, holidays, banks/ISPB for agents. Pay per call in USDC (x402).
CNPJ Brazil MCP — Brazilian company-registry (Receita Federal) lookup via minhareceita.org, an…
Brazil PTAX, CNPJ/KYB, CEIS-CNEP sanctions, PIX and boleto. Paid x402 MCP API (USDC on Base).
