Brdata Mcp

brdata-mcp

エージェントのハーネス（Claude Code、Claude Desktop、…）向けの、ブラジルの企業および公共調達データ用MCP（Model Context Protocol）サーバーです。以下をカバーしています：CNPJ企業登記情報の検索（基本情報＋詳細デューデリジェンス）、約2,800万社の稼働中企業を対象としたフィルター検索・発見（CNAE業種、州・市、規模、MEI、名称）、PNCP経由の公共入札／licitações（Compras.gov.br IDのデコード、照合、概要、品目、入札公告書類、キーワード検索）、NF-eとboletoのデコード、CEP検索、書類の一括検証。KYB、デューデリジェンス、B2G（公共部門）向け営業インテリジェンスに対応します。

有料ツールは、設定したウォレットを使用して、x402で保護された基盤のHTTPエンドポイントへの支払いを自動的に決済します。決済にはUSDC on BaseまたはSolanaを使用し、呼び出しが成功した場合にのみ課金されます。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/page	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 devnet）

⚠️ セキュリティ

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 の完全なデューデリジェンスを実施してください。」

エージェントは lookup_company_full を呼び出します。このツールは USDC で 0.03 ドルを支払い、パートナー情報と制裁チェックを含む、統合された英語のプロフィールを返します。

ビルドと公開

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

ライセンス

MIT