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

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

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

Web Agent Protocol

OTA-Tech-AI

🌐Web Agent Protocol (WAP) - Record and replay user interactions in the browser with MCP support

500

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

欢迎来到 智言平台

Shy2593666979

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

797

MCP Client for Ollama (ollmcp)

jonigl

Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre

768

Model Context Protocol Server for Home Assistant

tevonsb

A MCP server for Home Assistant

574