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

meGPT - upload an author's content into an LLM

adrianco

Code to process many kinds of content by an author into an MCP server

287

1Panel

1Panel-dev

🔥 1Panel is a modern, open-source VPS control panel — and the only one with native AI agent support. Run Ollama models, deploy OpenClaw agents, and manage your entire server stack from one clean web interface.

36.1K

欢迎来到 智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797

MCP Claude Code

SDGLBL

MCP implementation of Claude Code capabilities and more

302

Gemini MCP Server

aliargun

MCP server implementation for Google's Gemini API

259