Brdata Mcp

Name: Brdata Mcp
Author: thomenz

@thomenz

About Brdata Mcp

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 (CN

Basic information

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

`GET /company/{cnpj}`

`GET /company/{cnpj}/full`

`GET /risk/company/{cnpj}`

`GET /nfe/{key}`

`POST /boleto/decode`

`POST /validate/batch`

`GET /cep/{cep}`

`POST /companies/search`

`GET /tender/decode/{id}`

`POST /tender/resolve`

`GET /tender/{cnpj}/{year}/{seq}`

`GET /tender/{cnpj}/{year}/{seq}/items`

`GET /tender/{cnpj}/{year}/{seq}/documents`

`POST /tender/search`

`GET /validate/{cnpj}`

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.

Comments

More AI & Agents MCP servers

Intervals.icu MCP Server

mvilanova

Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API.

311

Solon Ai

opensolon

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

416