MCP.so
Sign In

Brdata Mcp

@thomenz

Repository

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

Category

AI & Agents

Transports

stdio

Publisher

thomenz

Submitted by

Thiago Menzinger

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

`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

LinkedIn MCP Server

stickerdaniel

Open-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.

2.7K

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

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622

Sequential Thinking Multi-Agent System (MAS)

FradSer

An advanced sequential thinking process using a Multi-Agent System (MAS) built with the Agno framework and served via MCP.

306

MCP Server - Remote MacOs Use

baryhuang

The only general AI agent that does NOT requires extra API key, giving you full control on your local and remote MacOs from Claude Desktop App

487