MCP.so
Sign In

Brdata Mcp

@thomenz

RepositoryHomepageDocumentation

About Brdata Mcp

An MCP (Model Context Protocol) server for Brazilian company & public-procurement data

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "brdata": {
      "command": "npx",
      "args": [
        "-y",
        "brdata-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "0x<dedicated-wallet-key-with-USDC>"
      }
    }
  }
}

Tools

15

Consolidated official registry profile of a Brazilian company by CNPJ: legal name, status, activities (CNAE), address, incorporation date. Paid ($0.005).

Full profile: everything in lookup_company plus partners/shareholders (QSA, no CPF) and the same 5-registry regulatory screen as screen_company_risk — debarment (CEIS), anti-corruption (CNEP), leniency, impeded non-profits (CEPIM) and the forced-labor register — with a verdict and 0-100 risk score. `sources_checked` names the registries that answered. Paid ($0.03).

Screen a Brazilian company by CNPJ against 5 federal registries: debarment (CEIS), anti-corruption (CNEP), impeded non-profits (CEPIM), leniency agreements and the forced-labor register ('Lista Suja' — MTE Cadastro de Empregadores). Returns a single verdict (clear/flagged) + 0–100 risk score, each hit flagged active vs historical, plus per-source data_as_of freshness. The Brazilian complement that global OFAC/EU/UK/UN + PEP screens miss — pair it with an international provider for complete KYB. Company-level public data; no CPF (LGPD). Paid ($0.015).

Decode a 44-digit Brazilian electronic invoice (NF-e/NFC-e) access key: issuer CNPJ, state, emission date, invoice number, model. Paid ($0.005).

Decode a Brazilian boleto linha digitável (47 or 48 digits): bank, amount, due date, validity. Paid ($0.005).

Validate up to 100 Brazilian identifiers: CPF, CNPJ (incl. alphanumeric), PIS, license plates, Pix keys. Paid ($0.001).

Enriched CEP lookup: full address, IBGE city code, coordinates when available. Paid ($0.002).

Search active Brazilian companies by industry (CNAE prefix, main OR secondary activity), location (state/city), size, age (registration date), declared share capital and legal-name substring. Returns official registry data with business contact info (MEI contacts are redacted under LGPD). Cursor paginated. Paid per page ($0.015). At least one filter is 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).

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).

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).

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).

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).

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).

Free local check-digit/format validation of a single CNPJ (numeric or alphanumeric). No payment required.

Overview

What is Brdata Mcp?

Brdata Mcp is an MCP server that provides pay-per-call access to Brazilian business data, including company registries, regulatory risk screening, document decoding, and public tender information. It is designed for developers building AI agents that need automated due diligence, compliance checks, or procurement data.

How to use Brdata Mcp?

Add the server to your mcpServers configuration with command: "npx" and args: ["-y", "brdata-mcp"], then set the required environment variable EVM_PRIVATE_KEY (for paid tools) and optionally BRDATA_BASE_URL and X402_NETWORK. For local development, point BRDATA_BASE_URL at a local Worker and use X402_NETWORK=base-sepolia with a testnet wallet.

Key features of Brdata Mcp

  • Consolidated company registry lookup (lookup_company)
  • Extended company profile with partners and sanctions (lookup_company_full)
  • Regulatory risk and compliance screening with a 0–100 score (screen_company_risk)
  • NF-e/NFC-e 44-digit access-key decoder (decode_nfe_key)
  • Boleto digitable-line decoder (decode_boleto)
  • Batch document validation (CPF/CNPJ/PIS/plate/Pix) (validate_documents)
  • Enriched postal-code lookup (lookup_cep)
  • Search and segment active companies by CNAE/location/size (search_companies)
  • Public tender search and resolution (search_tenders, resolve_tender, get_tender)
  • Free CNPJ check-digit validation (validate_cnpj)

Use cases of Brdata Mcp

  • Run full due diligence on a Brazilian company, obtaining partners and sanction checks
  • Screen a company for regulatory risk, federal debarment, and anti-corruption status
  • Decode NF-e access keys and boleto digitable lines for automated invoice processing
  • Search and segment active companies by industry, location, size, or age
  • Look up and resolve public tender references from Compras.gov.br

FAQ from Brdata Mcp

What protocols or transports does Brdata Mcp use?

The server communicates via the MCP stdio transport and uses x402 payment authorizations signed by EVM_PRIVATE_KEY. It defaults to the hosted production API at https://brdata.thomenz.me.

What are the runtime dependencies?

Node.js, pnpm for building, and an EVM wallet with USDC balance on Base (mainnet) or Base Sepolia (testnet) for paid tools. The search_companies tool requires a Phase 2 database (Hyperdrive) configured on the Worker.

Where does the data come from?

Data is served by a brdata Worker at the configured BRDATA_BASE_URL (default: hosted production API). The server does not store data locally; it fetches results on each call.

Are there any free tools?

Yes, validate_cnpj is free. All other tools are pay-per-call with prices ranging from $0.002 to $0.10. The server never charges for requests that return a 503 (e.g., when search_companies lacks its database).

How should I handle the EVM_PRIVATE_KEY?

Use a dedicated wallet with a small balance, funded only with what you are willing to auto-spend. On testnet, use test USDC only. The key is read from the environment and is never sent anywhere except to sign x402 payment authorizations.

Frequently asked questions

What protocols or transports does Brdata Mcp use?

The server communicates via the MCP stdio transport and uses x402 payment authorizations signed by `EVM_PRIVATE_KEY`. It defaults to the hosted production API at `https://brdata.thomenz.me`.

What are the runtime dependencies?

Node.js, pnpm for building, and an EVM wallet with USDC balance on Base (mainnet) or Base Sepolia (testnet) for paid tools. The `search_companies` tool requires a Phase 2 database (Hyperdrive) configured on the Worker.

Where does the data come from?

Data is served by a brdata Worker at the configured `BRDATA_BASE_URL` (default: hosted production API). The server does not store data locally; it fetches results on each call.

Are there any free tools?

Yes, `validate_cnpj` is free. All other tools are pay-per-call with prices ranging from $0.002 to $0.10. The server never charges for requests that return a 503 (e.g., when `search_companies` lacks its database).

How should I handle the EVM_PRIVATE_KEY?

Use a dedicated wallet with a small balance, funded only with what you are willing to auto-spend. On testnet, use test USDC only. The key is read from the environment and is never sent anywhere except to sign x402 payment authorizations.

Comments

Basic information

Category

AI & Agents

Transports

stdio

Author

thomenz

Submitted by

Thiago Menzinger

More AI & Agents MCP servers

Hypnothera

La-Salida

Agent skill: turn what your AI assistant knows about you into a personalized hypnosis session on hypnothera.ai

21st.dev Magic AI Agent

21st-dev

It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic

5.3K

GetIntel

tarang8811

Public docs + tool manifest for the GetIntel MCP connector (app.getintel.ai)

Transform MCP

Unstructured

The Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD

F

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

14