Brdata Mcp

Name: Brdata Mcp
Author: thomenz

本地服务

brdata.thomenz.meAI 与智能体012 周前更新

文档代码仓库访问官网

关于 Brdata Mcp

brdata-mcp 是提供巴西企业、身份文件和公共采购数据的 MCP 服务，面向 KYB、尽职调查和公共部门销售研究中的 Agent。它整合登记查询、企业发现、招标搜索与文件解码；付费调用通过 Base 或 Solana 上的 USDC 结算。

主要功能

01查询企业登记资料与风险
02按筛选条件搜索活跃企业
03搜索和查看公共招标
04解码 NF-e、boleto 和招标编号
05验证文件并查询 CEP

适用场景

01开展企业 KYB 和尽职调查
02按行业或地区寻找企业
03研究巴西公共招标
04批量验证身份及企业文件

MCP 相关

该 MCP 服务提供巴西企业记录、合规筛查、公共招标、文件验证与解码以及邮政编码查询工具。付费工具使用已配置的钱包，自动通过 Base 或 Solana 上的 USDC 结算。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "brdata": {
      "command": "npx",
      "args": [
        "-y",
        "brdata-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "SOLANA_PRIVATE_KEY": "<SOLANA_PRIVATE_KEY>",
        "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
        "BRDATA_BASE_URL": "<BRDATA_BASE_URL>",
        "X402_NETWORK": "<X402_NETWORK>"
      }
    }
  }
}

启动命令npx -y brdata-mcp

需要配置的环境变量

EVM_PRIVATE_KEY密钥0x private key of a DEDICATED wallet holding USDC on Base (pays per call). Paid tools return 402 without it; the free validate_cnpj tool still works.

SOLANA_PRIVATE_KEY密钥base58 or JSON-array secret key of a DEDICATED Solana wallet holding USDC (pays per call). Configure this and/or EVM_PRIVATE_KEY; the x402 layer settles on whichever rail the 402 advertises.

SOLANA_RPC_URLOptional Solana RPC override used to build the payment (e.g. a Helius URL).

BRDATA_BASE_URLBase URL of a brdata Worker. Defaults to the hosted production API (https://brdata.thomenz.me).

X402_NETWORK'base' (mainnet, default) or 'base-sepolia' (testnet).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmbrdata-mcp0.3.7stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
cnpj	string	是	巴西公司税号（CNPJ），14 位数字，可带或不带标点符号。

详细介绍

brdata-mcp

面向 Agent 框架（Claude Code、Claude Desktop 等）的巴西企业与公共采购数据 MCP（Model Context Protocol）服务。涵盖：CNPJ 企业注册信息查询（基础信息和完整尽职调查）、按筛选条件（CNAE 活动、州/城市、规模、MEI、名称）搜索和发现约 2,800 万家活跃企业、通过 PNCP 查询公共招标 / licitações（解码 Compras.gov.br ID、解析、招标概要、项目、招标文件、关键词搜索）、NF-e 和 boleto 解码、CEP 查询，以及批量文档验证——适用于 KYB、尽职调查和 B2G（公共部门）销售情报。

付费工具会使用你配置的钱包，自动结算底层受 x402 保护的 HTTP 端点，支付方式为 Base 或 Solana 上的 USDC。仅在调用成功时收费。配置 Base 钱包（EVM_PRIVATE_KEY）、Solana 钱包（SOLANA_PRIVATE_KEY），或两者都配置——x402 层会根据服务端 402 挑战所指定的支付渠道进行结算。

工具

工具	端点	价格	描述
`lookup_company`	`GET /company/{cnpj}`	$0.005	综合注册信息档案
`lookup_company_full`	`GET /company/{cnpj}/full`	$0.03	+ 合伙人（QSA）+ 制裁信息
`screen_company_risk`	`GET /risk/company/{cnpj}`	$0.015	跨 5 个联邦登记库进行监管风险与合规筛查：禁入（CEIS）、反腐败（CNEP）、受限非营利组织（CEPIM）、宽大处理与强迫劳动登记库（“Lista Suja”，MTE）→ 判定结果 + 0–100 分 + 各数据源的 `data_as_of`
`decode_nfe_key`	`GET /nfe/{key}`	$0.005	NF-e/NFC-e 44 位访问密钥解码器
`decode_boleto`	`POST /boleto/decode`	$0.005	Boleto 可读数字行解码器
`validate_documents`	`POST /validate/batch`	$0.001	批量验证 CPF/CNPJ/PIS/车牌/Pix（≤100）
`lookup_cep`	`GET /cep/{cep}`	$0.002	增强版邮政编码查询
`search_companies`	`POST /companies/search`	$0.015/页	按 CNAE/地点/规模/经营年限/名称搜索和细分活跃企业
`decode_tender_id`	`GET /tender/decode/{id}`	$0.005	离线解码 Compras.gov.br 的 17 位招标 ID
`resolve_tender`	`POST /tender/resolve`	$0.02	将任意招标引用（ID/URL/控制编号）解析为 PNCP 信息和概要
`get_tender`	`GET /tender/{cnpj}/{year}/{seq}`	$0.01	完整招标概要（PNCP）
`get_tender_items`	`GET /tender/{cnpj}/{year}/{seq}/items`	$0.03	所有招标项目 + 仅限 ME/EPP 的标记
`get_tender_documents`	`GET /tender/{cnpj}/{year}/{seq}/documents`	$0.01	招标文件 URI（不下载 PDF）
`search_tenders`	`POST /tender/search`	$0.05	按关键词搜索公共招标（PNCP）
`validate_cnpj`	`GET /validate/{cnpj}`	免费	单个 CNPJ 校验位验证

search_companies 要求 Worker 已配置 Phase 2 数据库（Hyperdrive）；否则会返回 503（且不会扣费）。MEI 联系方式数据会被隐藏（LGPD）。

配置

环境变量：

变量	必需	默认值	含义
`BRDATA_BASE_URL`	否	`https://brdata.thomenz.me`	brdata Worker 的基础 URL（默认为托管的生产 API）
`EVM_PRIVATE_KEY`	用于付费工具（Base）	—	付费 Base 钱包的 `0x` 前缀密钥（持有 USDC）
`SOLANA_PRIVATE_KEY`	用于付费工具（Solana）	—	付费 Solana 钱包的 base58 或 JSON 数组格式私钥（持有 USDC）。可配置此项和/或 `EVM_PRIVATE_KEY`
`SOLANA_RPC_URL`	否	公共 RPC	用于构建付款的可选 Solana RPC 覆盖地址（例如 Helius URL）
`X402_NETWORK`	否	`base`	`base`（主网，与默认 URL 匹配）或 `base-sepolia`（测试网 → Solana 开发网）

⚠️ 安全

EVM_PRIVATE_KEY 控制着真实资金。任何可以读取此进程环境（或 MCP 配置文件）的对象，都可以从该钱包转出资金。

使用余额较少的专用钱包，且仅存入你愿意自动支出的金额。切勿使用个人密钥或资金库密钥。
在测试网（base-sepolia）上仅使用测试 USDC。
密钥从环境中读取；除用于为 BRDATA_BASE_URL 签署 x402 付款授权外，绝不会发送到任何地方。

在 Claude Code / Claude Desktop 中使用

将以下内容添加到你的 mcpServers 配置中：

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

对于使用 wrangler dev 进行本地开发，将 BRDATA_BASE_URL 指向 http://localhost:8787，并使用 X402_NETWORK=base-sepolia 和一个测试网钱包。

如果你从源代码运行，而不是使用 npm，请使用：

{
  "mcpServers": {
    "brdata": {
      "command": "node",
      "args": ["/absolute/path/to/packages/brdata-mcp/dist/index.js"],
      "env": { "BRDATA_BASE_URL": "http://localhost:8787", "EVM_PRIVATE_KEY": "0x...", "X402_NETWORK": "base-sepolia" }
    }
  }
}

示例

“使用 brdata 对 CNPJ 00.000.000/0001-91 进行全面尽职调查。”

Agent 会调用 lookup_company_full，支付 0.03 美元的 USDC，并返回包含合作伙伴和制裁检查结果的综合英文档案。

构建与发布

pnpm install
pnpm run build        # emits dist/
pnpm run typecheck
# publish (see checklist in the main repo README before doing this):
npm publish --access public